mcpbeat Sign in

Agent Tool Builder Agent Skill

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 implementa

429 tokens
context cost
SKILL.md, read when the skill is used
7
files
plus reference files
0
copies elsewhere
how many repositories repackaged it
505
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI --skill agent-tool-builder

What comes with it

398 bytes besides the instruction
sub-skills/silent-failures.md
sub-skills/too-many-tools.md
sub-skills/tool-error-handling.md
sub-skills/tool-schema-design.md
sub-skills/tool-with-input-examples.md
sub-skills/vague-descriptions.md

The instruction itself

10 sections, as written by the author

Agent Tool Builder

You are an expert in the interface between LLMs and the outside world.

You've seen tools that work beautifully and tools that cause agents to

hallucinate, loop, or fail silently. The difference is almost always

in the design, not the implementation.

Your core insight: The LLM never sees your code. It only sees the schema

and description. A perfectly implemented tool with a vague description

will fail. A simple tool with crystal-clear documentation will succeed.

You push for explicit error hand

Capabilities

  • agent-tools
  • function-calling
  • tool-schema-design
  • mcp-tools
  • tool-validation
  • tool-error-handling

Patterns

🧠 Knowledge Modules (Fractal Skills)

1. Tool Schema Design

2. Tool with Input Examples

3. Tool Error Handling

4. ❌ Vague Descriptions

5. ❌ Silent Failures

6. ❌ Too Many Tools

Other skills for the same job

different authors, same section of the catalogue
Skill Creator
by anthropics
vendor ×12

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

8.3k tokens scripts
Skill Creator
by vercel-labs
vendor ×12

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.

4.5k tokens scripts
Skill Creator
by JayZeeDesign
×9

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.

2.9k tokens scripts
Dispatching Parallel Agents
by ZhanlinCui
×7

Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies

1.5k tokens
Template Skill
by JayZeeDesign
×7

Replace with description of the skill and when Claude should use it.

35 tokens
Writing Skills
by ZhanlinCui
×6

Use when creating new skills, editing existing skills, or verifying skills work before deployment

5.6k tokens scripts
Skill Development
by anthropics
vendor ×5

This skill should be used when the user wants to "create a skill", "add a skill to plugin", "write a new skill", "improve skill description", "organize skill content", or needs guidance on skill structure, progressive disclosure, or skill development best practices for Claude Code plugins.

5.7k tokens
Subagent Driven Development
by ZhanlinCui
×5

Use when executing implementation plans with independent tasks in the current session

2.5k tokens

How to use it

Copy the folder

Take dokhacgiakhoa/agent-tool-builder from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.