install-skills

プロジェクトスキルをインストールする

プロジェクトローカルのスキルはリポジトリに属します。ロックファイルにはスキルのソースが記録され、コミット済みの .agents/skills/ と .claude/skills/ のエントリーによって、新しくチェックアウトした環境でも利用できます。

skills-lock.json に変更がなく、コミット済みのスキルディレクトリを復元するだけの場合は、次を実行します。

pnpm skills:install

ロックファイルのエントリーを追加、削除、名前変更、または更新する場合は、スキルリスト変更の手順をお読みください。作業の順序、上流で名前が変更または削除されたスキルの確認、プルリクエストの概要、および必須の検証について説明しています。

インストール前

1. AGENTS.md、CLAUDE.md、およびエージェントスキルや共有ツールに関するリポジトリの指示を読みます。

2. 現在インストールされているスキルの一覧を確認します。pnpm skills:list などのリポジトリスクリプトがあれば、そちらを優先します。なければ、次を実行します。

   test -f skills-lock.json && npm_config_ignore_scripts=true npx --yes skills@latest list --json
   

3. 要求されたソースとスキル名を特定します。どちらかが不明な場合は、インストール前にソースを一覧表示します。

   npm_config_ignore_scripts=true npx --yes skills@latest add <source> --list
   

インストール

リポジトリのルートからインストールを実行します。--global は使用しないでください。

1 つのソースから、指定した 1 つ以上のスキルをインストールします。

npm_config_ignore_scripts=true npx --yes skills@latest add <source> --skill <skill-a> <skill-b> --agent '*' --yes

すべてのスキルをインストールするのは、ユーザーがすべてを要求した場合に限ります。

npm_config_ignore_scripts=true npx --yes skills@latest add <source> --skill '*' --agent '*' --yes

GitHub のロックエントリーには source と skillPath が含まれます。復元コマンドはソースのデフォルトブランチをクローンするため、再実行すると、より新しい上流のコンテンツがインストールされる場合があります。ソースは一般公開されている必要があります。固定バージョンが必要な場合は、git ref を指定したソースを使用します。

ロックファイルを変更した後は、ロックされているすべてのスキルを復元します。

pnpm skills:install

このコマンドは skills-lock.json を読み取り、.agents/skills/ の下に実際のスキルディレクトリを書き込み、.claude/skills/ の下に対応する相対リンクを維持します。

Patina Project のスキルには、patinaproject/skills を使用し、要求された名前のスキルだけをインストールします。リポジトリでよく使われるデフォルトは次のとおりです。

• scaffold-repository
• using-github
• install-skills
• design-by-contract
• grill-system-design
• review-system-design
• writing-for-pstack

検証

次を実行します。

npm_config_ignore_scripts=true npx --yes skills@latest list --json
git status --short

catalog-change.md に記載されている追加の確認もすべて行います。インストールしたスキル、そのソース、および変更されたロックファイルまたはスキルディレクトリを報告します。ユーザーからブランチの作業を完了するよう依頼されていない限り、コミット前に作業を止めます。