skmtc docs

Add a stock JSR-hosted generator to an existing SKMTC project.

When to use this

You want a stock generator's output as-is. If you'll need to modify the generator's behavior, see tutorial: cloning a generator instead.

Prerequisites

The skmtc CLI installed with --unstable-worker-options:
```
deno install --allow-read --allow-write --allow-net --allow-env --allow-run=deno,sh --allow-sys=homedir -g --unstable-worker-options -n skmtc jsr:@skmtc/cli
```
The flag is required so the per-project Worker can use Deno's Worker.deno.permissions API. Without it, skmtc generate fails at runtime with Unstable API 'Worker.deno.permissions'. If you already installed without the flag, rerun the install with -f.
A SKMTC project (run skmtc init <project> first if needed).
The generator's package name (e.g., @skmtc/gen-zod). See the stock generators catalog.

Steps

Find the generator on JSR

Stock generators live at @skmtc/gen-*. Browse the catalog or search JSR directly. Each generator's reference doc lists what it produces and what it composes with.

Run `skmtc install`

skmtc install @skmtc/gen-zod my-project

Optional: pin a version explicitly.

skmtc install @skmtc/gen-zod@^0.0.55 my-project

The CLI adds the import to .skmtc/<project>/deno.json#imports and updates the Deno lockfile. See install reference for the full command surface.

Verify the install

skmtc list my-project --json

The new generator should appear with source: "jsr" and a resolved version. Re-running skmtc generate will pick it up.

After install, generate once and inspect a representative output file. If the generator produces per-schema files (gen-zod, gen-typescript), look for src/generated/<Schema>.generated.ts. If it produces per-operation files (gen-msw, gen-tanstack-*), look for src/generated/<Tag>/<operation>.generated.ts.

Troubleshooting

"Generator not found on JSR" — Check the package name; the CLI normalizes @skmtc/gen-zod, jsr:@skmtc/gen-zod, and @skmtc/gen-zod@^0.0.55 to the same install. Typos surface as this error.
No output for the new generator — Run skmtc generate my-project --json | jq '.diagnostics'. The generator may have isSupported filters that skip your operations (e.g., gen-shadcn-form only handles POST/PUT/PATCH with object bodies).
Stale bundle warning — If the project has cloned generators, run skmtc bundle my-project after install. skmtc doctor flags this.

How to install a generator