agent-tool-builder

agent-tool-builder is a skill for Claude Code, Codex from diegosouzapw/awesome-omni-skills. It costs 51 tokens per session (5,929 once invoked), scanned A, a copy of agent-tool-builder-v2, MIT.

A workflow skill for designing tools that AI agents use to interact with outside systems. It covers tool inputs, descriptions, validation, errors, and the MCP standard for connecting AI tools.

In plain words
What is it for?
Use it to design tool schemas, write clear tool descriptions, plan validation and error handling, and review MCP-based tools.
Why use it?
It helps make agent tools easier for models to understand and less likely to fail silently or use the wrong inputs.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions Codex; mentions Gemini CLI; mentions OpenCode.

Good fit Use it to design tool schemas, write clear tool descriptions, plan validation and error handling, and review MCP-based tools.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/diegosouzapw/awesome-omni-skills/agent-tool-builder
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add diegosouzapw/awesome-omni-skills --skill agent-tool-builder
Clone the repo
git clone --depth 1 https://github.com/diegosouzapw/awesome-omni-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for agent-tool-builder

README.md
[![agentmods](https://agentmods.dev/badge/skills/diegosouzapw/awesome-omni-skills/agent-tool-builder/github.svg)](https://agentmods.dev/skills/diegosouzapw/awesome-omni-skills/agent-tool-builder)
Your own site
<a href="https://agentmods.dev/skills/diegosouzapw/awesome-omni-skills/agent-tool-builder"><img src="https://agentmods.dev/badge/skills/diegosouzapw/awesome-omni-skills/agent-tool-builder/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for agent-tool-builder

Your own site · 80×15
<a href="https://agentmods.dev/skills/diegosouzapw/awesome-omni-skills/agent-tool-builder"><img src="https://agentmods.dev/badge/skills/diegosouzapw/awesome-omni-skills/agent-tool-builder.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 51 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 5,929 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin 91% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00051 $0.05929
Opus 5 $0.00026 $0.02965
Sonnet 5 $0.00010 $0.01186
Haiku 4.5 $0.00005 $0.00593

Measured 11d ago against content hash cb9d00ab38c1, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

agent-tool-builder scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

data = weather_api.fetch(location)
Origin

This is a copy

91% identical to agent-tool-builder-v2 — 18 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

skills/agent-tool-builder/SKILL.md · 816 lines

How it starts

The opening of the file, as written. The whole thing — 816 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Agent Tool Builder

Overview

This public intake copy packages plugins/antigravity-awesome-skills-claude/skills/agent-tool-builder from https://github.com/sickn33/antigravity-awesome-skills into the native Omni Skills editorial shape without hiding its origin.

Use it when the operator needs the upstream workflow, support files, and repository context to stay intact while the public validator and private enhancer continue their normal downstream flow.

This intake keeps the copied upstream files intact and uses the external_source block in metadata.json plus ORIGIN.md as the provenance anchor for review.

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.

Imported source sections that did not map cleanly to the public headings are still preserved below or in the support files. Notable imported sections: Capabilities, Scope, Tooling, Patterns, 1. Detailed Descriptions (Most Important), 2. Parameter Descriptions.

When to Use This Skill

Use this section as the trigger filter. It should make the activation boundary explicit before the operator loads files, runs commands, or opens a pull request.

  • 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

Operating Table

Situation Start here Why it matters
First-time use metadata.json Confirms repository, branch, commit, and imported path through the external_source block before touching the copied workflow
Provenance review ORIGIN.md Gives reviewers a plain-language audit trail for the imported source
Workflow execution SKILL.md Starts with the smallest copied file that materially changes execution
Supporting context SKILL.md Adds the next most relevant copied source file without loading the entire package
Handoff decision ## Related Skills Helps the operator switch to a stronger native skill when the task drifts

Read the full file on GitHub · 816 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago First seen · 816 lines · 51 tokens per session scan A cb9d00ab38c1

Subscribe to this mod's changes

agent-tool-builder is a skill published in the GitHub repository diegosouzapw/awesome-omni-skills (140 stars, last pushed 2mo ago), licensed MIT. It adds 51 tokens to every session and 5,929 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). It is 91% identical to agent-tool-builder-v2, differing in 18 lines, and is treated as a copy.

Related

Other skills, from other repositories

azure-communication-services

Expert knowledge for Azure Communication Services development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building ACS calling/chat apps, SMS/email senders, Teams interop…

MicrosoftDocs/Agent-Skills · 127 tokens

azure-api-management

Expert knowledge for Azure API Management development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when integrating APIM with AI backends, VNet/domains, OAuth/Entra ID…

MicrosoftDocs/Agent-Skills · 121 tokens

azure-cognitive-search

Expert knowledge for Azure AI Search development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when designing indexes, skillsets, indexers, vector/semantic search, or secure data…

MicrosoftDocs/Agent-Skills · 116 tokens

azure-functions

Expert knowledge for Azure Functions development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when wiring Functions to triggers/bindings, Cosmos/SQL/Service Bus, VNet/private…

MicrosoftDocs/Agent-Skills · 122 tokens

azure-logic-apps

Expert knowledge for Azure Logic Apps development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building Logic Apps with Azure/OpenAI, SAP/B2B, on-prem connectors, CI/CD…

MicrosoftDocs/Agent-Skills · 116 tokens

azure-event-grid

Expert knowledge for Azure Event Grid development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, and integrations & coding patterns. Use when configuring Event Grid/MQTT namespaces, securing endpoints, routing events, integrating…

MicrosoftDocs/Agent-Skills · 121 tokens