Tool Schema Design · seb1n/awesome-ai-agent-skills

Design clear, safe schemas for AI and MCP tools

Helps write model-facing tool definitions with clear names, bounded parameters, explicit side effects, and safe defaults, useful when building function-calling or MCP tools or fixing wrong tool selection and unsafe calls.

Good for

  • Write a clear description for a function-calling tool
  • Bound JSON parameters with enums, limits, and defaults
  • Split an overloaded tool into distinct actions
Category
Design

Open-source skills are maintained by their authors and listed as published, with attribution. Results depend on how well the skill fits your task and material.

A good place to start

Help me write a clear parameter schema and side-effect contract for this MCP tool so the model doesn't misuse it.

Make your next great thing.

Bring a question, a file, or an idea that’s not quite there yet.