tool-creation

Guide YAML-driven Matimo tool creation and validation through the meta-tools workflow.

11|8|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/tallclub/matimo --skill tool-creation-tallclub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tool-creation
Source: https://github.com/tallclub/matimo/tree/main/typescript/packages/core/skills/tool-creation
Command: npx skills add https://github.com/tallclub/matimo --skill tool-creation-tallclub

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Designers and developers struggle to consistently create robust, policy-compliant tool definitions for Matimo. This skill provides a structured approach to building YAML tool definitions, enforcing naming conventions, authentication, validation, and lifecycle governance.

Core Features & Use Cases

  • YAML-driven tool definitions for runtime tools and SDK contributions.
  • Guidance through the meta-tools workflow: validate with matimo_doctor, create on disk, request approval, and hot-reload for production use.
  • Emphasis on completeness, security, logging, and error handling to ensure production-ready tooling.

Quick Start

Follow the matimo meta-tools workflow to craft a validated tool YAML and deploy it to the configured target directory.

Frequently Asked Questions about tool-creation

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

FAQPage Schema
How do I create and validate YAML tool definitions for the Matimo SDK?

To create and validate YAML tool definitions for the Matimo SDK, follow the meta-tools workflow: craft the YAML, validate it with matimo_doctor, use matimo_create_tool to write it to disk, request approval, and hot-reload for production use.

What does the matimo_doctor validation check for in a tool definition?

The matimo_doctor validation checks YAML tool definitions for strict naming conventions, authentication rules, parameter validation, and secure error handling to ensure your tools are production-ready and policy-compliant.

Can I use matimo_create_tool for both runtime agents and SDK development?

Yes, you can use matimo_create_tool for both runtime agents and SDK developers. It guides the YAML-driven tool creation lifecycle, covering definition generation, on-disk creation, approval, and hot-reload.

What is the lifecycle workflow for deploying a Matimo tool to production?

The Matimo tool lifecycle workflow involves creating a YAML definition, validating it with matimo_doctor, generating the tool on disk with matimo_create_tool, requesting approval, and utilizing hot-reload to deploy it for production use.

Why do my Matimo tools fail validation due to naming or authentication errors?

Matimo tools fail validation when the YAML definitions violate strict naming conventions or lack proper authentication. The skill enforces these policies, along with parameter validation and secure error handling, to ensure robust tooling.