tool-design

Design agent tool APIs with clear descriptions and consolidated architectures.

3|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/boazcstrike/opencode --skill tool-design-boazcstrike
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tool-design
Source: https://github.com/boazcstrike/opencode/tree/main/skills/tool-design
Command: npx skills add https://github.com/boazcstrike/opencode --skill tool-design-boazcstrike

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the challenges of designing effective tools for AI agents, ensuring clear contracts, reducing complexity, and improving agent interaction with deterministic systems.

Core Features & Use Cases

  • Tool API Design: Create robust and unambiguous tool interfaces for language models.
  • Consolidation Principle: Apply principles to simplify tool sets and reduce ambiguity.
  • Architectural Reduction: Explore minimalist tool architectures for greater flexibility.
  • Use Case: You are building a new AI agent and need to define the tools it can use to interact with your database. This Skill will guide you through creating clear, effective tool descriptions and API designs.

Quick Start

Use the tool-design skill to create a new tool description for an agent that needs to search for customer data.

Frequently Asked Questions about tool-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design tool APIs for AI agents to reduce ambiguity?

Design agent tool APIs by creating robust, unambiguous interfaces for language models. This involves applying the consolidation principle to simplify tool sets and reduce ambiguity, ensuring clear contracts between the agent and deterministic systems.

What is the consolidation principle in agent tool design?

The consolidation principle in agent tool design is a method to simplify tool sets and reduce architectural ambiguity. By applying this principle, you create minimalist tool architectures that offer greater flexibility and improve agent interaction with deterministic systems.

How do I write clear tool descriptions for AI agents?

Write clear tool descriptions by focusing on robust and unambiguous tool interfaces. Guide the design process by defining explicit tool contracts and optimizing response formats, ensuring the language model understands exactly how to interact with your deterministic systems.

What is the best way to handle error messages for agent tool recovery?

Handle error message design by creating clear feedback mechanisms for agent recovery. Optimize response formats and tool APIs to ensure that when an agent encounters an error, the deterministic system provides actionable feedback for the agent to recover and continue the task.

Does architectural reduction improve agent-tool interface flexibility?

Architectural reduction improves agent-tool interface flexibility by exploring minimalist tool architectures. Simplifying the tool set reduces complexity and ambiguity, resulting in more robust and efficient interfaces for language models to interact with deterministic systems.

When do I need to optimize response formats for agent tools?

Optimize response formats for agent tools when creating new tool APIs or refining existing ones. This optimization is needed to ensure robust and efficient interaction between the AI agent and deterministic systems, particularly when defining clear contracts and designing error messages.