tool-creator

Create Python tool modules for AnimaWorks with schemas, dispatch, and credentials.

253|42|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/xuiltul/animaworks --skill tool-creator-xuiltul
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tool-creator
Source: https://github.com/xuiltul/animaworks/tree/main/templates/ja/common_skills/tool-creator
Command: npx skills add https://github.com/xuiltul/animaworks --skill tool-creator-xuiltul

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a prescriptive workflow for authoring Python tool modules that integrate correctly with AnimaWorks, reducing integration errors and ensuring tools are discoverable, secure, and hot-reloadable.

Core Features & Use Cases

  • Interface compliance: Defines get_tool_schemas, dispatch or per-schema handlers, schema naming conventions, and optional EXECUTION_PROFILE for background-capable commands.
  • Integration patterns: Documents get_credential usage, ExternalToolDispatcher refresh semantics, personal vs shared tool locations, and how to share tools across Animas.
  • Security & deployment: Explains permissions.md requirements, delayed imports, timeouts for external APIs, and the background task submission flow for long-running jobs.

Quick Start

Create a new my_tool.py implementing get_tool_schemas and dispatch, save it under your anima's tools directory, and call refresh_tools to make it available.

Frequently Asked Questions about tool-creator

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

FAQPage Schema
How do I create a Python tool module for AnimaWorks?

To create a Python tool module for AnimaWorks, implement the get_tool_schemas and dispatch functions in a my_tool.py file, save it under your anima's tools directory, and call refresh_tools to make it discoverable and hot-reloadable.

What is the EXECUTION_PROFILE used for in AnimaWorks tool development?

EXECUTION_PROFILE is an optional configuration in AnimaWorks tool modules used for defining background-capable commands. It enables background task submission flow for long-running jobs, ensuring tools handle extended execution without blocking the main runtime.

How does credential lookup work when integrating external APIs in AnimaWorks tools?

Credential lookup in AnimaWorks tools uses the get_credential function during runtime to securely retrieve authentication data. This pattern ensures external API integration accesses sensitive information safely without hardcoding values in the Python module.

Can I share Python tools across multiple Animas?

You can share Python tools across multiple Animas by placing them in shared tool locations instead of personal directories. This allows different Animas to discover and use the same compliant modules during the ExternalToolDispatcher refresh process.

Why do my AnimaWorks tools fail the permissions check at runtime?

AnimaWorks tools fail permissions checks when the required permissions.md file is missing or incorrectly configured. Ensuring this file properly documents the tool's required permissions is mandatory for secure deployment and runtime access.