matimo: Skill for Claude Code

Add a new Matimo provider package: $ARGUMENTS

If no provider specified, ask: which provider (e.g. LinkedIn, Stripe, Twitter/X), and which tools to include in the first release.

---

Step 1 — Check for existing WIP implementation

Look in typescript/packages/ first:

ls typescript/packages/

If typescript/packages/<name>/ exists, examine its tool YAML files. These can be adapted — they may just need schema fixes and Python executors added. Validate them: pnpm validate-tools.

If no existing implementation, scaffold from scratch (use packages/slack/ as the reference template).

---

Step 2 — Fetch official API docs

Use WebSearch / WebFetch to get the real API reference. Document:

• Base URL
• Authentication method (API key, OAuth2, Basic, Bearer)
• Rate limits
• Available endpoints — pick the highest-value ones for v1 (aim for 3–8 tools)

---

Step 3 — Create package directory structure

packages/<name>/
├── package.json
├── definition.yaml          # OAuth2 provider config (omit if API key auth only)
├── tools/
├── skills/
│   └── <name>/
│       └── SKILL.md
├── test/
│   ├── unit/
│   └── integration/
└── README.md

package.json:

{
  "name": "@matimo/<name>",
  "version": "0.1.0",
  "description": "<Provider> tools for Matimo",
  "type": "module",
  "files": ["tools", "skills", "README.md"],
  "peerDependencies": { "matimo": "workspace:*" },
  "devDependencies": { "@matimo/core": "workspace:*" }
}

Add to pnpm-workspace.yaml:

- "packages/<name>"

---

Step 4 — OAuth2 provider config (if OAuth2 auth)

packages/<name>/definition.yaml:

name: <name>-provider
type: provider
version: '1.0.0'
description: |
  <Provider> OAuth2 Provider Configuration
  Setup instructions here...

provider:
  name: <name>
  displayName: <Provider Name>
  oauth2:
    authorizationUrl: https://provider.com/oauth/authorize
    tokenUrl: https://provider.com/oauth/token
    scopes: [scope1, scope2]
  env:
    CLIENT_ID: <NAME>_CLIENT_ID
    CLIENT_SECRET: <NAME>_CLIENT_SECRET
    REDIRECT_URI: <NAME>_REDIRECT_URI