Skip to content

phuryn/product-engineering / app-stack/skills/clerk-production

clerk-production

Verified

Setting 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.

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.
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall