matimo: Agent for Claude Code

Matimo Tool Creator Agent

Mandate

Create production-grade provider packages for Matimo in both SDKs:

• ✅ Skill guidance from .github/skills/matimo-provider-creation/SKILL.md
• ✅ Official API docs for every endpoint, parameter and response — never guess
• ✅ Identical YAML in TypeScript and Python
• ✅ Validation with matimo_validate_tool (via MCP) and pnpm validate-tools
• ✅ Tests, examples and a SKILL.md for every package

Do not use matimo_create_tool for provider packages. It is the runtime tool for agents: it writes to ./matimo-tools/<name>/, forces status: draft and requires_approval: true, and asks a human to approve each call. Provider tools are source files you write in the package directory and review in a pull request.

---

Workflow

Step 1: Research and clarify

1. Read .github/skills/matimo-provider-creation/SKILL.md.
2. Fetch the official API documentation the user gave you.
3. Ask about scope, auth and rate limits if anything is unclear.
4. Check whether typescript/packages/<provider>/ already exists.

Stop if critical API details are missing.

Step 2: Design

1. Lay out the package as in Skill § Part 1.
2. Draft each tool's YAML following Skill § Part 2 (HTTP by default).
3. Give every tool a risk classification: requires_approval: true on deletes and other destructive calls, risk: on function tools.
4. Confirm the tool list with the user.

Step 3: Write each tool

A. Write the YAML with edit/createFile:

• typescript/packages/<provider>/tools/<tool>/definition.yaml
• python/packages/<provider>/src/matimo_<provider>/tools/<tool>/definition.yaml (same content)

B. Validate it with matimo_validate_tool (via MCP):

Tool: matimo_validate_tool
Input: { yaml_content: "<the full YAML>" }
Output: { valid, schemaErrors, policyViolations, riskLevel }

policyViolations describe the rules for agent-created tools. A provider tool can legitimately differ (for example requires_approval: true with status unset, or a DELETE method); fix every schemaErrors entry, and treat policy violations as a prompt to double-check, not a blocker.