Is the Agent Tool Contracts skill free?

Yes. The skill itself is free from charlieviettq/awesome-agent-skill. SkillProof publishes the install command and an independent test verdict at no cost.

What is the Agent Tool Contracts SkillProof Score?

9.2/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 8/10, docs & honesty 5/5.

How do I install Agent Tool Contracts?

Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.

Can I use Agent Tool Contracts with Cursor, Copilot, Gemini CLI, Codex or other AI tools?

The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.

Agent Tool Contracts

Design agent/CLI tool schemas, naming, errors, and idempotency for LLM callers.

by charlieviettq · charlieviettq/awesome-agent-skill

Tested · Works

Install — copy the command Download source ↗

Test report

Verdict: Tested · Works
Score: 9.2/10
Tested: Jul 15, 2026
Environment: Claude Code 2.x (agent harness)
Upstream re-checked: Aug 10, 2026 · 45634e9

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.

Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works

Installs cleanly 5/5
Triggers reliably 5/5
Output vs. baseline 8/10
Docs & honesty 5/5

What Agent Tool Contracts does

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.

How to install Agent Tool Contracts

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

Skills live in ~/.claude/skills/ (global) or .claude/skills/ (per-project). Restart Claude Code after installing.

Commands — how to trigger Agent Tool Contracts

/agent-tool-contracts Design agent/CLI tool schemas, naming, errors, and idempotency for LLM callers.

It also activates on plain-language prompts like these:

Help me design the parameter schema for a new MCP tool that creates PRs
Review this CLI's argument names and exit codes for AI agent compatibility
What's the best idempotency pattern for an agent-facing delete tool?

Frequently asked questions

Is the Agent Tool Contracts skill free?: Yes. The skill itself is free from charlieviettq/awesome-agent-skill. SkillProof publishes the install command and an independent test verdict at no cost.
Does Agent Tool Contracts work with Claude Code?: We tested it with Claude Code 2.x (agent harness) on Jul 15, 2026. Verdict: Tested · Works. 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.
What is the Agent Tool Contracts SkillProof Score?: 9.2/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 8/10, docs & honesty 5/5.
How do I install Agent Tool Contracts?: Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
Can I use Agent Tool Contracts with Cursor, Copilot, Gemini CLI, Codex or other AI tools?: The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.