🛠️ ツールUseGuardian
AIが外部ツールを利用する際に発生する様々な
📺 まず動画で見る(YouTube)
▶ 【衝撃】最強のAIエージェント「Claude Code」の最新機能・使い方・プログラミングをAIで効率化する超実践術を解説! ↗
※ jpskill.com 編集部が参考用に選んだ動画です。動画の内容と Skill の挙動は厳密には一致しないことがあります。
📜 元の英語説明(参考)
FREE — Intelligent tool-call reliability wrapper. Monitors, retries, fixes, and learns from tool failures. Auto-recovers from truncated JSON, timeouts, rate limits, and mid-chain failures.
🇯🇵 日本人クリエイター向け解説
AIが外部ツールを利用する際に発生する様々な
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o tool-use-guardian.zip https://jpskill.com/download/3618.zip && unzip -o tool-use-guardian.zip && rm tool-use-guardian.zip$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/3618.zip -OutFile "$d\tool-use-guardian.zip"; Expand-Archive "$d\tool-use-guardian.zip" -DestinationPath $d -Force; ri "$d\tool-use-guardian.zip"完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。
💾 手動でダウンロードしたい(コマンドが難しい人向け)
- 1. 下の青いボタンを押して
tool-use-guardian.zipをダウンロード - 2. ZIPファイルをダブルクリックで解凍 →
tool-use-guardianフォルダができる - 3. そのフォルダを
C:\Users\あなたの名前\.claude\skills\(Win)または~/.claude/skills/(Mac)へ移動 - 4. Claude Code を再起動
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-17
- 取得日時
- 2026-05-17
- 同梱ファイル
- 1
💬 こう話しかけるだけ — サンプルプロンプト
- › Tool Use Guardian を使って、最小構成のサンプルコードを示して
- › Tool Use Guardian の主な使い方と注意点を教えて
- › Tool Use Guardian を既存プロジェクトに組み込む方法を教えて
これをClaude Code に貼るだけで、このSkillが自動発動します。
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
Tool Use Guardian
概要
すべてのAIエージェントが必要とする信頼性ラッパーです。ツール呼び出しを監視し、失敗を自動的に再試行し、切り詰められた応答を修正し、信頼性の低いツールを学習することで、思考の連鎖が途切れることがありません。
永久に無料です。Genesis Agent Marketplaceによって構築されました。
インストール
npx skills add christopherlhammer11-ai/tool-use-guardianこのスキルを使用するタイミング
- ツール呼び出しが切り詰められた、または不正な形式のJSONを返す場合に使用します。
- APIがタイムアウトしたり、タスクの途中でエージェントにレート制限をかけたりする場合に使用します。
- 複数ステップの連鎖が途中で中断する場合に使用します。
- 自動再試行ロジックを自分で記述せずに必要とする場合に使用します。
- 外部ツールの信頼性に依存するあらゆるエージェントワークフローに使用します。
仕組み
ステップ1：呼び出し前検証
すべてのツール呼び出しの前に、Guardianは以下を検証します。
- 必須パラメーターが存在し、正しく型付けされていること
- 以前の失敗により、ツールが「信頼性が低い」とマークされていないこと
- リクエストサイズが既知の制限内であること
ステップ2：失敗分類
ツール呼び出しが失敗した場合、Guardianは失敗を9つのカテゴリのいずれかに分類します。
| 失敗タイプ | 回復アクション |
|---|---|
| 切り詰められたJSON | ページネーションまたはより小さなチャンクで再フェッチ |
| APIタイムアウト | より単純なリクエストで一度再試行し、その後分解 |
| レート制限 (429) | 指数バックオフ、最大3回再試行 |
| 認証期限切れ | ユーザー介入を促すフラグ |
| 連鎖の中断 | 最後の成功したチェックポイントから再開 |
| エラーを200として返す | 成功を装った {"error": "..."} を検出 |
| スキーマ不一致 | 自動型変換を試行、情報損失がある場合は警告 |
| ネットワーク障害 | ジッターを伴って再試行、最大2回 |
| 不明なエラー | 完全なコンテキストをログに記録し、ユーザーにエスカレート |
ステップ3：連鎖保護
複数ステップのツール連鎖の場合、Guardianはチェックポイントを維持します。7ステップ中4ステップ目が失敗した場合、最初からやり直すのではなく、4ステップ目から再開します。
ステップ4：学習
Guardianはツールごとの失敗パターンを追跡します。同じタイプの失敗が3回以上発生した後、ツールを信頼性が低いとマークし、代替案を提案します。
ベストプラクティス
- ✅ Guardianにすべての外部ツール呼び出しを自動的にラップさせます。
- ✅ Guardianの信頼性レポートを確認して、不安定なツールを特定します。
- ✅ 長い連鎖にはチェックポイント回復を使用します。
- ❌ レート制限されたAPIの再試行ロジックを無効にしないでください。
- ❌ 繰り返される失敗警告を無視しないでください。
関連スキル
@recallmax- 長文コンテキスト記憶力強化 (Genesis Marketplaceからも無料で提供)
リンク
- リポジトリ: https://github.com/christopherlhammer11-ai/tool-use-guardian
- マーケットプレイス: https://genesis-node-api.vercel.app
- スキルを閲覧: https://genesis-marketplace.vercel.app
制限事項
- このスキルは、タスクが上記の範囲と明確に一致する場合にのみ使用してください。
- 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
- 必要な入力、権限、安全境界、または成功基準が不足している場合は、停止して説明を求めてください。
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
Tool Use Guardian
Overview
The reliability wrapper every AI agent needs. Monitors tool calls, auto-retries failures, fixes truncated responses, and learns which tools are unreliable — so you never lose your chain of thought.
Free forever. Built by the Genesis Agent Marketplace.
Install
npx skills add christopherlhammer11-ai/tool-use-guardianWhen to Use This Skill
- Use when tool calls return truncated or malformed JSON
- Use when APIs timeout or rate-limit your agent mid-task
- Use when a multi-step chain breaks partway through
- Use when you need automatic retry logic without writing it yourself
- Use for any agent workflow that depends on external tool reliability
How It Works
Step 1: Pre-Call Validation
Before every tool call, Guardian validates:
- Required parameters are present and correctly typed
- The tool is not marked as "unreliable" from previous failures
- Request size is within known limits
Step 2: Failure Classification
When a tool call fails, Guardian classifies the failure into one of 9 categories:
| Failure Type | Recovery Action |
|---|---|
| Truncated JSON | Re-fetch with pagination or smaller chunks |
| API Timeout | Retry once with simpler request, then decompose |
| Rate Limit (429) | Exponential backoff, max 3 retries |
| Auth Expired | Flag for user intervention |
| Mid-chain Break | Resume from last successful checkpoint |
| Error-as-200 | Detect {"error": "..."} disguised as success |
| Schema Mismatch | Attempt auto-coercion, warn if lossy |
| Network Failure | Retry with jitter, max 2 attempts |
| Unknown Error | Log full context, escalate to user |
Step 3: Chain Protection
For multi-step tool chains, Guardian maintains checkpoints. If step 4 of 7 fails, it resumes from step 4 — never restarts from scratch.
Step 4: Learning
Guardian tracks failure patterns per tool. After 3+ failures of the same type, it marks the tool as unreliable and suggests alternatives.
Best Practices
- ✅ Let Guardian wrap all external tool calls automatically
- ✅ Review Guardian's reliability reports to identify flaky tools
- ✅ Use checkpoint recovery for long chains
- ❌ Don't disable retry logic for rate-limited APIs
- ❌ Don't ignore repeated failure warnings
Related Skills
@recallmax- Long-context memory enhancement (also free from Genesis Marketplace)
Links
- Repo: https://github.com/christopherlhammer11-ai/tool-use-guardian
- Marketplace: https://genesis-node-api.vercel.app
- Browse skills: https://genesis-marketplace.vercel.app
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.