matimo: Skill for Claude Code

Matimo Provider Creation — TypeScript & Python

This skill teaches the comprehensive workflow for creating production-grade provider packages in both TypeScript and Python SDKs with identical patterns and full Matimo tool integration.

Quick Reference: Agent Tool Mapping

Never use matimo_create_tool for a provider package. It is the runtime meta-tool for agents: it writes ./matimo-tools/<name>/definition.yaml, forces status: draft and requires_approval: true, and asks a human before it runs. A draft only runs for the admin role, so a provider tool written this way would not work for users.

Part 1: Universal Provider Structure

TypeScript Provider Package

typescript/packages/{provider}/
├── package.json                              # {"name": "@matimo/{provider}", "type": "module"}
├── definition.yaml                           # OAuth2 provider config (if OAuth2)
├── README.md                                 # Usage guide, examples, auth setup
├── tools/
│   ├── {tool-1}/
│   │   └── definition.yaml                   # HTTP tool: YAML only
│   └── {tool-2}/
│       ├── definition.yaml                   # Function tool: code: ./{tool-2}.js
│       └── {tool-2}.ts                       # compiled to {tool-2}.js by the package build
├── skills/
│   └── {provider}/SKILL.md                   # Agent knowledge document
└── test/
    ├── unit/
    │   └── {tool-1}.test.ts
    └── integration/
        └── {provider}-tools.test.ts