{
  "markdown": "# ai-dev-skills\n\n`ai-dev-skills` 是 ai-dev 的第一方 Agent Skills collection。每個 skill 都可以透過\n[`skills`](https://github.com/vercel-labs/skills) CLI 單獨安裝，不需要安裝 ai-dev framework。\n\n## 安裝\n\n列出全部 skills：\n\n```bash\nnpx skills add ValorVie/ai-dev-skills --list\n```\n\n互動式選擇並安裝：\n\n```bash\nnpx skills add ValorVie/ai-dev-skills\n```\n\n互動式清單會將 20 個 skills 收在 `Ai Dev Skills` group。`skills@1.5.22` 可從\ngroup 那一列整組選取；`skills@1.5.23` 以上另提供最上方的 `Select All`。展開\ngroup 後仍可個別選擇。\n\n只安裝指定 skill：\n\n```bash\nnpx skills add ValorVie/ai-dev-skills --skill custom-agent-router\n```\n\nai-dev 使用者不需要逐一執行這些命令。ai-dev 的 `npx-skills` phase 會依明確清單安裝及更新 baseline skills。\n\n## Skills\n\n- `cloud-infrastructure-security`\n- `custom-agent-router`\n- `simplify`\n- `custom-skill-creator`\n- `custom-skills-dev`\n- `custom-skills-doc-updater`\n- `custom-skills-doc-writer`\n- `custom-skills-ecc-analyze`\n- `custom-skills-git-commit`\n- `custom-skills-notify`\n- `custom-skills-plan-analyze`\n- `custom-skills-threads-research`\n- `custom-skills-tool-overlap-analyzer`\n- `custom-skills-upstream-ops`\n- `discuss-multi-ai`\n- `eli5`\n- `first-principles`\n- `safe-run`\n- `wiki`\n- `work-log-claude`\n\n## 安裝邊界\n\n`npx skills` 只安裝選定的 skill 目錄。Claude Code plugins、hooks、commands、agents 與 ai-dev framework 不會隨之安裝。需要 companion integration 的 skill 會在自己的 `SKILL.md` 提供獨立入口。\n\n## 驗證\n\n```bash\npython tests/validate_skills.py\npython -m pytest tests/test_custom_agent_router_contract.py skills/work-log-claude/tests\nDISABLE_TELEMETRY=1 npx --yes skills@1.5.22 add . --list\n```\n\nvalidator 會檢查 canonical ID、目錄名稱、必要 frontmatter、plugin collection\n清單、相對連結、generated files 與公開邊界。`.claude-plugin/plugin.json` 必須明確\n列出全部 canonical IDs，讓 `npx skills` 顯示可整組選取的 collection。\n\n## 維護原則\n\n- `skills/<name>/` 必須與 `SKILL.md` frontmatter 的 `name` 相同。\n- skill 的主要流程必須 self-contained；必要 scripts、references、assets、templates、evals 與直接測試放在 skill 目錄內。\n- 新增 skill 不代表它會自動進入 ai-dev baseline。baseline 另由 ai-dev repository 的明確清單管理。\n- 公開內容不得包含內部品牌、repository、host、帳號、credential 位置、private path 或組織專用流程。\n\n## 來源\n\n初始 snapshot 來自 `ValorVie/custom-skills` commit\n`56953acf0709f6841d52ded85bc0e67d52cb540a`，並在首次發布前完成公開邊界清理。\n\n## License\n\nMIT。個別 skill 若有額外授權或來源說明，以該目錄內文件為準。\n",
  "bytes": 2144,
  "sha": "48a06276cfd83d5183759773f9cb83208e5629a97d4c55bf588d3c1ae90c7748",
  "repo_slug": "valorvie/ai-dev-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/skl_valorvie_ai_dev_skills_eli5_52f9629a/readme"
}