コンテンツへスキップ

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

これは Muratcan Koylan によるコミュニティスキルで、当サイトや Anthropic による確認は受けていません。スキルはエージェントにコードの実行、ファイルの読み取り、ネットワークへのアクセスを指示できます。インストール前に SKILL.md とフォルダー内のすべてのスクリプトを読み、説明と食い違う動作がないか確認してください。

できること

  1. 重複する名前や曖昧な説明を点検。
  2. パラメータ、応答形式、復旧手順を定義。
  3. 意図したツールを選択し使えるかテスト。

得られるもの

  • ツール契約、修正した説明、検証計画。

使う場面

  • 誤ったツールを選ぶ、無効な引数を繰り返す場合。

向かない場面

  • システム全体の構成選択や、無関係な操作を巨大なツールにまとめる用途。

必要なもの

  • ファイル対応エージェントと、実際のツール定義・挙動・失敗例が必要です。
  • Python 生成器はテンプレートと簡易スコアを使う例であり、実際の選択性能向上を証明しません。

スキルに含まれるファイル

ファイル・フォルダー用途
SKILL.mdツール契約の指針、実例、設計上の落とし穴。
references/best_practices.mdPython 説明生成器と設計・統合の参考資料。
scripts/description_generator.pyPython 説明生成器と設計・統合の参考資料。

2026-11-20 時点でリポジトリに記載されていたライセンス:MIT。

プロンプト例

インストール後に次のいずれかを入力してください。スキル名を書くと確実にそのスキルが使われます。

  • 既定値と復旧可能なエラーを明記して契約を書き直してください。
  • 統合案の前に、重複するツール名を点検してください。
  • 同じ検索処理に簡潔版と詳細版の応答を設計してください。

tool-design のインストール方法

参考資料と実例を保持

フォルダ全体をコピーします。プラグインはコレクション全体を導入するため、単独ならフォルダ方式を使います。

文章の指針と Python テンプレートに外部サービスは不要です。実験には自分のエージェントとツール実装が必要です。ホスト環境へのアップロードと API 実行は未検証です。

スキルは SKILL.md ファイルを含むフォルダーです。インストールは一度だけで、エージェントは各セッションの開始時に短い説明を読み、リクエストが当てはまったときにだけ完全な指示を読み込みます。使う環境を選んでください:

Claude Code:プラグインマーケットプレイスから

  1. ターミナルで claude を実行して Claude Code を起動します。
  2. マーケットプレイスを追加します(パソコンごとに 1 回):
    /plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering
  3. プラグインをインストールします。Claude Code はまず詳細を表示するので、追加されるもの(スキル、フック、MCP サーバー)を確認し、自分用、このリポジトリの全員用、このリポジトリでの自分用のどれにするかを選びます。
    /plugin install context-engineering@context-engineering-marketplace
  4. / を入力して /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 以降)。
信頼できるスキルだけをインストールする. Anthropic は、信頼できる入手元のスキルだけを使い、それ以外のスキルは使う前にすべてのファイルを読むよう勧めています。スキルは、説明に書かれていない方法でエージェントにコマンドの実行、ファイルの読み取り、データの送信を指示できるからです。

これらの手順の出典

2026-11-14 に各ベンダーのドキュメントと照合しました:

次の行動を支える契約

名前と説明で実際の候補を区別できるようにします。既定値、入力制約、出力形式を明示してください。

タスクに合わせて簡潔・詳細出力を用意します。エラーは盲目的な再試行ではなく修正を可能にすべきです。

実際のタスクで統合を検証

ツール数削減は選択肢であり、性能保証ではありません。同じ代表タスクで成功、引数エラー、復旧を比較します。

生成器は説明を起草できますが、バックエンド、権限、エージェントの理解は検証しません。

tool-design に関するよくある質問

MCP サーバーを構築しますか?

いいえ。契約設計を支援しますが、通信、認証、バックエンド実行は別途実装します。

すべてのツールを統合すべきですか?

いいえ。関連する作業を必要に応じて統合し、無関係な操作は分け、結果をテストします。

エラー応答には何を含めますか?

機密情報を出さず、失敗原因と再試行前に変更すべき入力や状態を示します。

例の品質スコアは実測性能ですか?

いいえ。文字パターンとメタデータの確認です。選択と復旧は代表的なエージェント実行で検証してください。

ほかの AI スキル

関連スキル

スキルのカテゴリー