[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79ZVEASZ8QHCV1FMRM2NXDS":3,"skill-same:01M79ZVEASZ8QHCV1FMRM2NXDS":66},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":43,"commitSha":44,"skillDirectory":45,"forksCount":46,"repositoryHtmlUrl":47,"repositoryHomepageUrl":48,"ownerHtmlUrl":49,"ownerBlogUrl":6,"ownerDescription":50,"updatedAt":51,"install":52,"resources":65},"01M79ZVEASZ8QHCV1FMRM2NXDS","a0-debug-plugin",null,"Diagnose and fix Agent Zero plugin problems. Covers plugin not appearing, won't enable, API endpoints not responding, frontend store errors, extension point injection, settings resolution, hooks.py issues, and log inspection. Use when a plugin is not working, not loading, crashing, missing from the list, or behaving unexpectedly.","Gen-Verse\u002FPAST-Bench","Gen-Verse","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F197493814?v=4","01M79ZTVVJS24KDA4RF6Y4BCZD","01M79ZTVW4PBQ3G7XMH1KN5BW7",37,"Apache-2.0","https:\u002F\u002Fgithub.com\u002FGen-Verse\u002FPAST-Bench\u002Fblob\u002Fmain\u002Fagents\u002Fagent-zero\u002Fskills\u002Fa0-debug-plugin\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: a0-debug-plugin\ndescription: Diagnose and fix Agent Zero plugin problems. Covers plugin not appearing, won't enable, API endpoints not responding, frontend store errors, extension point injection, settings resolution, hooks.py issues, and log inspection. Use when a plugin is not working, not loading, crashing, missing from the list, or behaving unexpectedly.\nversion: 1.0.0\ntags: [\"plugins\", \"debug\", \"troubleshoot\", \"fix\", \"diagnose\", \"error\", \"broken\"]\ntrigger_patterns:\n  - \"plugin not working\"\n  - \"plugin not loading\"\n  - \"plugin not showing\"\n  - \"plugin broken\"\n  - \"plugin error\"\n  - \"plugin missing\"\n  - \"plugin crash\"\n  - \"debug plugin\"\n  - \"troubleshoot plugin\"\n  - \"fix plugin\"\n---\n\n# Agent Zero Plugin Debugger\n\nWork through these checks in order. Stop at the first failure and fix it before continuing.\n\n---\n\n## 1. Plugin not appearing in the Plugins list\n\n```bash\n# Check plugin.yaml exists\nls \u002Fa0\u002Fusr\u002Fplugins\u002F\u003Cname>\u002Fplugin.yaml\n\n# Validate YAML\npython3 -c \"import yaml; yaml.safe_load(open('\u002Fa0\u002Fusr\u002Fplugins\u002F\u003Cname>\u002Fplugin.yaml'))\"\n\n# Check directory name doesn't start with '.'\nls \u002Fa0\u002Fusr\u002Fplugins\u002F\n```\n\nCommon causes:\n- Missing `plugin.yaml` - plugin not discovered\n- Invalid YAML syntax - plugin skipped silently\n- Directory name starts with `.` - skipped by discovery\n\n---\n\n## 2. Plugin appears but won't enable\n\n```bash\n# Check toggle state\nls -la \u002Fa0\u002Fusr\u002Fplugins\u002F\u003Cname>\u002F.toggle-*\n\n# Check for conflicting scoped toggles\nls -la project\u002F.a0proj\u002Fplugins\u002F\u003Cname>\u002F.toggle-* 2>\u002Fdev\u002Fnull\nls -la \u002Fa0\u002Fusr\u002Fagents\u002Fdefault\u002Fplugins\u002F\u003Cname>\u002F.toggle-* 2>\u002Fdev\u002Fnull\n```\n\n---\n\n## 3. API endpoint not responding\n\n- Verify the handler file is in `api\u002F` and subclasses `ApiHandler`\n- Route format: `POST \u002Fapi\u002Fplugins\u002F\u003Cplugin_name>\u002F\u003Chandler_filename_without_.py>`\n- Check for Python import errors on startup (check Agent Zero logs)\n- Verify correct import paths: `from agent import AgentContext` not `from helpers.context import AgentContext`\n\n```bash\n# Check for syntax errors in handler\npython3 -m py_compile \u002Fa0\u002Fusr\u002Fplugins\u002F\u003Cname>\u002Fapi\u002Fmy_handler.py\n```\n\n---\n\n## 4. Frontend component not rendering \u002F store errors\n\n- Check browser console for Alpine.js errors\n- Verify the store file is imported in HTML `\u003Chead>` via `\u003Cscript type=\"module\">`\n- Confirm Store Gate pattern is used (missing gate = undefined error if store not yet loaded)\n- Verify store name in `createStore(...)` matches `$store.\u003Cname>` in templates\n\n---\n\n## 5. Extension point not injecting\n\n- Check the HTML file is in `extensions\u002Fwebui\u002F\u003Ccorrect_breakpoint_name>\u002F`\n- Verify the breakpoint name exists in core UI (check `webui\u002Findex.html` or component files for `\u003Cx-extension id=\"...\">`)\n- Common breakpoints: `sidebar-quick-actions-main-start`, `plugins-list-header-buttons`, `chat-input-bottom-actions-end`\n- Confirm the HTML file has a root element with `x-data` and an `x-move-*` directive\n\nFor backend extension hooks:\n- Named lifecycle hooks must live under `extensions\u002Fpython\u002F\u003Cpoint>\u002F`\n- Implicit `@extensible` hooks must live under `extensions\u002Fpython\u002F_functions\u002F\u003Cmodule>\u002F\u003Cqualname>\u002F\u003Cstart|end>\u002F`\n- The retired flattened form `extensions\u002Fpython\u002F\u003Cmodule>_\u003Cqualname>_\u003Cstart|end>\u002F` no longer loads\n\n---\n\n## 6. Settings not saving \u002F loading wrong values\n\nConfig resolution order (highest priority first):\n1. `project\u002F.a0proj\u002Fagents\u002F\u003Cprofile>\u002Fplugins\u002F\u003Cname>\u002Fconfig.json`\n2. `project\u002F.a0proj\u002Fplugins\u002F\u003Cname>\u002Fconfig.json`\n3. `usr\u002Fagents\u002F\u003Cprofile>\u002Fplugins\u002F\u003Cname>\u002Fconfig.json`\n4. `usr\u002Fplugins\u002F\u003Cname>\u002Fconfig.json`\n5. `plugins\u002F\u003Cname>\u002Fdefault_config.yaml`\n\n```bash\n# Find which config file is actually being loaded\nfind \u002Fa0 -path \"*\u002Fplugins\u002F\u003Cname>\u002Fconfig.json\" 2>\u002Fdev\u002Fnull\n```\n\n---\n\n## 7. hooks.py install hook not running\n\nThe `install()` hook is called automatically by the plugin installer after placement. If it didn't run:\n- Check the function is named exactly `install` (not `on_install` or similar)\n- Check for exceptions in the function (add try\u002Fexcept with print for debugging)\n- Manually trigger in the **framework runtime** (not via `code_execution_tool` python - that uses `\u002Fopt\u002Fvenv`, not `\u002Fopt\u002Fvenv-a0`):\n\n```bash\ncd \u002Fa0 && \u002Fopt\u002Fvenv-a0\u002Fbin\u002Fpython -c \"\nimport asyncio\nfrom helpers.plugins import call_plugin_hook\nasyncio.run(call_plugin_hook('\u003Cplugin_name>', 'install'))\nprint('Done')\n\"\n```\n\nIf the `pre_update()` hook is not running before plugin updates:\n- Check the function is named exactly `pre_update`\n- Check for exceptions in the function\n- Manually trigger it in the **framework runtime** the same way:\n\n```bash\ncd \u002Fa0 && \u002Fopt\u002Fvenv-a0\u002Fbin\u002Fpython -c \"\nimport asyncio\nfrom helpers.plugins import call_plugin_hook\nasyncio.run(call_plugin_hook('\u003Cplugin_name>', 'pre_update'))\nprint('Done')\n\"\n```\n\n---\n\n## 8. Check Agent Zero logs\n\n```bash\n# Find recent log files\nls -lt \u002Fa0\u002Flogs\u002F*.html | head -5\n```\n\nPlugin-related errors appear as Python tracebacks mentioning the plugin path.\n\n---\n\n## How Plugin Discovery Works\n\n1. Agent Zero walks `usr\u002Fplugins\u002F` then `plugins\u002F` at startup\n2. Any directory containing `plugin.yaml` is treated as a plugin\n3. `usr\u002Fplugins\u002F\u003Cname>` takes priority over `plugins\u002F\u003Cname>` when both exist (user overrides core)\n4. Toggle state is evaluated: `.toggle-0` disables, `.toggle-1` enables, no file = enabled by default\n5. Enabled plugins have their `extensions\u002F`, `api\u002F`, `tools\u002F`, etc. registered into the runtime, including both named extension points and implicit `_functions\u002F...` extensible hooks\n\nPlugins are re-scanned when:\n- Agent Zero restarts\n- A plugin is installed\u002Fremoved via the installer\n- The \"Refresh\" action is triggered in the Plugins UI\n\n---\n\n## References\n\n- Plugin architecture: `\u002Fa0\u002Fdocs\u002Fagents\u002FAGENTS.plugins.md`\n- Manage (install\u002Fupdate\u002Funinstall): read `\u002Fa0\u002Fskills\u002Fa0-manage-plugin\u002FSKILL.md`\n","# Agent Zero Plugin Debugger\n\nWork through these checks in order. Stop at the first failure and fix it before continuing.\n\n---\n\n## 1. Plugin not appearing in the Plugins list\n\n```bash\n# Check plugin.yaml exists\nls \u002Fa0\u002Fusr\u002Fplugins\u002F\u003Cname>\u002Fplugin.yaml\n\n# Validate YAML\npython3 -c \"import yaml; yaml.safe_load(open('\u002Fa0\u002Fusr\u002Fplugins\u002F\u003Cname>\u002Fplugin.yaml'))\"\n\n# Check directory name doesn't start with '.'\nls \u002Fa0\u002Fusr\u002Fplugins\u002F\n```\n\nCommon causes:\n- Missing `plugin.yaml` - plugin not discovered\n- Invalid YAML syntax - plugin skipped silently\n- Directory name starts with `.` - skipped by discovery\n\n---\n\n## 2. Plugin appears but won't enable\n\n```bash\n# Check toggle state\nls -la \u002Fa0\u002Fusr\u002Fplugins\u002F\u003Cname>\u002F.toggle-*\n\n# Check for conflicting scoped toggles\nls -la project\u002F.a0proj\u002Fplugins\u002F\u003Cname>\u002F.toggle-* 2>\u002Fdev\u002Fnull\nls -la \u002Fa0\u002Fusr\u002Fagents\u002Fdefault\u002Fplugins\u002F\u003Cname>\u002F.toggle-* 2>\u002Fdev\u002Fnull\n```\n\n---\n\n## 3. API endpoint not responding\n\n- Verify the handler file is in `api\u002F` and subclasses `ApiHandler`\n- Route format: `POST \u002Fapi\u002Fplugins\u002F\u003Cplugin_name>\u002F\u003Chandler_filename_without_.py>`\n- Check for Python import errors on startup (check Agent Zero logs)\n- Verify correct import paths: `from agent import AgentContext` not `from helpers.context import AgentContext`\n\n```bash\n# Check for syntax errors in handler\npython3 -m py_compile \u002Fa0\u002Fusr\u002Fplugins\u002F\u003Cname>\u002Fapi\u002Fmy_handler.py\n```\n\n---\n\n## 4. Frontend component not rendering \u002F store errors\n\n- Check browser console for Alpine.js errors\n- Verify the store file is imported in HTML `\u003Chead>` via `\u003Cscript type=\"module\">`\n- Confirm Store Gate pattern is used (missing gate = undefined error if store not yet loaded)\n- Verify store name in `createStore(...)` matches `$store.\u003Cname>` in templates\n\n---\n\n## 5. Extension point not injecting\n\n- Check the HTML file is in `extensions\u002Fwebui\u002F\u003Ccorrect_breakpoint_name>\u002F`\n- Verify the breakpoint name exists in core UI (check `webui\u002Findex.html` or component files for `\u003Cx-extension id=\"...\">`)\n- Common breakpoints: `sidebar-quick-actions-main-start`, `plugins-list-header-buttons`, `chat-input-bottom-actions-end`\n- Confirm the HTML file has a root element with `x-data` and an `x-move-*` directive\n\nFor backend extension hooks:\n- Named lifecycle hooks must live under `extensions\u002Fpython\u002F\u003Cpoint>\u002F`\n- Implicit `@extensible` hooks must live under `extensions\u002Fpython\u002F_functions\u002F\u003Cmodule>\u002F\u003Cqualname>\u002F\u003Cstart|end>\u002F`\n- The retired flattened form `extensions\u002Fpython\u002F\u003Cmodule>_\u003Cqualname>_\u003Cstart|end>\u002F` no longer loads\n\n---\n\n## 6. Settings not saving \u002F loading wrong values\n\nConfig resolution order (highest priority first):\n1. `project\u002F.a0proj\u002Fagents\u002F\u003Cprofile>\u002Fplugins\u002F\u003Cname>\u002Fconfig.json`\n2. `project\u002F.a0proj\u002Fplugins\u002F\u003Cname>\u002Fconfig.json`\n3. `usr\u002Fagents\u002F\u003Cprofile>\u002Fplugins\u002F\u003Cname>\u002Fconfig.json`\n4. `usr\u002Fplugins\u002F\u003Cname>\u002Fconfig.json`\n5. `plugins\u002F\u003Cname>\u002Fdefault_config.yaml`\n\n```bash\n# Find which config file is actually being loaded\nfind \u002Fa0 -path \"*\u002Fplugins\u002F\u003Cname>\u002Fconfig.json\" 2>\u002Fdev\u002Fnull\n```\n\n---\n\n## 7. hooks.py install hook not running\n\nThe `install()` hook is called automatically by the plugin installer after placement. If it didn't run:\n- Check the function is named exactly `install` (not `on_install` or similar)\n- Check for exceptions in the function (add try\u002Fexcept with print for debugging)\n- Manually trigger in the **framework runtime** (not via `code_execution_tool` python - that uses `\u002Fopt\u002Fvenv`, not `\u002Fopt\u002Fvenv-a0`):\n\n```bash\ncd \u002Fa0 && \u002Fopt\u002Fvenv-a0\u002Fbin\u002Fpython -c \"\nimport asyncio\nfrom helpers.plugins import call_plugin_hook\nasyncio.run(call_plugin_hook('\u003Cplugin_name>', 'install'))\nprint('Done')\n\"\n```\n\nIf the `pre_update()` hook is not running before plugin updates:\n- Check the function is named exactly `pre_update`\n- Check for exceptions in the function\n- Manually trigger it in the **framework runtime** the same way:\n\n```bash\ncd \u002Fa0 && \u002Fopt\u002Fvenv-a0\u002Fbin\u002Fpython -c \"\nimport asyncio\nfrom helpers.plugins import call_plugin_hook\nasyncio.run(call_plugin_hook('\u003Cplugin_name>', 'pre_update'))\nprint('Done')\n\"\n```\n\n---\n\n## 8. Check Agent Zero logs\n\n```bash\n# Find recent log files\nls -lt \u002Fa0\u002Flogs\u002F*.html | head -5\n```\n\nPlugin-related errors appear as Python tracebacks mentioning the plugin path.\n\n---\n\n## How Plugin Discovery Works\n\n1. Agent Zero walks `usr\u002Fplugins\u002F` then `plugins\u002F` at startup\n2. Any directory containing `plugin.yaml` is treated as a plugin\n3. `usr\u002Fplugins\u002F\u003Cname>` takes priority over `plugins\u002F\u003Cname>` when both exist (user overrides core)\n4. Toggle state is evaluated: `.toggle-0` disables, `.toggle-1` enables, no file = enabled by default\n5. Enabled plugins have their `extensions\u002F`, `api\u002F`, `tools\u002F`, etc. registered into the runtime, including both named extension points and implicit `_functions\u002F...` extensible hooks\n\nPlugins are re-scanned when:\n- Agent Zero restarts\n- A plugin is installed\u002Fremoved via the installer\n- The \"Refresh\" action is triggered in the Plugins UI\n\n---\n\n## References\n\n- Plugin architecture: `\u002Fa0\u002Fdocs\u002Fagents\u002FAGENTS.plugins.md`\n- Manage (install\u002Fupdate\u002Funinstall): read `\u002Fa0\u002Fskills\u002Fa0-manage-plugin\u002FSKILL.md`\n",{"name":5,"tags":23,"version":31,"description":7,"trigger_patterns":32},[24,25,26,27,28,29,30],"plugins","debug","troubleshoot","fix","diagnose","error","broken","1.0.0",[33,34,35,36,37,38,39,40,41,42],"plugin not working","plugin not loading","plugin not showing","plugin broken","plugin error","plugin missing","plugin crash","debug plugin","troubleshoot plugin","fix plugin","main","f8223517ae7491e776b69793d9f11e9d074ab42e","agents\u002Fagent-zero\u002Fskills\u002Fa0-debug-plugin",9,"https:\u002F\u002Fgithub.com\u002FGen-Verse\u002FPAST-Bench","https:\u002F\u002Farxiv.org\u002Fabs\u002F2608.04003","https:\u002F\u002Fgithub.com\u002FGen-Verse","Research led by Ling Yang, across Princeton, Stanford, Oxford, AItonomy Foundation","2026-08-05 09:16:45",{"source":8,"skillName":5,"commands":53,"prompt":63,"zipAvailable":64},[54,57,60],{"tool":55,"command":56},"npx","npx skills add Gen-Verse\u002FPAST-Bench --skill a0-debug-plugin",{"tool":58,"command":59},"bunx","bunx skills add Gen-Verse\u002FPAST-Bench --skill a0-debug-plugin",{"tool":61,"command":62},"pnpm","pnpm dlx skills add Gen-Verse\u002FPAST-Bench --skill a0-debug-plugin","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FGen-Verse\u002FPAST-Bench\u002Fblob\u002Fmain\u002Fagents\u002Fagent-zero\u002Fskills\u002Fa0-debug-plugin\u002FSKILL.md",true,[],[67,73,79,85,91,97],{"skillNo":68,"name":69,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":18},"01M79ZYB2TKDT4WVWPHY5VBKPC","kappa_review_workflow","https:\u002F\u002Fgithub.com\u002FGen-Verse\u002FPAST-Bench\u002Fblob\u002Fmain\u002Fself-evolve-tasks-v2\u002Fproactive_information_gathering\u002FPG06_kappa_integration_review\u002F_family_seed\u002Fskills\u002Fkappa_review_workflow\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":18},"01M79ZY8F4KJCAM1HFTZ4PF4DD","change_freeze_lookup","https:\u002F\u002Fgithub.com\u002FGen-Verse\u002FPAST-Bench\u002Fblob\u002Fmain\u002Fself-evolve-tasks-v2\u002Fproactive_information_gathering\u002FPG05_change_freeze_followup\u002F_family_seed\u002Fskills\u002Fchange_freeze_lookup\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":18},"01M79ZY684WBATTYEP78X28ZX0","temporary_waiver_audit","https:\u002F\u002Fgithub.com\u002FGen-Verse\u002FPAST-Bench\u002Fblob\u002Fmain\u002Fself-evolve-tasks-v2\u002Fproactive_information_gathering\u002FPG04_temporary_waiver_audit\u002F_family_seed\u002Fskills\u002Ftemporary_waiver_audit\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":18},"01M79ZY3GJCBCD3BZKQZGY2J4Y","oncall_handoff_lookup","https:\u002F\u002Fgithub.com\u002FGen-Verse\u002FPAST-Bench\u002Fblob\u002Fmain\u002Fself-evolve-tasks-v2\u002Fproactive_information_gathering\u002FPG03_oncall_handoff_lookup\u002F_family_seed\u002Fskills\u002Foncall_handoff_lookup\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":18},"01M79ZY0R87W2R56W1ZTZJKCJE","ops_exception_desk_workflow","https:\u002F\u002Fgithub.com\u002FGen-Verse\u002FPAST-Bench\u002Fblob\u002Fmain\u002Fself-evolve-tasks-v2\u002Fproactive_information_gathering\u002FPG02_ops_exception_desk\u002F_family_seed\u002Fskills\u002Fops_exception_desk_workflow\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":18},"01M79ZXY173N2QBP1MBJG02WAT","release_followup_lookup","https:\u002F\u002Fgithub.com\u002FGen-Verse\u002FPAST-Bench\u002Fblob\u002Fmain\u002Fself-evolve-tasks-v2\u002Fproactive_information_gathering\u002FPG01_release_decision_followup\u002F_family_seed\u002Fskills\u002Frelease_followup_lookup\u002FSKILL.md",[],[]]