use-skills は、リクエストに対してどのインストール済みスキルが役立つかを選択するメタスキルです。
use writing-plans, code-reviewer, testing, docs, and refactoring のようなプロンプトを書く代わりに、$use-skills を呼び出して適切な組み合わせを推薦させます。
これは、計画立案とコーディング、レビューとテスト、文章作成と構造化、ドキュメントとコード変更など、リクエストが複数の領域にまたがる場合に便利です。
概要
- 関連するすべてのスキルを手動で指定する必要がなくなります
- 利用可能なスキルリストを代わりに確認します
- 以前のモードがない場合、探索前にユーザーにモード選択を求めます
- 各モードごとに適切なスキル候補を表示します
- 3つのモードをサポート:
All related（すべて関連）、Recommended（推奨）、Restricted（制限） - 使用時は短い作業セットブロックで開始します
- 選択されたガイダンスを1つの一貫した結果に統合します
- 強いマッチがない場合は使用されません
インストール
npx skills add https://github.com/CyrusSE/use-skills --global
レジストリ互換性
正規のランタイムスキルファイルは skills/use-skills/SKILL.md です。
このルート skills/ レイアウトは、skills.re のようにリポジトリ単位のスキルフォルダを期待するレジストリと互換性があり、通常のGitHubインストールフローもそのまま動作します:
npx skills add https://github.com/CyrusSE/use-skills --global
基本的な使い方
$use-skills
この機能リクエストを実装計画とテストメモに変換してください。
このタスクに計画立案、レビュー、テスト、ドキュメント、または他のインストール済みスキルが関わるべきかどうかを知る必要はありません。use-skills がその選択を処理します。
リクエストが明らかにマルチドメインである場合、このスキルは自動的に選択されることもあります。
なぜ使うのか
use-skills がない場合、ユーザーはスキルカタログを把握し、適切な組み合わせを手動で指定する必要があります。
use-skills を使うと、ワークフローは次のようになります:
$use-skills
このバグ報告に対して、最も関連するスキルのガイダンスを使って修正を行ってください。
その後モードを選択します。エージェントはプロンプトを適切な作業セットにマッピングし、タスクを続行します。
これは特に以下の場合に役立ちます:
- 多くのインストール済みスキルがある場合
- どのスキル名がタスクに適合するか確信が持てない場合
- タスクが一度に複数の種類のガイダンスを必要とする場合
- エージェントに作業セットを開始前に説明させたい場合
モード
以前のモードが適用されない場合、スキルは他のことをする前に質問します。プロンプトはユーザーが選択しやすいように具体的にすべきです:
1. All related（すべて関連）- 意味的に関連するすべての利用可能なスキルを使用します。
使用: use-skills, brainstorming, writing-plans, humanizer, enhance-prompt
対象: 修正戦略、レポート構造、プロンプトの明確さ、文言の広範なカバレッジ
2. Recommended（推奨）- 最適なバランスの作業セットを使用します。
使用: use-skills, brainstorming, writing-plans
対象: 不要なノイズを避けつつ強力な出力を得る
3. Restricted（制限）- 最も強いマッチのみを使用します。
使用: use-skills, brainstorming
対象: スキルの関与を最小限に抑えた集中した出力
スキルモードを選択してください。1、2、または3で答えてください。
質問前にファイルを検査したり、ワークスペースを検索したり、スキルを選択したり、モードを推測したりしてはいけません。
タスクと期待される出力が実質的に変わっていない場合は、再度質問してはいけません。「最良」「最も関連」「最も強い」などの言葉は明示的なモード選択とは見なされません。
ターミナルに関する注意: モードメニューはフェンスで囲まれた text ブロックを使用します。これは、一部のエージェントCLIが通常のリスト出力で空行を折りたたむためです。
スペースのルール: オプションブロックの間には1行の空行が必要です。「2. Recommended」がオプション1の「対象:」行の直下に表示される場合、メニューの書式は正しくありません。
All related（すべて関連）
リクエストに意味的に関連するすべての利用可能なスキルを使用します。
これは、ユーザーが明示的に広範なスキルカバレッジを望む場合に最適です。
Recommended（推奨）
リクエストに対して最適なバランスの作業セットを使用します。
これは、幅広い品質向上のための通常の選択肢です。
Restricted（制限）
最も強いマッチのみを使用します。通常は1～3個のスキルです。
これは、ユーザーが集中やスキル数の削減を求める場合に最適です。
出力の形状
使用時、応答は次のように始まります:
モード: All related（すべて関連） | Recommended（推奨） | Restricted（制限）使用: use-skills, <選択されたスキル>対象: <短い目的>
その後、エージェントは回答、計画、パッチ、または推奨事項を続けます。
モード質問が重要な理由
モードの選択は、探索の前に意図的に質問されます。これにより、「最良」「最も関連」「最も強い」などのフレーズを暗黙のモードと解釈することを防ぎます。
ユーザーは明確な選択ができます:
1は広範なカバレッジ2はバランスの取れた推奨3は集中した選択
適した使い方
- 多くのスキルを手動で指定する長いプロンプトの代わり
- 実装前の機能計画
- コーディング、テスト、レビューのガイダンスの組み合わせ
- READMEや製品仕様の改善
- より構造化された変更レビュー
- 集中した回答のために少数のスキルを選択する
適さない使い方
- 1つのスキルで十分な狭いタスク
- 直接コマンドのみが必要なリクエスト
- インストール済みスキルが明確な価値を追加しない作業
ドキュメントマップ
agents/openai.yaml: スキルインターフェースフィールドを読み取るディスカバリーサーフェス用のUIメタデータ- skills/use-skills/SKILL.md: ランタイム動作
- REFERENCE.md: 選択モデル
- examples/prompts.md: プロンプト例
リポジトリ構造
use-skills/
├── agents/
│ └── openai.yaml
├── assets/
│ └── use-skills-mode-picker.svg
├── examples/
│ └── prompts.md
├── skills/
│ └── use-skills/
│ └── SKILL.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── REFERENCE.md