phuryn/product-engineering / app-stack/skills/clerk-production
clerk-production
VerifiedSetting up or changing Clerk sign-in, organizations, roles or billing on Next.js, or sign-in that does nothing or lands wrong: Clerk in production.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 15.4 KB |
| receipts.md | markdown | 1.4 KB |
| references/authenticated-mile.md | markdown | 10.1 KB |
| references/csp-and-variables.md | markdown | 11.1 KB |
| references/gotchas.md | markdown | 14.5 KB |
| references/mcp-oauth.md | markdown | 4.7 KB |
| references/organizations-and-billing.md | markdown | 22.7 KB |
| references/sessions-and-front-door.md | markdown | 10.7 KB |
receipts.md
View on GitHub# clerk-production: receipts
Each heading is a rule from `SKILL.md`, with the case that taught it.
## Where Clerk's defaults or quickstarts contradict this skill, this skill wins.
- `Undated`: They were learned on Next.js (App Router, Next 16, where middleware is `proxy.ts`) + Clerk Core 3 (`@clerk/nextjs` v7) + Supabase + Netlify, building several products with coding agents. Among them were a live Q&A product with organizations, a moderator role and paid plans, and a monitoring product with paid plans and API tokens, named here only by kind.
## Authorization lives with the data, not in a path list.
- `2026-08-27`, building the first slice with sign-in and data.
## Never attach a feature to a Clerk permission.
- `2026-09-03`, building plans for a live Q&A product.
## Clerk's wording is not part of your contract.
- `2026-09-20`, a vendor rewording broke six specs at once.
## Read the gotchas before touching Clerk.
- `Undated`: Each failed silently, or looked like a different problem, the first time.
## The agent can make three setup changes through the Backend API.
- `2026-10-31`, an evals product made all three this way while its owner was away from the machine.
## A screenshot records intended configuration, not the live value.
- `2026-10-21` to `2026-10-24`, a monitoring product recorded its organization, sign-in and OAuth settings on both instances as read-backs.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |