🎯

agent-tool-builder

🎯Skill

from hainamchung/agent-assistant

What it does

Designs precise AI tool interfaces with clear JSON schemas, descriptions, and error handling to ensure reliable agent interactions with external systems.

📦

Part of

hainamchung/agent-assistant(227 items)

agent-tool-builder

Installation

npm installInstall npm package

npm install -g @namch/agent-assistant

git cloneClone repository

git clone https://github.com/hainamchung/agent-assistant.git

Node.jsRun Node.js server

node cli/install.js install cursor # Cursor

Node.jsRun Node.js server

node cli/install.js install claude # Claude Code

Node.jsRun Node.js server

node cli/install.js install copilot # GitHub Copilot

+ 7 more commands

📖 Extracted from docs: hainamchung/agent-assistant

Need more details? View full documentation on GitHub →

1Installs

AddedFeb 4, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

"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"

Overview

# 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

Tool Schema Design

Creating clear, unambiguous JSON Schema for tools

Tool with Input Examples

Using examples to guide LLM tool usage

Tool Error Handling

Returning errors that help the LLM recover

Anti-Patterns

❌ Vague Descriptions

❌ Silent Failures

❌ Too Many Tools

Related Skills

Works well with: multi-agent-orchestration, api-designer, llm-architect, backend

More from this repository10

Skill

Develops high-performance C++ applications with modern C++20/23 features, template metaprogramming, and zero-overhead systems design.

🎯

senior-architect🎯Skill

Designs scalable software architectures using modern tech stacks, generating architecture diagrams, analyzing dependencies, and providing system design recommendations.

🎯

senior-frontend🎯Skill

Generates, analyzes, and scaffolds modern frontend projects using ReactJS, NextJS, TypeScript, and Tailwind CSS with automated best practices.

🎯

spec-miner🎯Skill

Extracts and documents specifications from legacy or undocumented codebases by systematically analyzing code structure, data flows, and system behaviors.

🎯

docs-seeker🎯Skill

Searches and retrieves technical documentation by executing intelligent scripts across library sources, GitHub repos, and context7.com with automated query detection.

🎯

writing-plans🎯Skill

Generates comprehensive, step-by-step implementation plans for software features with precise file paths, test-driven development approach, and clear task granularity.

🎯

file path traversal testing🎯Skill

Tests and identifies potential file path traversal vulnerabilities in code by analyzing file path handling and input validation mechanisms.

🎯

nodejs-best-practices🎯Skill

Guides developers in making strategic Node.js architecture and framework decisions by providing context-aware selection principles and modern runtime considerations.

🎯

red-team-tactics🎯Skill

Simulates adversarial attack techniques across MITRE ATT&CK framework phases, mapping network vulnerabilities and demonstrating systematic compromise strategies.