{"id":"ac582f2b-d668-4719-afa3-80b35ea4a8d0","shortId":"GsyXUN","kind":"skill","title":"tool-use-guardian","tagline":"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.","description":"# 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 logic without writing it yourself\n- Use for any agent workflow that depends on external tool reliability\n\n## How It Works\n\n### Step 1: Pre-Call Validation\n\nBefore every tool call, Guardian validates:\n- Required parameters are present and correctly typed\n- The tool is not marked as \"unreliable\" from previous failures\n- Request size is within known limits\n\n### Step 2: Failure Classification\n\nWhen a tool call fails, Guardian classifies the failure into one of 9 categories:\n\n| Failure Type | Recovery Action |\n|---|---|\n| Truncated JSON | Re-fetch with pagination or smaller chunks |\n| API Timeout | Retry once with simpler request, then decompose |\n| Rate Limit (429) | Exponential backoff, max 3 retries |\n| Auth Expired | Flag for user intervention |\n| Mid-chain Break | Resume from last successful checkpoint |\n| Error-as-200 | Detect `{\"error\": \"...\"}` disguised as success |\n| Schema Mismatch | Attempt auto-coercion, warn if lossy |\n| Network Failure | Retry with jitter, max 2 attempts |\n| Unknown Error | Log full context, escalate to user |\n\n### Step 3: Chain Protection\n\nFor multi-step tool chains, Guardian maintains checkpoints. If step 4 of 7 fails, it resumes from step 4 — never restarts from scratch.\n\n### Step 4: Learning\n\nGuardian tracks failure patterns per tool. After 3+ failures of the same type, it marks the tool as unreliable and suggests alternatives.\n\n## Best Practices\n\n- ✅ Let Guardian wrap all external tool calls automatically\n- ✅ Review Guardian's reliability reports to identify flaky tools\n- ✅ Use checkpoint recovery for long chains\n- ❌ Don't disable retry logic for rate-limited APIs\n- ❌ Don't ignore repeated failure warnings\n\n## Related Skills\n\n- `@recallmax` - Long-context memory enhancement (also free from Genesis Marketplace)\n\n## Links\n\n- **Repo:** https://github.com/christopherlhammer11-ai/tool-use-guardian\n- **Marketplace:** https://genesis-node-api.vercel.app\n- **Browse skills:** https://genesis-marketplace.vercel.app\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["tool","use","guardian","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding"],"capabilities":["skill","source-sickn33","skill-tool-use-guardian","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/tool-use-guardian","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34460 github stars · SKILL.md body (2,889 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T06:52:02.630Z","embedding":null,"createdAt":"2026-04-18T21:46:27.695Z","updatedAt":"2026-04-22T06:52:02.630Z","lastSeenAt":"2026-04-22T06:52:02.630Z","tsv":"'/christopherlhammer11-ai/tool-use-guardian':392 '/tool-use-guardian':85 '1':149 '2':184,271 '200':250 '3':230,282,319 '4':296,304,310 '429':226 '7':298 '9':199 'action':204 'add':81 'agent':43,75,109,137 'ai':42,84 'also':383 'altern':333 'api':102,215,368 'ask':431 'attempt':258,272 'auth':232 'auto':21,49,260 'auto-coercion':259 'auto-recov':20 'auto-retri':48 'automat':127,343 'backoff':228 'bash':78 'best':334 'boundari':439 'break':120,241 'brows':395 'built':71 'call':9,47,94,152,157,190,342 'categori':200 'chain':32,66,119,240,283,290,358 'checkpoint':246,293,354 'christopherlhammer11':83 'christopherlhammer11-ai':82 'chunk':214 'clarif':433 'classif':186 'classifi':193 'clear':406 'coercion':261 'context':277,380 'correct':165 'criteria':442 'decompos':223 'depend':140 'describ':410 'detect':251 'disabl':361 'disguis':253 'enhanc':382 'environ':422 'environment-specif':421 'error':248,252,274 'error-a':247 'escal':278 'everi':41,155 'expert':427 'expir':233 'exponenti':227 'extern':142,340 'fail':191,299 'failur':19,33,51,176,185,195,201,266,314,320,373 'fetch':209 'fix':14,52 'flag':234 'flaki':351 'forev':70 'free':5,69,384 'full':276 'genesi':74,386 'genesis-marketplace.vercel.app':397 'genesis-node-api.vercel.app':394 'github.com':391 'github.com/christopherlhammer11-ai/tool-use-guardian':390 'guardian':4,36,158,192,291,312,337,345 'identifi':350 'ignor':371 'input':436 'instal':77 'intellig':6 'intervent':237 'jitter':269 'json':25,99,206 'known':181 'last':244 'learn':16,56,311 'let':336 'limit':28,107,182,225,367,398 'link':388 'log':275 'logic':129,363 'long':357,379 'long-context':378 'lose':64 'lossi':264 'maintain':292 'malform':98 'mark':171,326 'marketplac':76,387,393 'match':407 'max':229,270 'memori':381 'mid':31,111,239 'mid-chain':30,238 'mid-task':110 'mismatch':257 'miss':444 'monitor':12,45 'multi':117,287 'multi-step':116,286 'need':44,126 'network':265 'never':63,305 'npx':79 'one':197 'output':416 'overview':37 'pagin':211 'paramet':161 'partway':121 'pattern':315 'per':316 'permiss':437 'practic':335 'pre':151 'pre-cal':150 'present':163 'previous':175 'protect':284 'rate':27,106,224,366 'rate-limit':105,365 're':208 're-fetch':207 'recallmax':377 'recov':22 'recoveri':203,355 'relat':375 'reliabl':10,39,144,347 'repeat':372 'repo':389 'report':348 'request':177,221 'requir':160,435 'respons':54 'restart':306 'resum':242,301 'retri':13,50,128,217,231,267,362 'return':95 'review':344,428 'safeti':438 'schema':256 'scope':409 'scratch':308 'simpler':220 'size':178 'skill':80,90,376,396,401 'skill-tool-use-guardian' 'smaller':213 'source-sickn33' 'specif':423 'step':118,148,183,281,288,295,303,309 'stop':429 'substitut':419 'success':245,255,441 'suggest':332 'task':112,405 'test':425 'thought':68 'timeout':26,103,216 'tool':2,8,18,34,46,58,93,143,156,168,189,289,317,328,341,352 'tool-cal':7 'tool-use-guardian':1 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'track':313 'treat':414 'truncat':24,53,96,205 'type':166,202,324 'unknown':273 'unreli':60,173,330 'use':3,35,88,91,100,113,123,134,353,399 'user':236,280 'valid':153,159,424 'warn':262,374 'within':180 'without':130 'work':147 'workflow':138 'wrap':338 'wrapper':11,40 'write':131","prices":[{"id":"c0568320-5090-4686-826a-18c449221e5b","listingId":"ac582f2b-d668-4719-afa3-80b35ea4a8d0","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:46:27.695Z"}],"sources":[{"listingId":"ac582f2b-d668-4719-afa3-80b35ea4a8d0","source":"github","sourceId":"sickn33/antigravity-awesome-skills/tool-use-guardian","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/tool-use-guardian","isPrimary":false,"firstSeenAt":"2026-04-18T21:46:27.695Z","lastSeenAt":"2026-04-22T06:52:02.630Z"}],"details":{"listingId":"ac582f2b-d668-4719-afa3-80b35ea4a8d0","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"tool-use-guardian","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34460,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-22T06:40:00Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"a6cc8a7c068339c6870371e02cb863628089f5b6","skill_md_path":"skills/tool-use-guardian/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/tool-use-guardian"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"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."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/tool-use-guardian"},"updatedAt":"2026-04-22T06:52:02.630Z"}}