Tool Design スキル
入力、出力、選択条件、復旧可能なエラーを明記したエージェント用ツール契約を設計。
コミュニティ · Muratcan Koylan| 作者 | Muratcan Koylan |
|---|---|
| ライセンス | MIT |
| ソース | muratcankoylan/Agent-Skills-for-Context-Engineering · GitHub 上の SKILL.md |
| 対応環境 | Claude Code · Codex、Gemini CLI、Cursor、Copilot |
| ソースを確認した日 |
tool-design スキルは、エージェントと呼び出すツールのインターフェースを改善します。
各ツールを契約として扱い、選ぶタイミング、入力、出力、失敗からの復旧を定めます。バックエンド自体は実装しません。
スキルの SKILL.md より: ## Gotchas
できること
- 重複する名前や曖昧な説明を点検。
- パラメータ、応答形式、復旧手順を定義。
- 意図したツールを選択し使えるかテスト。
得られるもの
- ツール契約、修正した説明、検証計画。
使う場面
- 誤ったツールを選ぶ、無効な引数を繰り返す場合。
向かない場面
- システム全体の構成選択や、無関係な操作を巨大なツールにまとめる用途。
必要なもの
- ファイル対応エージェントと、実際のツール定義・挙動・失敗例が必要です。
- Python 生成器はテンプレートと簡易スコアを使う例であり、実際の選択性能向上を証明しません。
スキルに含まれるファイル
| ファイル・フォルダー | 用途 |
|---|---|
SKILL.md | ツール契約の指針、実例、設計上の落とし穴。 |
references/best_practices.md | Python 説明生成器と設計・統合の参考資料。 |
scripts/description_generator.py | Python 説明生成器と設計・統合の参考資料。 |
2026-11-20 時点でリポジトリに記載されていたライセンス:MIT。
プロンプト例
インストール後に次のいずれかを入力してください。スキル名を書くと確実にそのスキルが使われます。
- 既定値と復旧可能なエラーを明記して契約を書き直してください。
- 統合案の前に、重複するツール名を点検してください。
- 同じ検索処理に簡潔版と詳細版の応答を設計してください。
tool-design のインストール方法
参考資料と実例を保持
フォルダ全体をコピーします。プラグインはコレクション全体を導入するため、単独ならフォルダ方式を使います。
文章の指針と Python テンプレートに外部サービスは不要です。実験には自分のエージェントとツール実装が必要です。ホスト環境へのアップロードと API 実行は未検証です。
スキルは SKILL.md ファイルを含むフォルダーです。インストールは一度だけで、エージェントは各セッションの開始時に短い説明を読み、リクエストが当てはまったときにだけ完全な指示を読み込みます。使う環境を選んでください:
Claude Code:プラグインマーケットプレイスから
- ターミナルで
claudeを実行して Claude Code を起動します。 - マーケットプレイスを追加します(パソコンごとに 1 回):
/plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering - プラグインをインストールします。Claude Code はまず詳細を表示するので、追加されるもの(スキル、フック、MCP サーバー)を確認し、自分用、このリポジトリの全員用、このリポジトリでの自分用のどれにするかを選びます。
/plugin install context-engineering@context-engineering-marketplace - / を入力して
/context-engineering:tool-designを探すか、そのまま作業を依頼します。
セッション内ではなくシェルから行う場合:
claude plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering
claude plugin install context-engineering@context-engineering-marketplaceプラグインは丸ごとインストールされるため、context-fundamentals, context-degradation, context-compression, context-optimization, self-managed-context, multi-agent-patterns, long-horizon-prompting, memory-systems, filesystem-context, hosted-agents, evaluation, advanced-evaluation, harness-engineering, project-development, bdi-mental-states, latent-briefing, self-improvement-loops などほかのスキルも一緒に入ります。
Claude Code:スキルフォルダーにフォルダーをコピー
このパソコン上のすべてのプロジェクトで使うならスキルのフォルダーを ~/.claude/skills/ に、作業者全員で共有するならリポジトリ内の .claude/skills/ に置きます(コミットしてください)。
git clone --depth 1 https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering.git
mkdir -p ~/.claude/skills
cp -R Agent-Skills-for-Context-Engineering/skills/tool-design ~/.claude/skills/Claude Code はセッション中にこれらのフォルダーで新しいスキルや変更されたスキルを検出します。セッション開始時にスキルフォルダーが存在しなかった場合は、/reload-skills を一度実行してください。その後 /tool-design と入力するか、作業内容をそのまま伝えます。
Windows では Git Bash または WSL でコマンドを実行するか、エクスプローラーで同じ場所にフォルダーをコピーしてください。
Codex、Gemini CLI、Cursor、GitHub Copilot
これらのエージェントも同じ SKILL.md フォルダーを読みます。4 つすべてがプロジェクト内で読むフォルダーは .agents/skills/ なので、次のコマンドでスキルをそこにコピーします:
git clone --depth 1 https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering.git
mkdir -p .agents/skills
cp -R Agent-Skills-for-Context-Engineering/skills/tool-design .agents/skills/| エージェント | プロジェクトのフォルダー | ユーザーのフォルダー | メモ |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | $ と入力するか /skills を実行してスキルを選びます。タスクが当てはまれば Codex が自動で選ぶこともあります。 |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | または gemini skills install <git URL> --path <folder> --consent で Git からインストールします。Google は 2026 年 6 月 18 日、無料枠と Google One のユーザー向けに Gemini CLI を Antigravity CLI に置き換えました。Antigravity はプロジェクトでは .agents/skills/、ユーザー用には ~/.gemini/config/skills/ を使います。 |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Agent チャットで / を入力してスキルを選びます。Cursor は Claude Code の .claude/skills/ フォルダーも読みます。 |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Copilot CLI、クラウドエージェント、VS Code・Visual Studio・JetBrains のエージェントモードで動きます(IDE の対応はバージョンによります)。または gh skill install OWNER/REPOSITORY SKILL を実行します(パブリックプレビュー、GitHub CLI 2.90.0 以降)。 |
これらの手順の出典
2026-11-14 に各ベンダーのドキュメントと照合しました:
次の行動を支える契約
名前と説明で実際の候補を区別できるようにします。既定値、入力制約、出力形式を明示してください。
タスクに合わせて簡潔・詳細出力を用意します。エラーは盲目的な再試行ではなく修正を可能にすべきです。
実際のタスクで統合を検証
ツール数削減は選択肢であり、性能保証ではありません。同じ代表タスクで成功、引数エラー、復旧を比較します。
生成器は説明を起草できますが、バックエンド、権限、エージェントの理解は検証しません。
tool-design に関するよくある質問
MCP サーバーを構築しますか?
いいえ。契約設計を支援しますが、通信、認証、バックエンド実行は別途実装します。
すべてのツールを統合すべきですか?
いいえ。関連する作業を必要に応じて統合し、無関係な操作は分け、結果をテストします。
エラー応答には何を含めますか?
機密情報を出さず、失敗原因と再試行前に変更すべき入力や状態を示します。
例の品質スコアは実測性能ですか?
いいえ。文字パターンとメタデータの確認です。選択と復旧は代表的なエージェント実行で検証してください。
ほかの AI スキル
関連スキル
Dev-Browser スキル
コミュニティ · Sawyer Hood永続的な名前付きページ、Puppeteer スクリプト、ローカル CLI サービスで Chrome を自動操作。Agent Evaluation スキル
コミュニティ · Muratcan Koylan決定的な検査、独立した品質指標、版管理した基準でエージェントの回帰テストを計画。Context Degradation スキル
コミュニティ · Muratcan Koylan検証済みの事実とタスク別の比較から、長文コンテキストの失敗と復旧方法を診断。Advanced Evaluation スキル
コミュニティ · Muratcan Koylan証拠に基づく評価基準、順序を入れ替える比較、人による校正で LLM 裁判を設計。Brainstormingスキル
コミュニティ · Jesse Vincent / Prime Radiantコードを書く前に、初期アイデアを合意済みの設計へ整理します。Writing Plansスキル
コミュニティ · Jesse Vincent / Prime Radiant承認済み設計を、インターフェースと検証付きのレビュー可能なタスクに変換。