tool-design

Draft tool descriptions with clear inputs and returns.

11|1|Updated Jul 5, 2010

Search Tags:#contracts #prompting #tool-design #apis

One-click install

npx skills add https://github.com/georgeguimaraes/dotfiles --skill tool-design-georgeguimaraes

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: tool-design
Source: https://github.com/georgeguimaraes/dotfiles/tree/main/dot_claude/skills/context-engineering/tool-design
Command: npx skills add https://github.com/georgeguimaraes/dotfiles --skill tool-design-georgeguimaraes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill provides principles for crafting effective tool interfaces that agents can discover, reason about, and reliably call.

Core Concepts

Consolidation: prefer one comprehensive tool over many overlapping ones
Tool Description Engineering: what, when, inputs, returns, errors
Namespacing and rollout: scalable tool organization
Response Format: balance verbosity and token efficiency

Quick Start

Review a sample tool and draft a description with clear inputs and returns.