managing-skills

`npx skills` CLI を使用してエージェントスキルを管理します。GitHub リポジトリからのスキルのインストール、利用可能なスキルの検索、更新の確認、インストール済みスキルの更新を行います。

<quick_start> ユーザーが希望する操作を特定し、適切なコマンドを実行します。確認をスキップするため、常に --yes を指定してください。特に指示がない場合は、プロジェクト単位のインストールと現在のエージェントタイプをデフォルトにします。

主なコマンド：

npx skills add {source} --yes --agent {agent-type}
npx skills find {keyword} --yes
npx skills check --yes
npx skills update --yes
npx skills add --list --yes

</quick_start>

実行中のエージェントを特定します。対応する `--agent` フラグの値を指定してください。

エージェント	フラグ値
Amp	amp
Claude Code	claude-code
Cline	cline
Codex	codex
Continue	continue
Cursor	cursor
Gemini CLI	gemini-cli
GitHub Copilot	github-copilot
Goose	goose
Kilo Code	kilo
Kiro CLI	kiro-cli
OpenCode	opencode
Qwen Code	qwen-code
Roo Code	roo
Trae	trae
Windsurf	windsurf

不明な場合は、設定ディレクトリ（例：.claude/、.codex/、.cursor/）を確認してください。 ユーザーが明示的に求めた場合（例：「すべてのエージェントにインストール」「codex にもインストール」）に限り、追加のエージェントタイプを指定してください。 </agent_type>

<install_scope>

• プロジェクト（デフォルト）：現在のプロジェクトの ./<agent>/skills/ にインストールします。
• グローバル（-g）：~/<agent>/skills/ にインストールします。ユーザーが「グローバル」「グローバルに」または「すべてのプロジェクトに」と指定した場合にのみ使用してください。 </install_scope>

ユーザーが「インストール」「追加」「取得」「スキルをセットアップ」と指定した場合 1. スキルのソースを特定します。次の形式を使用できます。 - `owner/repo` — リポジトリ内のすべてのスキルをインストールします - リポジトリ、ディレクトリ、または SKILL.md ファイルへの GitHub/GitLab の完全な URL（例：`https://github.com/owner/repo/tree/main/skills/foo`） - ローカルファイルシステムのパス - 複数スキルを含むリポジトリから特定のスキルを選ぶには、`-s skill-name` を使用します 2. インストール範囲を決めます。プロジェクト（デフォルト）またはグローバル（`-g`）です。 3. 対象とするエージェントタイプを決めます。 4. 次を実行します。 ```bash npx skills add {source} --yes --agent {agent-type} ``` グローバルの場合は `-g` を追加します。複数のエージェントを対象とする場合は、`--agent` フラグを複数指定します。 「vercel-labs/skills のスキルをインストール」 → `npx skills add vercel-labs/skills --yes --agent claude-code`

「そのリポジトリから managing-skills スキルだけをインストール」 → npx skills add vercel-labs/skills --yes -s managing-skills --agent claude-code

「このスキルをインストール：github.com/owner/repo/tree/main/skills/foo」 → npx skills add https://github.com/owner/repo/tree/main/skills/foo --yes --agent claude-code

「foo/bar をすべてのエージェントにグローバルインストール」 → npx skills add foo/bar --yes -g --all

ユーザーが「探す」「検索する」「見つける」「スキルを閲覧する」と指定した場合 1. ユーザーがキーワードを指定した場合は、そのまま渡します。 2. 次を実行します。 ```bash npx skills find {keyword} --yes ``` 3. 結果をユーザーに提示します。ユーザーがいずれかを選んだ場合は、インストール操作に従います。 ユーザーが「更新を確認」「スキルは最新か」と指定した場合 次を実行します。 ```bash npx skills check --yes ``` 更新が利用可能なスキルを報告します。見つかった場合は、更新するかどうかをユーザーに確認します。 ユーザーが「スキルを更新」「スキルをアップグレード」と指定した場合 次を実行します。 ```bash npx skills update --yes ``` 更新した内容を報告します。 ユーザーが「スキルを一覧表示」「インストール済みスキルを表示」「自分が持っているスキルは何か」と指定した場合 次を実行します。 ```bash npx skills add --list --yes ``` - 確認プロンプトをスキップするため、常に `--yes` を使用します。 - ユーザーが明示的にグローバルと指定しない限り、プロジェクト単位をデフォルトにします。 - 現在のエージェントタイプのみをデフォルトにします。ユーザーが求めた場合に限り、他のエージェントを追加します。 - コマンドが失敗した場合は、エラー出力を表示し、解決策（例：ソース URL やネットワークの確認）を提案します。 - インストール後、成功したことを伝え、スキルのインストール先を案内します。 - 要求されたスキル操作が正常に完了しました。 - 実行内容を確認する出力がユーザーに表示されました。 - 対象範囲とエージェントの指定がユーザーの意図（プロジェクト／グローバル、正しいエージェント）に一致しました。