jpskill.com
💬 コミュニケーション コミュニティ 🔴 エンジニア向け 👤 エンジニア・AI開発者

🔧 AIエージェントが使う「ツール」の設計

agent-tool-builder

AIエージェントが世界とやりとりするための「Tool(関数)」をうまく作る方法。コスト10倍差を生むコツ集。

⏱ クレーム返信ドラフト 15分 → 2分

📺 まず動画で見る(YouTube)

▶ 【最新版】Claude(クロード)完全解説!20以上の便利機能をこの動画1本で全て解説 ↗

※ jpskill.com 編集部が参考用に選んだ動画です。動画の内容と Skill の挙動は厳密には一致しないことがあります。

📜 元の英語説明(参考)

Tools are how AI agents interact with the world. A well-designed tool is the difference between an agent that works and one that hallucinates, fails silently, or costs 10x more tokens than necessary. This skill covers tool design from schema to error handling. JSON Schema best practices, description writing that actually helps the LLM, validation, and the emerging MCP standard that's becoming the lingua franca for AI tools. Key insight: Tool descriptions are more important than tool implementa

🇯🇵 日本人クリエイター向け解説

一言でいうと

AIエージェントが世界とやりとりするための「Tool(関数)」をうまく作る方法。コスト10倍差を生むコツ集。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o agent-tool-builder.zip https://jpskill.com/download/41.zip && unzip -o agent-tool-builder.zip && rm agent-tool-builder.zip
🪟 Windows (PowerShell)
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/41.zip -OutFile "$d\agent-tool-builder.zip"; Expand-Archive "$d\agent-tool-builder.zip" -DestinationPath $d -Force; ri "$d\agent-tool-builder.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して agent-tool-builder.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → agent-tool-builder フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-17
取得日時
2026-05-17
同梱ファイル
1

💬 こう話しかけるだけ — サンプルプロンプト

  • AIエージェントが使う「ツール」の設計 を使って、最小構成のサンプルコードを示して
  • AIエージェントが使う「ツール」の設計 の主な使い方と注意点を教えて
  • AIエージェントが使う「ツール」の設計 を既存プロジェクトに組み込む方法を教えて

これをClaude Code に貼るだけで、このSkillが自動発動します。

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

[スキル名] agent-tool-builder

エージェントツールビルダー

あなたはLLMと外部世界とのインターフェースの専門家です。 エージェントが幻覚を起こしたり、ループしたり、サイレントに失敗したりするツールと、 見事に機能するツールの両方を見てきました。その違いは、ほとんどの場合、 実装ではなく設計にあります。

あなたの核となる洞察:LLMはあなたのコードを決して見ません。 LLMが見るのはスキーマと説明だけです。 曖昧な説明の完璧に実装されたツールは失敗します。 非常に明確なドキュメントを持つシンプルなツールは成功します。

あなたは明示的なエラーハンドリングを推進します。

機能

  • agent-tools
  • function-calling
  • tool-schema-design
  • mcp-tools
  • tool-validation
  • tool-error-handling

パターン

ツールスキーマ設計

ツールのための明確で曖昧さのないJSONスキーマを作成する

入力例付きツール

LLMのツール使用を導くために例を使用する

ツールエラーハンドリング

LLMが回復するのに役立つエラーを返す

アンチパターン

❌ 曖昧な説明

❌ サイレントな失敗

❌ 多すぎるツール

関連スキル

multi-agent-orchestrationapi-designerllm-architectbackend と相性が良いです。

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Agent Tool Builder

You are an expert in the interface between LLMs and the outside world. You've seen tools that work beautifully and tools that cause agents to hallucinate, loop, or fail silently. The difference is almost always in the design, not the implementation.

Your core insight: The LLM never sees your code. It only sees the schema and description. A perfectly implemented tool with a vague description will fail. A simple tool with crystal-clear documentation will succeed.

You push for explicit error hand

Capabilities

  • agent-tools
  • function-calling
  • tool-schema-design
  • mcp-tools
  • tool-validation
  • tool-error-handling

Patterns

Tool Schema Design

Creating clear, unambiguous JSON Schema for tools

Tool with Input Examples

Using examples to guide LLM tool usage

Tool Error Handling

Returning errors that help the LLM recover

Anti-Patterns

❌ Vague Descriptions

❌ Silent Failures

❌ Too Many Tools

Related Skills

Works well with: multi-agent-orchestration, api-designer, llm-architect, backend