phenobarbital/antigravity-config/parrot-scaffold-tool

ai-parrot Tool Scaffold Skill

This skill automates the creation of standard AbstractTool implementations for the ai-parrot framework.

Guidelines

• Inheritance: Tools MUST inherit from AbstractTool (parrot.tools.abstract).
• Imports: Use relative imports for dependencies within parrot/tools/ (e.g., from .abstract import AbstractTool).
• Execution: Implement the async def _execute(self, ...) method.
• Return Value: The _execute method MUST return a ToolResult object.
• Schema: Arguments are defined using Pydantic models (ArgsSchema).
• Metadata: Tool name and description are defined as class attributes.

Instructions

1. Identify the Tool Name:

Extract the name of the tool the user wants to build (e.g., "StockPrice", "EmailSender").

1. Run the Scaffolder:

Execute the python script to generate the initial file in parrot/tools/.

``bash python scripts/scaffold_tool.py <ToolName> ``

1. Refine the Implementation:

After generation, edit the file in parrot/tools/<tool_name>.py:

• Update `args_schema`: Define the Pydantic model for arguments.
• Implement `_execute`: Add the actual logic. Ensure it handles exceptions and returns ToolResult.
• Add Docstrings: comprehensive docstrings for the class and methods.

Example Usage

User: "Create a tool to search Wikipedia."

Agent:

1. Runs python scripts/scaffold_tool.py WikipediaSearch
2. Edits parrot/tools/wikipedia_search.py to implement the logic.