Skip to content
OpenSmartRoute
Skillv1.0.0

tool-use-guardian

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.

by adobetoby-maker(0) 0 installs
Free
Sign in to install

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Imported from adobetoby-maker/tac-brain-workspace (skills-index/tool-use-guardian/SKILL.md). Install upstream with npx skills add adobetoby-maker/tac-brain-workspace --skill tool-use-guardian. Copyright stays with the author.

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-guardian

When 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

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.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml
targets:
  - https://api.opensmartroute.ai/api/v1/registry/adobetoby-maker-tac-brain-workspace-tool-use-guardian/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

adobetoby-maker-tac-brain-workspace-tool-use-guardian.ocm.jsonjson
{
  "ocm": "1",
  "id": "adobetoby-maker-tac-brain-workspace-tool-use-guardian",
  "kind": "skill",
  "name": "tool-use-guardian",
  "description": "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.",
  "publisher": "adobetoby-maker",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "reliability",
      "tool-use",
      "error-handling",
      "retries",
      "recovery",
      "agent-infrastructure",
      "github"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "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."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/adobetoby-maker/tac-brain-workspace",
      "path": "skills-index/tool-use-guardian/SKILL.md",
      "ref": "24ed1a92873519fd5580e54b5d1bdedcc5a090fc",
      "url": "https://github.com/adobetoby-maker/tac-brain-workspace/blob/24ed1a92873519fd5580e54b5d1bdedcc5a090fc/skills-index/tool-use-guardian/SKILL.md",
      "key": "adobetoby-maker/tac-brain-workspace/skills-index/tool-use-guardian/SKILL.md"
    }
  },
  "instructions": "# Tool Use Guardian\n\n## Overview\n\nThe 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.\n\nFree forever. Built by the Genesis Agent Marketplace.\n\n## Install\n\n```bash\nnpx skills add christopherlhammer11-ai/tool-use-guardian\n```\n\n## When to Use This Skill\n\n- Use when tool calls return truncated or malformed JSON\n- Use when APIs timeout or rate-limit your agent mid-task\n- Use when a multi-step chain breaks partway through\n- Use when you need automatic retry",
  "cost": {
    "context_tokens": 722
  }
}

Fetch it by URL: GET /api/v1/registry/adobetoby-maker-tac-brain-workspace-tool-use-guardian/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.