newmindsgroup/ai-agent-skills-library/agent-tool-builder

Claude Code and agent skill by newmindsgroup/ai-agent-skills-library

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Tools are how AI agents interact with the world. A well-designed

Install

npx vskill@latest install newmindsgroup/ai-agent-skills-library/agent-tool-builder

SKILL.md

The same SKILL.md was published earlier as newmindsgroup/ai-agent-skills-library/agent-tool-builder.

Agent Tool Builder

Tools are how AI agents interact with the world. A well-designed tool is the difference between an agent that works and one that hallucinates, fails silently, or costs 10x more tokens than necessary.

This skill covers tool design from schema to error handling. JSON Schema best practices, description writing that actually helps the LLM, validation, and the emerging MCP standard that's becoming the lingua franca for AI tools.

Key insight: Tool descriptions are more important than tool implementations. The LLM never sees your code - it only sees the schema and description.

When to Use

  • User mentions or implies: agent tool
  • User mentions or implies: function calling
  • User mentions or implies: tool schema
  • User mentions or implies: tool design
  • User mentions or implies: mcp server
  • User mentions or implies: mcp tool
  • User mentions or implies: tool use
  • User mentions or implies: build tool for agent
  • User mentions or implies: define function
  • User mentions or implies: input_schema

Core Workflow

  1. Confirm the request matches this skill's trigger, scope, and risk profile.
  2. Use the topic map to identify the relevant pattern, checklist, or example before writing detailed guidance or code.
  3. Load references/full-guidance.md when implementation details, examples, anti-patterns, validation checks, or edge cases are needed.
  4. Apply only the relevant guidance instead of loading or repeating the entire reference by default.
  5. Verify the result against any validation checks, limitations, security notes, or platform constraints in the reference.

Topic Map

  • Principles
  • Capabilities
  • Scope
  • Tooling
  • Standards
  • Frameworks
  • Patterns
  • Tool Schema Design
  • Detailed Descriptions (Most Important)
  • Parameter Descriptions
  • Use Enums When Possible
  • Required vs Optional
  • Tool with Input Examples
  • Tool Error Handling
  • Return Informative Errors
  • Anthropic Tool Result with Error
  • Error Categories to Handle
  • Implementation Pattern

Reference Map

  • references/full-guidance.md preserves the complete original guidance, including examples and detailed edge cases.

Limitations

  • Use this skill only when the task clearly matches the scope described above.
  • Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
  • Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

Progressive Loading

Keep this SKILL.md as the compact routing and workflow entrypoint. Load the reference file only when the user task requires the deeper implementation material.

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
2
7-day trend score
10

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/newmindsgroup/ai-agent-skills-library/agent-tool-builder/badge)](https://verified-skill.com/skills/newmindsgroup/ai-agent-skills-library/agent-tool-builder)

Something wrong with this skill or its page? Tell us.