Agent skill

Tool Use Guardian

by sickn33 in sickn33/agentic-awesome-skills

FREE — Intelligent tool-call reliability wrapper. An agent skill from sickn33/agentic-awesome-skills.

MITAuto-check passedBackend & APIs

Install Tool Use Guardian

skills CLI
$ npx skills add sickn33/agentic-awesome-skills --skill tool-use-guardian -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sickn33/agentic-awesome-skills tool-use-guardian --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/tool-use-guardian .claude/skills/tool-use-guardian && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tool-use-guardian
GitHub stars
47k
Used in
2 other repos
Token cost
~849 tokens
SKILL.md length
371 words
Files
1
Skills in repo
1,497
Repo updated
First seen
Licence
MIT

At a glance

FREE — Intelligent tool-call reliability wrapper. An agent skill from sickn33/agentic-awesome-skills.

  • Works in 4 steps: Pre-Call Validation → Failure Classification → Chain Protection → …
  • Tasks that involve Rate limiting
  • SKILL.md covers Overview, Install, When to Use This Skill and How It Works, plus 4 more sections
  • Calls npx

What it does

Tool Use Guardian is an agent skill from sickn33/agentic-awesome-skills. 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.

Its SKILL.md is about 850 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Rate limiting. The repository describes itself as: AAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400+ agentic skills. Includes… The licence is MIT.

When your agent uses it

  • Tasks that involve Rate limiting

Example prompts

  • “/tool-use-guardian”

Requirements

  • Node.js

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Pre-Call Validation
  2. Failure Classification
  3. Chain Protection
  4. Learning

What it can do on your machine

Read from SKILL.md and the folder at commit b84d35a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com
    • genesis-node-api.vercel.app
    • genesis-marketplace.vercel.app

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tool Use Guardian loads about 849 tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 371 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~849

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sickn33/agentic-awesome-skills at commit b84d35a, republished under its MIT licence (© sickn33). 371 words, ~849 tokens.

Download SKILL.mdSave it as .claude/skills/tool-use-guardian/SKILL.md (or your agent's skills folder).
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.
category
reliability
risk
safe
source
community
date_added
2026-03-13
author
christopherlhammer11-ai
tags
reliability, tool-use, error-handling, retries, recovery, agent-infrastructure
tools
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

bash
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 TypeRecovery Action
Truncated JSONRe-fetch with pagination or smaller chunks
API TimeoutRetry once with simpler request, then decompose
Rate Limit (429)Exponential backoff, max 3 retries
Auth ExpiredFlag for user intervention
Mid-chain BreakResume from last successful checkpoint
Error-as-200Detect {"error": "..."} disguised as success
Schema MismatchAttempt auto-coercion, warn if lossy
Network FailureRetry with jitter, max 2 attempts
Unknown ErrorLog full context, escalate to user
Show full SKILL.md (151 more words)Show less
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)

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.

© sickn33, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/tool-use-guardian of sickn33/agentic-awesome-skills.

Open the folder on GitHubat commit b84d35a

Used in 2 other repositories

We found 11 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in sickn33/agentic-awesome-skills, which our catalogue first saw on October 9, 2026.

Compare with similar skills

Tool Use Guardian next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Tool Use Guardian compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tool Use Guardian this skillsickn33/agentic-awesome-skills47k2 repos~849Automated safety check: PassMIT
Add Hosted Keysimstudioai/sim30k—~3.4kAutomated safety check: PassApache-2.0
Upstash Ratelimit TSupstash/ratelimit-js2k—~313Automated safety check: PassMIT
Repo2skillzhangyanxs/repo2skill246—~3.6kAutomated safety check: PassNone
Better Auth Security Best PracticesEpicenterHQ/epicenter4.8k—~896Automated safety check: PassCustom licence
Dload Fetch Toolphp-internal/dload105—~1.1kAutomated safety check: PassBSD-3-Clause

