agent:tools
Tool Design
Guides the user through designing tools for AI agents. Based on "Principles of Building AI Agents" (Bhagwat & Gienow, 2025), Chapters 6, 10-11: Tool Calling, Third-Party Tools, and MCP.
When to use
Use this skill when the user needs to:
- Design the tool set for an AI agent
- Decompose complex operations into reusable tools
- Write tool schemas with clear descriptions
- Decide between custom tools, third-party integrations, and MCP
- Plan MCP server or client integration
Instructions
Step 1: Understand the Agent's Needs
Use the AskUserQuestion tool to gather context:
- What tasks does the agent perform? (list all actions)
More from ikatsuba/skills
spec:design
Technical Design - generates architecture diagrams, interfaces, and data flow based on requirements and chosen research solutions. Use when designing how a feature will be built.
18git:amend
Amend Commit - modifies the last commit with staged changes or new message
15spec:requirements
Requirements Analysis - gathers requirements through structured questions and produces a requirements document with testable acceptance criteria. Use when starting a new feature spec or documenting requirements.
14spec:tasks
Task Breakdown - generates an implementation plan with tracked tasks based on requirements and design documents. Use when breaking down a design into actionable work items.
14git:commit
Smart Commit - stages all changes and creates a conventional commit
13spec:do-all
Execute All Tasks - runs all pending tasks from the tasks document, with parallel subtask execution when safe
9