tool-specification

Define tool interfaces, discovery, and orchestration patterns for AI agents.

154|38|Updated May 4, 2026
One-click install
npx skills add https://github.com/kangarooking/system-prompt-skills --skill tool-specification
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tool-specification
Source: https://github.com/kangarooking/system-prompt-skills/tree/main/tool-specification
Command: npx skills add https://github.com/kangarooking/system-prompt-skills --skill tool-specification

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams define tool interfaces, discovery mechanisms, and orchestration patterns to empower AI agents to safely discover, select, and compose tools.

Core Features & Use Cases

  • Tool-definition formats (JSON Schema/XML/TypeScript) for scalable tool descriptions.
  • Permission gating with Prohibited/Explicit Permission/Regular for tool calls.
  • Discovery and grouping strategies to manage large toolsets and parallel execution.
  • Lifecycle management from discovery to execution to result handling, including error recovery.
  • Use Case: Build an agent that can automatically discover and call external tools with proper permissions.

Quick Start

Define a tool set for an agent, assign permissions, and specify a discovery plan.

Frequently Asked Questions about tool-specification

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

FAQPage Schema
How do I define tool interfaces for AI agents to handle nested delegation and large toolsets?

Tool interfaces for AI agents are defined using JSON Schema, XML, or TypeScript formats to create scalable descriptions. This enables agents to manage large toolsets, handle nested delegation, and execute parallel operations safely through structured definitions.

What is the best way to implement permission gating for AI agent function calling?

Permission gating for function calling is implemented by categorizing tool calls into Prohibited, Explicit Permission, or Regular tiers. This safety constraint mechanism ensures AI agents cannot execute sensitive operations without proper authorization during tool orchestration.

How does tool discovery work when an AI agent needs to select from many available tools?

Tool discovery works through specified grouping strategies that manage large toolsets for AI agents. These discovery mechanisms allow agents to automatically identify, select, and compose relevant external tools dynamically during execution rather than loading all definitions simultaneously.

How do I manage the lifecycle of tool execution from discovery to error recovery?

The tool execution lifecycle is managed by defining patterns that span discovery, execution, and result handling, including error recovery. This lifecycle management ensures continuous operation when AI agents call external tools and encounter execution failures.

Can I use this approach to build an agent that automatically discovers and calls external tools safely?

Yes, you can build an agent that automatically discovers and calls external tools safely by applying defined discovery plans and permission gating. This approach satisfies safety constraints while allowing autonomous tool selection and nested delegation in tool-rich scenarios.