add-tool

Scaffold Frood built-in tools with implementation, registration, and pytest tests.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/SalesTeamToolbox/frood --skill add-tool-salesteamtoolbox
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-tool
Source: https://github.com/SalesTeamToolbox/frood/tree/main/.claude/skills/add-tool
Command: npx skills add https://github.com/SalesTeamToolbox/frood --skill add-tool-salesteamtoolbox

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The add-tool skill eliminates the repetitive, error-prone work of creating a new Frood built-in tool by hand, ensuring the implementation, registration, and tests follow the project’s expected patterns.

Core Features & Use Cases

  • Interactive tool scaffolding: Collects tool name, description, parameter schema, and required ToolContext injections from you before generating code.
  • ABC-compliant Tool implementation: Produces a new tools/<tool_name>.py that follows the Tool interface with async execute() and ToolResult success/error handling.
  • Automatic registration + test creation: Guides you to add the tool to frood.py and generates a matching tests/test_<tool_name>.py to validate metadata and execution behavior.

Use Case: You need a new tool (e.g., my_tool) that calls an external API or performs a workspace operation; use this skill to generate the full built-in tool skeleton and a baseline test file in one go.

Quick Start

Ask for the add-tool skill and tell it the new tool name, one-line description, parameter list, and any ToolContext inputs it needs.

Frequently Asked Questions about add-tool

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

FAQPage Schema
How do I scaffold a new built-in tool that includes async execute logic and parameter schemas?

To scaffold a new built-in tool, you provide the tool name, description, parameter schema, and required ToolContext injections. The skill generates an ABC-compliant Python module with async execute returning ToolResult, then wires it into the tool registry.

How do I add a new tool to the Frood tool registry without manual wiring errors?

Adding a new tool to the Frood registry is automated by generating the tool implementation and guiding you to add the proper registration call in frood.py, ensuring the project's expected patterns are followed without repetitive manual wiring.

Can I automatically generate pytest tests for a new Python tool implementation?

Yes, you can automatically generate pytest tests for a new Python tool. The scaffolding process creates a matching tests/test_<tool_name>.py file that validates the tool name, description, parameter schema, and success or failure execution paths.

Does the generated tool implementation support ToolContext injection and async execute methods?

The generated tool implementation fully supports optional ToolContext injection and async execute logic. It produces a Tool ABC-compliant Python module where the async execute method handles ToolResult success and error states natively.

What is the best way to create a Frood tool skeleton that calls an external API?

The best way to create a Frood tool skeleton for external API calls is using an interactive scaffolding process. It collects your tool requirements upfront and generates the complete built-in tool skeleton alongside a baseline test file in one go.