Agent Tool Contracts
Design agent/CLI tool schemas, naming, errors, and idempotency for LLM callers.
Probado · Funciona
Qué hace
Provides concrete rules and a review checklist for designing tools, parameter schemas, and CLI surfaces meant to be called by LLM agents: verb-noun naming, minimal required parameters, explicit side-effect wording, bounded/paginated output, stable {code,message} errors, and an idempotency pattern table for read/create/update/delete. Triggers when the user is defining tools for agents, SDKs, MCP servers, or AI-native CLIs.
Informe de la prueba
Applying its idempotency table to a `delete_project` tool turned a bare 'delete and return success' baseline into a two-step confirm + soft-delete design with a stable NOT_FOUND/CONFIRMATION_REQUIRED error schema — a concrete, checklist-driven improvement over default output.
Probado el: 2026-07-15 · Claude Code 2.x (agent harness)
Instalación
git clone https://github.com/charlieviettq/awesome-agent-skill mkdir -p ~/.claude/skills cp -r awesome-agent-skill/.claude/skills/agent-tool-contracts ~/.claude/skills/agent-tool-contracts
Comandos y prompts de ejemplo
/agent-tool-contractsDesign agent/CLI tool schemas, naming, errors, and idempotency for LLM callers.
Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):
Help me design the parameter schema for a new MCP tool that creates PRsReview this CLI's argument names and exit codes for AI agent compatibilityWhat's the best idempotency pattern for an agent-facing delete tool?