sickn33/agentic-awesome-skills/tool-use-guardian

Claude Code and agent skill by sickn33/agentic-awesome-skills

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Triage tool failures, validate responses and resume bounded workflows using replay-safe retries and explicit handling of unknown write outcomes.

Install

npx vskill@latest install sickn33/agentic-awesome-skills/tool-use-guardian

SKILL.md

The same SKILL.md was published earlier as sickn33/agentic-awesome-skills/tool-use-guardian.

Tool Use Guardian

Scope

This is a manual recovery procedure, not an installed wrapper, automatic monitor or learned reliability service. No runtime, checkpoint store or telemetry is bundled. Preserve the host's tool contracts and the user's action boundaries.

When to Use This Skill

  • A tool response is incomplete, malformed, rate-limited or inconsistent.
  • A workflow needs to resume without replaying completed mutations.
  • A write timed out and its outcome must be reconciled before any further action.

Procedure

  1. Record the tool, target, exact non-secret parameters, request identity, observed

error and any confirmed effects. Separate transport status from application success. Do not log credentials, private payloads or full conversation context.

  1. Validate parameters and responses against the actual tool schema. Do not

coerce an unknown identifier, invent missing fields, or repair truncated JSON by guessing. Fetch complete bounded pages or request a smaller result.

  1. Classify the operation before retrying: a read, a documented idempotent write

using the same operation key, or a potentially non-idempotent mutation. A timeout or 429 does not prove that a mutation had no effect.

  1. For replay-safe transient reads, follow documented Retry-After/backoff within

a deadline and at most three total attempts unless the tool contract is stricter. Stop on authentication, permission, invalid-input and persistent schema failures. Do not change credentials or scope to evade a failure.

  1. For an uncertain write, use a supported read-only status lookup bound to the

same request/operation ID. Resume only after establishing its outcome. If lookup is unavailable or ambiguous, preserve the uncertainty and request the indispensable decision; never silently repeat a payment, message or delete.

  1. Maintain a task-local checkpoint of confirmed completed steps and their

evidence. Before resuming a dependent step, verify its prerequisites still hold. Do not replay earlier writes merely because a later step failed. Return completed, failed and unknown steps separately.

Recovery Examples

ObservationBounded next action
Truncated read-only inventoryFetch supported pages; reject incomplete inventory as completion evidence.
Read timed outRetry within the read deadline and attempt cap; keep failures visible.
Mutation timed outInspect status by the original operation ID; do not submit a second mutation.
Authentication expiredReport required reauthentication through the supported host flow.
HTTP 200 with an error bodyApply the documented result schema; record application failure.
Schema mismatchRetain the original result; investigate contract/version mismatch without lossy coercion.
text
Step: publish-message, operation ID op-17
Observation: request timed out; no receipt returned.
Status lookup: unavailable.
Disposition: outcome unknown; no retry sent. Dependent announcement paused.

Limitations

  • These instructions cannot enforce retry safety or recover unknown remote state.
  • Repeated failures are observations about this task, not proof a tool is globally

unreliable. Do not write a global denylist or persistent memory automatically.

  • Checkpoints can become stale; verify the target state and authorization on resume.
  • No automatic interception, free service, learning or guaranteed recovery is

established by the source links.

Declared source links

  • https://github.com/christopherlhammer11-ai/tool-use-guardian
  • https://genesis-node-api.vercel.app
  • https://genesis-marketplace.vercel.app

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
47,167
Repository forks
6,871
7-day trend score
54

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/sickn33/agentic-awesome-skills/tool-use-guardian/badge)](https://verified-skill.com/skills/sickn33/agentic-awesome-skills/tool-use-guardian)

Something wrong with this skill or its page? Tell us.