agentsclimarketplace

Agent tool contracts

Skill charlieviettq/awesome-agent-skill/.cursor/skills/ai-agent-systems/agent-tool-contracts

Curated skill pack for LLM agents in engineer and science workflow (Cursor & Claude ready).

Install
npx -y skills add charlieviettq/awesome-agent-skill --skill agent-tool-contracts

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 22 stars22 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Design agent tools and CLI surfaces—schemas, naming, errors, idempotency, and discoverability for LLM callers. Use when defining tools for agents, SDKs, or AI-native CLIs. Triggers: "tool schema", "agent tool", "function calling", "AI CLI".

SKILL.md

1.7 KB, as published. Nobody here has run it

Agent tool contracts

Tool design rules

  1. Verb-noun names — search_issues, create_draft_pr (not doStuff).
  2. Minimal parameters — fewer required fields; sensible defaults in description.
  3. Explicit side effects — "Creates...", "Deletes...", "Read-only" in description.
  4. Bounded output — paginate or truncate; return summary + pointer for large data.
  5. Stable errors — { "code": "NOT_FOUND", "message": "..." }.

Schema quality

  • Types and enums for categorical fields.
  • Examples in parameter descriptions.
  • Reject unknown enums at validation layer.

Idempotency and safety

OperationPattern
ReadSafe to retry
CreateIdempotency key or dedupe by natural key
UpdateVersion or ETag when concurrent edits possible
DeleteSoft delete or two-step confirm in description

AI-native CLI (when applicable)

  • --json for machine output; stable field names.
  • Exit codes: 0 success, non-zero with stderr message.
  • --dry-run for mutating commands.

Review checklist

  • Description tells the model when NOT to use the tool
  • Errors actionable (what to fix, not internal codes only)
  • No overlapping tools with ambiguous choice
  • Integration test with representative agent prompts

Related

mcp-builder for MCP-specific packaging; agent-evaluation for measuring tool accuracy.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.