agent-skills 是什麼？

這項技能提供一套標準化流程，用於管理 AI 代理（如 Claude、Codex 等）的技能文件。開發者可以透過本技能在 workspace 中編輯、建立或刪除共享技能（位於 agent-skills 儲存庫內），同時也能管理自家儲存庫內的下游本機技能。技能支援 Nix 目錄系統，透過 `catalog.nix` 列出共享技能，並允許下游覆寫。主要功能包括：編輯共享技能時需維護 feature branch、建立新技能時需更新目錄與資源連結、以及刪除技能時需同步更新鎖定檔案。此外，也提供排除特定共享技能並替換為本機版本的機制。

相容平台✓Claude Code✓Codex CLI~Cursor

npx skills add https://github.com/goromal/agent-skills/tree/HEAD/skills/editing-skills

說明文件

已安裝技能的來源

AI 代理技能由 home-manager 安裝至 ~/.claude/skills/、~/.agents/skills/ 和 ~/.codex/skills/。這些管理路徑會連結到來源技能目錄。請編輯所屬的儲存庫，而非已安裝的連結。

共享技能來源與資源位在 workspace 的 agent-skills/skills/<name>/ 目錄中。位於 agent-skills/catalog.nix 的 Nix 目錄會為使用者選取共享技能。下游覆寫可以透過它們自己的 machines.claude.skills 和 machines.codex.skills 設定加入本機技能路徑；請將這些檔案保留在下游儲存庫中。

編輯共享技能

在 workspace 的 agent-skills 檢出目錄中編輯其資料夾。
如果變更也會更新使用者，請在兩個儲存庫中使用相同的功能分支。如果尚未加入，請使用 addsrc agent-skills [email protected]:goromal/agent-skills.git 將 agent-skills 加入 workspace。
如有需要，使用暫時的本機 flake 輸入測試 anixpkgs 整合。在推送前，請還原遠端功能分支網址，並使用 nix flake update agent-skills 鎖定它。
開啟 agent-skills PR，並從使用者 PR 中連結它。先合併技能來源 PR，然後將使用者重新固定到合併後的 main 修訂版。

建立共享技能

在 agent-skills 中新增 skills/<skill-name>/SKILL.md；將參考資料、範例、腳本和資產存放在其旁邊。
在 catalog.nix 中新增 { name = "<skill-name>"; file = ./skills/<skill-name>/SKILL.md; }。條目預設適用於 Claude 和 Codex；必要時可設定 frameworks。
將支援資源的相對路徑連結到技能資料夾，並更新下游鎖定。

編輯下游本機技能

在擁有提供技能路徑的覆寫或模組的儲存庫中進行變更。保持目錄自包含（含參考資料）。其設定可以為框架的 skills 選項新增 { name, file } 條目。

刪除或取代共享技能

從 catalog.nix 中移除其條目，並刪除其來源資料夾，然後更新下游鎖定。若要在一台機器上取代共享技能，請將其名稱列在 machines.agents.excludedSkills 中，並在下游模組中以該名稱加入本機技能路徑。

goromal/agent-skills