Skip to content
cogs
Menu

Product

The product

cogs is two things wearing one repo: a Claude Code Plugin of skills mined from production, and the shared auth, transactional-email and infra plane those skills describe.

The Plugin

One Claude Code Plugin named cogs, declared in .claude-plugin/marketplace.json, bundles all 7 Skills. Each Skill lives in skills/<name>/ as a SKILL.md (what Claude Code loads) and a metadata.json whose provenance abstract records where the pattern came from.

Five Skills also ship as their own npm package, @cogs/skill-<name>, generated from skills/ as a Skill mirror. config-lint and env-doctor are Sibling skills that stay plugin-only.

The typed data layer

Generated Kubb code compiles against two Seams: @cogs/fetch-client for HTTP transport and @cogs/react-query for TanStack Query. @cogs/kubb-transforms wires the generated output to them after each generation. The generated code is disposable; the Seams are stable.

Auth

@cogs/auth verifies JWKS tokens and resolves an Auth role on the Org role ladder (org:viewer < org:contributor < org:admin) or the ci:agent Machine role. @cogs/auth-events detects a New device sign-in and asks for the new_device_login email.

Transactional email

@cogs/emails holds the MJML/EJS Email templates and per-Brand theming. The private @cogs/send-service is the only holder of SES send credentials: it accepts signed /send requests for allowlisted Send events and also serves the Before-User-Created hook that rejects disposable email domains.

Infra and config sync

infra/ is Terraform, not an npm package: SES domain identities with DKIM and MAIL FROM, per-site IAM SMTP credentials, Cloudflare DNS and Turnstile widgets. The private @cogs/supabase-sync reconciles one uniform Supabase auth config to each Site’s project, with read-back verification.

Facts at a glance

Skills in the Plugin
7
Skills on npm
5 (@cogs/skill-*)
Other @cogs/* packages
24, of which 3 are private
npm registry
Public, @cogs scope, no auth token
Publishing
Changesets with npm trusted publishing (OIDC)
Email templates
9
Brands
15 across 3 Site families
Source repository
Private today

Install the plugin or a package

The plugin installs from the catesworks/cogs marketplace in Claude Code; the published @cogs/* packages install from npm with no auth token. There is no hosted service and no account.