Similar skills

  • Add Hosted Key

    simstudioai/sim

    Add hosted API key support to a tool so Sim provides the key (metered and billed to the workspace) when a user has not brought their own.

    30k GitHub stars~3.4k tokensUpdated today
    Backend & APIsAuto-check passed
  • Upstash Ratelimit TS

    upstash/ratelimit-js

    Official

    Lightweight guidance for using the Redis Rate Limit TypeScript SDK, including setup steps, basic usage, and pointers to advanced algorithm, features, pricing, and traffic‑protection docs.

    2k GitHub stars~313 tokensUpdated 15 days ago
    Backend & APIsAuto-check passed
  • Repo2skill

    zhangyanxs/repo2skill

    Convert GitHub/GitLab/Gitee repositories into comprehensive OpenCode Skills using embedded LLM calls with multiple mirrors and rate limit handling

    246 GitHub stars~3.6k tokensUpdated 7 mo ago
    Backend & APIsAuto-check passed
  • Better Auth security hardening: rate limits, secrets, CSRF, trusted origins, cookies, sessions, OAuth tokens, and audit logging.

    4.8k GitHub stars~896 tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Dload Fetch Tool

    php-internal/dload

    Get a CLI tool — native binary or PHAR — from a GitHub release into a project folder with dload (vendor/bin/dload).

    105 GitHub stars~1.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • API Gateway

    itsmostafa/aws-agent-skills

    AWS API Gateway for REST and HTTP API management. An agent skill from itsmostafa/aws-agent-skills.

    1.2k GitHub stars~2.2k tokensUpdated 4 days ago
    Backend & APIsAuto-check passed

More from sickn33/agentic-awesome-skills

All 1,497 skills in this repo
  • Liuguang Banlan UI

    sickn33/agentic-awesome-skills

    Implements an interface in one of two named color modes, iridescent white or colorful black, from a parameterized starter that reports measured color intensity.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • User Thoughts Memory

    sickn33/agentic-awesome-skills

    Saves a user's project decisions, rules and preferences into a project-local mdbase so later sessions and other agents can recover the intent.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Using LWC Memory and Graphs

    sickn33/agentic-awesome-skills

    Keeps project decisions, research and verified results available across coding-agent sessions through LWC memory, a document Wiki graph and a CodeGraph code index.

    47k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Find Complementary Founders

    sickn33/agentic-awesome-skills

    Guides an agent through assessing its own owner for cofounder fit, publishing an approved profile, and ranking complementary profiles other agents published for their owners.

    47k GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check passed
  • Whatsapp Cloud API

    sickn33/agentic-awesome-skills

    Integracao com WhatsApp Business Cloud API (Meta). An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~4.5k tokens
    Auto-check passed
  • Cline Pilot

    sickn33/agentic-awesome-skills

    Acts as a proxy for the Cline CLI, dispatching coding tasks one at a time, monitoring runs by hard evidence, relaying decisions to you and learning per-project preferences.

    47k GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed

Categories

Questions about Tool Use Guardian

What does Tool Use Guardian do?

FREE — Intelligent tool-call reliability wrapper. An agent skill from sickn33/agentic-awesome-skills. Tool Use Guardian is an agent skill from sickn33/agentic-awesome-skills. FREE — Intelligent tool-call reliability wrapper.

When should I use Tool Use Guardian?

Tool Use Guardian fits situations like: tasks that involve Rate limiting.

How do I install Tool Use Guardian in Claude Code?

Run `npx skills add sickn33/agentic-awesome-skills --skill tool-use-guardian -a claude-code`. Or copy the skill folder (skills/tool-use-guardian in sickn33/agentic-awesome-skills) into .claude/skills/tool-use-guardian in your project. Claude Code loads it when a task matches its description.

How do I install Tool Use Guardian in Codex?

Run `npx skills add sickn33/agentic-awesome-skills --skill tool-use-guardian -a codex`. Or copy the skill folder (skills/tool-use-guardian in sickn33/agentic-awesome-skills) into .agents/skills/tool-use-guardian in your project. Codex loads it when a task matches its description.

Can I use Tool Use Guardian in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sickn33/agentic-awesome-skills --skill tool-use-guardian -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tool-use-guardian, .gemini/skills/tool-use-guardian, .github/skills/tool-use-guardian and .opencode/skills/tool-use-guardian in your project.

What does Tool Use Guardian need to run?

Going by SKILL.md and its folder, Tool Use Guardian needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does Tool Use Guardian access the network?

SKILL.md names 3 domains. As links in the text: github.com, genesis-node-api.vercel.app and genesis-marketplace.vercel.app. This is read from the text; nothing was executed.

Is Tool Use Guardian safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Tool Use Guardian use?

Tool Use Guardian is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tool Use Guardian use?

About 849 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Tool Use Guardian?

Skills that share tags, products or a category with Tool Use Guardian: Add Hosted Key (simstudioai/sim, 30k stars), Upstash Ratelimit TS (upstash/ratelimit-js, 2k stars), Repo2skill (zhangyanxs/repo2skill, 246 stars) and Better Auth Security Best Practices (EpicenterHQ/epicenter, 4.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tool Use Guardian?

sickn33 (a GitHub user) maintains it in sickn33/agentic-awesome-skills, which has 47,405 GitHub stars. The repository holds 1,497 skills in this directory. The repository was last updated on October 9, 2026.

Source: sickn33/agentic-awesome-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.