インストールされたスキルの入手元
エージェントスキルはhome-managerによって ~/.claude/skills/、~/.agents/skills/、~/.codex/skills/ にインストールされます。これらの管理パスはソースのスキルディレクトリにリンクされています。インストールされたリンクではなく、所有するリポジトリを編集してください。
共有スキルのソースとリソースはワークスペースの agent-skills/skills/<name>/ ディレクトリにあります。agent-skills/catalog.nix のNixカタログが、消費者向けに共有スキルを選択します。下流のオーバーレイは、独自の machines.claude.skills および machines.codex.skills 設定を通じてローカルスキルパスを追加できます。これらのファイルは下流リポジトリに保持してください。
共有スキルの編集
- ワークスペースの
agent-skillsチェックアウト内の該当ディレクトリを編集します。 - 変更が消費者の更新も伴う場合は、両方のリポジトリで同じフィーチャーブランチを使用します。ワークスペースに
agent-skillsがない場合は、addsrc agent-skills [email protected]:goromal/agent-skills.gitで追加します。 - 必要に応じて、一時的なローカルflake入力を使用してanixpkgs統合をテストします。プッシュする前に、リモートのフィーチャーブランチURLを復元し、
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を設定します。- サポートリソースをスキルフォルダからの相対パスでリンクし、下流のロックを更新します。
下流ローカルスキルの編集
スキルパスを提供するオーバーレイまたはモジュールを所有するリポジトリ内で変更します。ディレクトリは自己完結型に保ち、参照先を含めます。その設定により、フレームワークのスキルオプションに { name, file } エントリを追加できます。
共有スキルの削除または置換
catalog.nix からエントリを削除し、ソースフォルダを削除してから、下流のロックを更新します。1台のマシンで共有スキルを置換するには、その名前を machines.agents.excludedSkills にリストし、下流モジュールでその名前のローカルスキルパスを追加します。