Skip to main content

What is cogs?

cogs is two things wearing one repo:

  1. 5 Claude Code skills, distributed as a single plugin — each one encoding a pattern mined from real production code (URL state, typed API layers, editable data tables, forms), not generic framework advice.
  2. The @cogs/* npm packages those skills describe — auth, transactional email, a React Query seam, a typed fetch client, and more — the actual libraries you'd import if you're not using Claude Code at all.

You don't need both. Pick the one that matches how you work.

Using cogs skills in Claude Code​

If you're working in Claude Code, install the plugin once and the 5 skills activate automatically whenever your prompt matches their trigger conditions — no manual invocation, no copy-pasting snippets.

/plugin marketplace add catesandrew/cogs
/plugin install cogs@cogs

See Getting Started for the full install flow, and the Skills Catalog for what each of the 5 skills covers and why it was built.

Using @cogs npm packages​

If you're not using Claude Code, the same patterns ship as regular npm packages under the public @cogs scope:

pnpm add @cogs/auth-events @cogs/emails @cogs/react-query

See Usage Examples for three concrete integration paths, and Architecture for how the packages, skills, and this repo's release pipeline fit together.

:::note Private repository cogs is currently a private GitHub repository. Installing the Claude Code plugin via marketplace add requires access to catesandrew/cogs — reach out if you need it. :::