Agent Tool Contracts

Design agent/CLI-verktøyskjemaer, navngivning, feil og idempotens for LLM-kallere.

av charlieviettq · charlieviettq/awesome-agent-skill

Bestått ★ 9.2/10

Agent Tool Contracts — Design agent/CLI-verktøyskjemaer, navngivning, feil og idempotens for LLM-kallere.

Hva den gjør

Tilbyr konkrete regler og en gjennomgangs-sjekkliste for å designe verktøy, parameter-skjemaer og CLI-flater ment å kalles av LLM-agenter: verb-substantiv navngivning, minimale påkrevde parametere, eksplisitt sideeffekt-formulering, avgrensede/paginerte utganger, stabile {kode,melding} feil, og en idempotens-mønstertabell for les/opprett/oppdater/slett. Utløses når brukeren definerer verktøy for agenter, SDK-er, MCP-servere eller AI-native CLI-er.

Testrapport

Anvendelse av dens idempotens-tabell på et `delete_project`-verktøy forvandlet en bar 'slett og returner suksess'-baseline til et to-trinns bekreftelses + myk-sletting-design med et stabilt NOT_FOUND/CONFIRMATION_REQUIRED feilskjema — en konkret, sjekkliste-drevet forbedring over standard utgang.

Testet på: 2026-07-15 · Claude Code 2.x (agent harness)

Installer

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

Kommandoer og eksempelprompter

/agent-tool-contractsDesign agent/CLI-verktøyskjemaer, navngivning, feil og idempotens for LLM-kallere.

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):

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?

Full rapport →