Files
antigravity-skills-reference/skills/tool-use-guardian/SKILL.md
christopherlhammer11-ai 16ff84afa1 feat: add Tool Use Guardian + RecallMax (free agent skills) (#298)
* feat: add Tool Use Guardian + RecallMax — free agent reliability & memory skills

Two free skills from the Genesis Agent Marketplace:

- **Tool Use Guardian**: 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.

- **RecallMax**: God-tier long-context memory. Injects 500K-1M clean tokens,
  auto-summarizes with tone/intent preservation, compresses 14-turn history
  into 800 high-density tokens.

Both are free forever and work with Claude, Codex, Gemini, Copilot, Cursor,
Windsurf, Antigravity, and any SKILL.md-compatible agent.

Install:
  npx skills add christopherlhammer11-ai/tool-use-guardian
  npx skills add christopherlhammer11-ai/recallmax

* docs: add source credits for genesis skills

---------

Co-authored-by: Mia Hammer <miahammer@Mac.attlocal.net>
Co-authored-by: sck_0 <samujackson1337@gmail.com>
2026-03-14 17:49:10 +01:00

3.0 KiB

name, description, category, risk, source, date_added, author, tags, tools
name description category risk source date_added author tags tools
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. reliability safe community 2026-03-13 christopherlhammer11-ai
reliability
tool-use
error-handling
retries
recovery
agent-infrastructure
claude
cursor
codex
gemini
copilot
windsurf
antigravity

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
  • @recallmax - Long-context memory enhancement (also free from Genesis Marketplace)