tool-use-guardian

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 succes