[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AC0GSS09N3AB8Z14BYGXAV":3,"skill-same:01M7AC0GSS09N3AB8Z14BYGXAV":49},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":30,"repositoryHtmlUrl":31,"repositoryHomepageUrl":32,"ownerHtmlUrl":33,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":34,"install":35,"resources":48},"01M7AC0GSS09N3AB8Z14BYGXAV","sync-troubleshoot",null,"Diagnose why a skill loads in some AI agent products but not others when\nusing a central-repo + symlink setup (agent-skill-manager \u002F askill, or any\nmanual ~\u002F.agents\u002Fskills junction\u002Fsymlink layout). Walks a ordered checklist:\ndirectory presence, link vs real dir, per-product frontmatter requirements\n(e.g. QwenWork description_zh), settings.json skill switches, zip-only\nproducts, and stale\u002Fdangling links. Use when the user says a skill is\nmissing, not loading, not showing up, or broken in a specific agent product.","yxdwind\u002Fagent-skill-manager","yxdwind","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F8383118?v=4","01M7ABZQ7AHVKJC74MFSX5C0GK","George","01M7ABZQ80FQTP9J7ZJZ7NBW7G",2,"MIT","https:\u002F\u002Fgithub.com\u002Fyxdwind\u002Fagent-skill-manager\u002Fblob\u002Fmaster\u002Fmarketing\u002Fskills-staging\u002Fsync-troubleshoot\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: sync-troubleshoot\ndescription: |\n  Diagnose why a skill loads in some AI agent products but not others when\n  using a central-repo + symlink setup (agent-skill-manager \u002F askill, or any\n  manual ~\u002F.agents\u002Fskills junction\u002Fsymlink layout). Walks a ordered checklist:\n  directory presence, link vs real dir, per-product frontmatter requirements\n  (e.g. QwenWork description_zh), settings.json skill switches, zip-only\n  products, and stale\u002Fdangling links. Use when the user says a skill is\n  missing, not loading, not showing up, or broken in a specific agent product.\nversion: 1.0.0\ndescription_zh: |\n  诊断技能在部分国产 AI Agent 产品里加载不出来的问题：按序排查中央仓库存在性、\n  链接悬空或退化为复制、产品级 frontmatter 要求（如 QwenWork 的 description_zh）、\n  settings.json 技能开关、zip 导入类产品、启动时扫描时机等，定位根因并给出修复命令。\n  当用户说某个技能没装上、加载不出来、列表里看不到、某产品里坏了时使用。\n---\n\n# Sync Troubleshoot\n\nDiagnose \"skill X does not load in product Y\". Work the checklist in order;\nstop at the first root cause found, but report skipped checks briefly.\n\n## Step 0 - Establish the facts\n\nAsk for \u002F determine:\n\n1. Which skill, which product(s) load it, which do not.\n2. Is the setup askill-managed (central `~\u002F.agents\u002Fskills\u002F` + links) or manual?\n3. OS (Windows\u002FmacOS\u002FLinux) - link semantics differ.\n\n## Step 1 - Is the skill in the central repo?\n\nCheck `~\u002F.agents\u002Fskills\u002F\u003Cskill>\u002FSKILL.md` exists. Missing here means it was\nnever installed (or the central root moved) - fix at install, not at the\nproduct.\n\n## Step 2 - Link health at the product\n\nFor each affected product, resolve its skills dir (see Step 5 for the table)\nand check:\n\n- **Dangling link:** the junction\u002Fsymlink exists but its target is gone.\n  Fix: re-run `askill sync \u003Cskill>`.\n- **Real dir, not a link:** the product dir holds a copy, not a link. It will\n  silently diverge from central on every edit. Fix: `askill sync \u003Cskill>`\n  (conflict protection will warn if contents differ; review the diff first).\n- **Stale copy:** a link exists but product shows old content - rare; check\n  whether the user edited the product copy through the link, then reverted the\n  central file separately.\n\nOn Windows, junctions need no admin rights, but **symlinks do** (or Developer\nMode). A \"real dir\" that was meant to be a link often means link creation\nfell back to copy - check askill sync output for `copy` vs `junction`.\n\n## Step 3 - Frontmatter requirements per product\n\nSome products require extra frontmatter and fail silently when it is absent:\n\n- **QwenWork:** requires `name`, `version`, `description`, `description_zh`.\n  Missing `description_zh` is the classic \"installed but never shows up\" cause.\n- Others: check the product's docs. Run `askill verify \u003Cskill>` - it checks\n  per-product frontmatter for all supported products.\n\nFix by adding the missing fields to the central SKILL.md, then `askill sync \u003Cskill>`.\n\n## Step 4 - Product-side switches and quirks\n\n- **settings.json skill switches** (WorkBuddy, CodeBuddy): the skill must be\n  registered and enabled in `{\"skills\": {\"\u003Cname>\": true}}`. A synced skill\n  with the switch off will not load. Fix: re-run `askill sync` (registers) or\n  toggle in the product.\n- **Zip-only products** (DuMate): no filesystem path exists. The skill loads\n  only from a zip uploaded in-app. Run `askill pack \u003Cskill>` and re-import;\n  sync output will never mention pack products - that is expected, not a bug.\n- **Shared skill dirs** (Trae CN + TRAE SOLO CN on `~\u002F.trae-cn\u002Fskills\u002F`;\n  Qoder CN + IDE on `~\u002F.qoder-cn\u002Fskills\u002F`): one fix covers both products -\n  do not look for a second directory.\n- **Restart the product:** most desktop products scan skills at startup only.\n  A skill synced after launch appears only after a full restart of the app.\n\n## Step 5 - Product path reference\n\n| Product | skills dir (macOS\u002FLinux) | Windows |\n|---|---|---|\n| AutoClaw2 | `~\u002F.openclaw-autoclaw\u002Fskills\u002F` | same |\n| Kimi | `~\u002F.config\u002Fagents\u002Fskills\u002F` (+ `~\u002F.kimi-code\u002Fskills\u002F`) | same |\n| MiniMax Code | `~\u002F.agents\u002Fskills\u002F` (native, no link needed) | same |\n| WorkBuddy | `~\u002F.workbuddy\u002Fskills\u002F` | same |\n| Trae \u002F Trae CN | `~\u002F.trae\u002Fskills\u002F`, `~\u002F.trae-cn\u002Fskills\u002F` | same |\n| CodeBuddy | `~\u002F.codebuddy\u002Fskills\u002F` | same |\n| Comate | `~\u002F.comate\u002Fskills\u002F` | same |\n| Qoder CN | `~\u002F.qoder-cn\u002Fskills\u002F` | same |\n| QwenWork | `~\u002F.qwenworkcn\u002Fskills\u002F` | same |\n| DoubaoWork | `~\u002F.super_doubao\u002F...\u002F.user_skills\u002F` | `%LOCALAPPDATA%\\DoubaoWork\\User Data\\Default\\.doubaowork\\agent_mode\\workspace\\.user_skills\\` |\n| ZCode | `~\u002F.zcode\u002Fskills\u002F` | same |\n| DuMate | none (zip import) | none |\n\n## Report format\n\n```\nROOT CAUSE: \u003Cone sentence>\nFIX: \u003Cexact commands\u002Fsteps, in order>\nVERIFIED: \u003Cwhich checks passed, or \"user to verify\">\n```\n\nOne root cause per report. If multiple products fail for different reasons,\nreport the general cause plus a per-product line. Do not run destructive\nfixes (deleting dirs, force-overwriting) yourself - state the command and let\nthe user confirm.\n","# Sync Troubleshoot\n\nDiagnose \"skill X does not load in product Y\". Work the checklist in order;\nstop at the first root cause found, but report skipped checks briefly.\n\n## Step 0 - Establish the facts\n\nAsk for \u002F determine:\n\n1. Which skill, which product(s) load it, which do not.\n2. Is the setup askill-managed (central `~\u002F.agents\u002Fskills\u002F` + links) or manual?\n3. OS (Windows\u002FmacOS\u002FLinux) - link semantics differ.\n\n## Step 1 - Is the skill in the central repo?\n\nCheck `~\u002F.agents\u002Fskills\u002F\u003Cskill>\u002FSKILL.md` exists. Missing here means it was\nnever installed (or the central root moved) - fix at install, not at the\nproduct.\n\n## Step 2 - Link health at the product\n\nFor each affected product, resolve its skills dir (see Step 5 for the table)\nand check:\n\n- **Dangling link:** the junction\u002Fsymlink exists but its target is gone.\n  Fix: re-run `askill sync \u003Cskill>`.\n- **Real dir, not a link:** the product dir holds a copy, not a link. It will\n  silently diverge from central on every edit. Fix: `askill sync \u003Cskill>`\n  (conflict protection will warn if contents differ; review the diff first).\n- **Stale copy:** a link exists but product shows old content - rare; check\n  whether the user edited the product copy through the link, then reverted the\n  central file separately.\n\nOn Windows, junctions need no admin rights, but **symlinks do** (or Developer\nMode). A \"real dir\" that was meant to be a link often means link creation\nfell back to copy - check askill sync output for `copy` vs `junction`.\n\n## Step 3 - Frontmatter requirements per product\n\nSome products require extra frontmatter and fail silently when it is absent:\n\n- **QwenWork:** requires `name`, `version`, `description`, `description_zh`.\n  Missing `description_zh` is the classic \"installed but never shows up\" cause.\n- Others: check the product's docs. Run `askill verify \u003Cskill>` - it checks\n  per-product frontmatter for all supported products.\n\nFix by adding the missing fields to the central SKILL.md, then `askill sync \u003Cskill>`.\n\n## Step 4 - Product-side switches and quirks\n\n- **settings.json skill switches** (WorkBuddy, CodeBuddy): the skill must be\n  registered and enabled in `{\"skills\": {\"\u003Cname>\": true}}`. A synced skill\n  with the switch off will not load. Fix: re-run `askill sync` (registers) or\n  toggle in the product.\n- **Zip-only products** (DuMate): no filesystem path exists. The skill loads\n  only from a zip uploaded in-app. Run `askill pack \u003Cskill>` and re-import;\n  sync output will never mention pack products - that is expected, not a bug.\n- **Shared skill dirs** (Trae CN + TRAE SOLO CN on `~\u002F.trae-cn\u002Fskills\u002F`;\n  Qoder CN + IDE on `~\u002F.qoder-cn\u002Fskills\u002F`): one fix covers both products -\n  do not look for a second directory.\n- **Restart the product:** most desktop products scan skills at startup only.\n  A skill synced after launch appears only after a full restart of the app.\n\n## Step 5 - Product path reference\n\n| Product | skills dir (macOS\u002FLinux) | Windows |\n|---|---|---|\n| AutoClaw2 | `~\u002F.openclaw-autoclaw\u002Fskills\u002F` | same |\n| Kimi | `~\u002F.config\u002Fagents\u002Fskills\u002F` (+ `~\u002F.kimi-code\u002Fskills\u002F`) | same |\n| MiniMax Code | `~\u002F.agents\u002Fskills\u002F` (native, no link needed) | same |\n| WorkBuddy | `~\u002F.workbuddy\u002Fskills\u002F` | same |\n| Trae \u002F Trae CN | `~\u002F.trae\u002Fskills\u002F`, `~\u002F.trae-cn\u002Fskills\u002F` | same |\n| CodeBuddy | `~\u002F.codebuddy\u002Fskills\u002F` | same |\n| Comate | `~\u002F.comate\u002Fskills\u002F` | same |\n| Qoder CN | `~\u002F.qoder-cn\u002Fskills\u002F` | same |\n| QwenWork | `~\u002F.qwenworkcn\u002Fskills\u002F` | same |\n| DoubaoWork | `~\u002F.super_doubao\u002F...\u002F.user_skills\u002F` | `%LOCALAPPDATA%\\DoubaoWork\\User Data\\Default\\.doubaowork\\agent_mode\\workspace\\.user_skills\\` |\n| ZCode | `~\u002F.zcode\u002Fskills\u002F` | same |\n| DuMate | none (zip import) | none |\n\n## Report format\n\n```\nROOT CAUSE: \u003Cone sentence>\nFIX: \u003Cexact commands\u002Fsteps, in order>\nVERIFIED: \u003Cwhich checks passed, or \"user to verify\">\n```\n\nOne root cause per report. If multiple products fail for different reasons,\nreport the general cause plus a per-product line. Do not run destructive\nfixes (deleting dirs, force-overwriting) yourself - state the command and let\nthe user confirm.\n",{"name":5,"version":24,"description":25,"description_zh":26},"1.0.0","Diagnose why a skill loads in some AI agent products but not others when\nusing a central-repo + symlink setup (agent-skill-manager \u002F askill, or any\nmanual ~\u002F.agents\u002Fskills junction\u002Fsymlink layout). Walks a ordered checklist:\ndirectory presence, link vs real dir, per-product frontmatter requirements\n(e.g. QwenWork description_zh), settings.json skill switches, zip-only\nproducts, and stale\u002Fdangling links. Use when the user says a skill is\nmissing, not loading, not showing up, or broken in a specific agent product.\n","诊断技能在部分国产 AI Agent 产品里加载不出来的问题：按序排查中央仓库存在性、\n链接悬空或退化为复制、产品级 frontmatter 要求（如 QwenWork 的 description_zh）、\nsettings.json 技能开关、zip 导入类产品、启动时扫描时机等，定位根因并给出修复命令。\n当用户说某个技能没装上、加载不出来、列表里看不到、某产品里坏了时使用。","master","211e1f603c9ef79545ccc774503c07312e4ed15c","marketing\u002Fskills-staging\u002Fsync-troubleshoot",1,"https:\u002F\u002Fgithub.com\u002Fyxdwind\u002Fagent-skill-manager","https:\u002F\u002Fpypi.org\u002Fproject\u002Fcn-skill-sync\u002F","https:\u002F\u002Fgithub.com\u002Fyxdwind","2026-11-14 00:18:56",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add yxdwind\u002Fagent-skill-manager --skill sync-troubleshoot",{"tool":41,"command":42},"bunx","bunx skills add yxdwind\u002Fagent-skill-manager --skill sync-troubleshoot",{"tool":44,"command":45},"pnpm","pnpm dlx skills add yxdwind\u002Fagent-skill-manager --skill sync-troubleshoot","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fyxdwind\u002Fagent-skill-manager\u002Fblob\u002Fmaster\u002Fmarketing\u002Fskills-staging\u002Fsync-troubleshoot\u002FSKILL.md",true,[],[50,56,62,68,74,80],{"skillNo":51,"name":52,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M7AC1MQM2098M6HY6FJR3MWS","shell-true","https:\u002F\u002Fgithub.com\u002Fyxdwind\u002Fagent-skill-manager\u002Fblob\u002Fmaster\u002Ftests\u002Ffixtures\u002Fmalicious\u002Fshell_true_subprocess\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M7AC1HXH3GBN21Q4RXCBX2P2","rm-rf-root","https:\u002F\u002Fgithub.com\u002Fyxdwind\u002Fagent-skill-manager\u002Fblob\u002Fmaster\u002Ftests\u002Ffixtures\u002Fmalicious\u002Frm_rf_root\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M7AC1FBFG6HW1Z88SV0036V3","instructions","https:\u002F\u002Fgithub.com\u002Fyxdwind\u002Fagent-skill-manager\u002Fblob\u002Fmaster\u002Ftests\u002Ffixtures\u002Fmalicious\u002Fprompt_injection_override\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7AC1CK21QWVGSSMVSXRSE5K","bootstrap","https:\u002F\u002Fgithub.com\u002Fyxdwind\u002Fagent-skill-manager\u002Fblob\u002Fmaster\u002Ftests\u002Ffixtures\u002Fmalicious\u002Fpowershell_iex_irm\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7AC1B296ENVYT94MB0B2Y7C","networking","https:\u002F\u002Fgithub.com\u002Fyxdwind\u002Fagent-skill-manager\u002Fblob\u002Fmaster\u002Ftests\u002Ffixtures\u002Fmalicious\u002Fnc_reverse_shell\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M7AC184Z6TN32B4MHGP44N44","api-helper","https:\u002F\u002Fgithub.com\u002Fyxdwind\u002Fagent-skill-manager\u002Fblob\u002Fmaster\u002Ftests\u002Ffixtures\u002Fmalicious\u002Fhardcoded_api_key\u002FSKILL.md",[],[]]