Neo Skills

Neo Skills 是一組給 AI Agent 使用的專家技能模組。它把語言、框架、DevOps、Code Review、需求釐清、Agent 治理與文字潤飾等工作流程包成可安裝的 SKILL.md，讓支援 Agent Skills 的工具能在需要時載入精準知識，而不是把所有規則塞進一段大型系統提示詞。

目前專案提供：

• skills/：內建多個專家技能。
• bin/install-skills.js：同步技能到 Antigravity CLI 全域技能目錄。
• bin/install-system-instructions.js：把系統提示詞安裝到 Claude Code、Copilot CLI、Codex 或 Antigravity 的指導檔。
• scripts/check-skills-syntax.py：非互動式技能結構驗證工具。

適合誰

• 想讓 AI Agent 穩定遵守專案規範的開發者。
• 想把常用工作流程整理成可重複觸發技能的團隊。
• 使用 Antigravity CLI、Codex、Claude Code、Copilot CLI 或其他相容 Agent Skills 工具的人。
• 需要把 AI 輔助開發從「靠提示詞」提升到「有知識庫、範本、腳本、驗證」的人。

核心設計

內建技能

generate-skill 位於 .agents/skills/，可由 Agent Skills CLI 探索與安裝；其餘技能位於 skills/。

安裝

Antigravity CLI 全域安裝

同步 skills/ 下的技能到 ~/.gemini/antigravity-cli/skills：

npx -y @moon791017/neo-skills@latest

本地開發時可直接執行：

node bin/install-skills.js

Agent Skills CLI 安裝

安裝全部技能到目前專案：

npx skills add Benknightdark/neo-skills --skill --all -y

安裝全部技能到全域：

npx skills add Benknightdark/neo-skills --skill --all -g -y

系統提示詞安裝

Agent Skills 規格同步的是技能目錄；AGENTS.md、CLAUDE.md、Copilot instructions 或 Antigravity agents.md 這類指導檔需要另外安裝。

npx -p @moon791017/neo-skills install-system-instructions --instructions technical-co-founder

指定 Agent 與專案路徑：

npx -p @moon791017/neo-skills install-system-instructions \
  --ai-agent codex \
  --instructions technical-co-founder \
  --project-path .

更新已安裝過的同一段提示詞：

npx -p @moon791017/neo-skills install-system-instructions \
  --ai-agent codex \
  --instructions git-commit \
  --project-path . \
  --replace-all

支援的 Agent 指導檔

支援的系統提示詞

常用情境

開發

npm install
npm test
python3 scripts/check-skills-syntax.py --dir skills

維護技能

新增或修改 skill 時，請同步檢查：

1. SKILL.md 第一行是 ---。
2. frontmatter 有 name 與觸發導向的 description。
3. name 與資料夾名稱一致。
4. 深度內容放進 references/ 或 reference/，範本放進 assets/ 或 templates/，可執行流程放進 scripts/。
5. 腳本必須非互動式，stdout 只輸出可解析資料，診斷輸出到 stderr。
6. README 的技能清單與實際 skills/ 內容一致。
7. 執行 python3 scripts/check-skills-syntax.py --dir skills 與 npm test。

License

MIT