@appsforgood/next-supabase-kit 0.4.0 → 0.4.1

package/examples/next-supabase-installed/USER_GUIDE.md

@@ -1,6 +1,6 @@
 # User Guide
 
-How to use the agents and skills in this repo.
+How to use the agents and skills in this repo. Open **[USER_GUIDE.html](USER_GUIDE.html)** to read this as a designed page — that is the copy and layout to judge.
 
 **Agent** = who you ask. **Skill** = the workflow they follow. **Tool** = what they must use. For QA and UI, that tool is a **live browser plus screenshots**, not a file diff.
 
@@ -76,7 +76,7 @@ Files: `.antigravity/agent-kit/commands/*.toml`, `.antigravity/runtime-skills/*/
 | Is this done? | QA |
 | Landing / CTA words | Copy |
 
-Do not ask one chat to be all six.
+Do not ask one chat to be all six. Planner names the next specialist. It does not run the other agents.
 
 ## Which skill do I use?
 
@@ -87,14 +87,15 @@ Do not ask one chat to be all six.
 | `supabase-auth-rls` | Auth, RLS, service role |
 | `postgres-migrations` | Schema and migrations |
 | `owasp-security-review` | Mutations, uploads, secrets |
-| `frontend-design` | Layout, hierarchy, anti-generic UI |
+| `frontend-design` | Layout, simple palette, anti-generic UI |
 | `accessibility-wcag` | Keyboard, contrast, labels |
 | `browser-qa` | Any screen. Required for QA of UI |
 | `testing-qa` | Unit / regression / smoke only |
 | `product-copy` | Headlines and CTAs |
+| `deslop` | Last copy pass. Copy always runs this |
 | `ship` | Release, env, rollback |
 
-QA of a screen always uses `browser-qa`, not `testing-qa` alone.
+QA of a screen always uses `browser-qa`, not `testing-qa` alone. Each agent file names the skills it must run, then points at `catalog.json` for the rest.
 
 ## Standard workflows
 
@@ -118,7 +119,7 @@ Design + `frontend-design` + `browser-qa`. Desktop and mobile required. One happ
 
 ### Copy pass
 
-Copy agent reviews **rendered** screenshots, not just strings in TSX.
+Copy reviews **rendered** screenshots, not just strings in TSX. Run `product-copy`, then **`deslop` last**. Do not hand off after the first draft.
 
 ## QA screenshot loop
 
@@ -179,3 +180,4 @@ Pristine files refresh. Local edits win or land in `.agent-kit/conflicts/`. Do n
 | No browser in Copilot / Codex | Use the Playwright commands in `browser-qa`. |
 | QA finished from the diff | Reject it. Re-run with the good QA prompt above. |
 | `doctor` fails USER_GUIDE | The screenshot fail-closed sentence must stay in this file. |
+| Still have `QUALITY_GATES.md` / `COUNCIL.md` | Expected. `update` does not delete them. `doctor` lists leftovers. |

package/examples/next-supabase-installed/skills/deslop/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: deslop
+description: Use as the last copy pass. Strip AI-writing tells and leftover visual slop. Copy must run this after product-copy, not instead of it.
+---
+
+# Deslop
+
+Last pass. `product-copy` writes the words. This skill removes the machine accent.
+
+Scan 2026-09-06: `conorbronsdon/avoid-ai-writing`, `funboy322/avoid-ai-design`, `educlopez/ui-craft`, `superdesigndev/superdesign-skill`. Patterns only. Do not copy their catalogs.
+
+## Use when
+
+Copy is about to say “done,” or anyone asked to de-slop, humanize, or “make this less AI.” Always run after `product-copy` on public or conversion copy.
+
+## Order
+
+1. Finish `product-copy` (audience, headline, CTA, claims).
+2. Open the rendered surface if one exists.
+3. Run this skill. Fix words first. If the screenshot still reads as default AI UI, hand back to Design with the P0 list. Do not skip this step.
+
+## Writing tells — cut or rewrite
+
+| Tell | Fix |
+| --- | --- |
+| Chatbot openers (“Certainly!”, “Great question!”) | Delete. Start with the point. |
+| Inflators (seamless, robust, leverage, unlock, supercharge, 10x, paradigm) | Name the thing. “use,” “ships,” “blocks.” |
+| Copula dodge (“serves as,” “boasting,” “featuring”) | “is” / “has.” |
+| “It’s not X, it’s Y” | One positive sentence. |
+| Moreover / Furthermore / In today’s X / In conclusion | Cut or join with “and.” |
+| Vague experts / studies show | Cite or delete. |
+| Title Case Headings on every line | Sentence case. |
+| Em dash stacks, emoji headers, sparkle bullets | Periods. Real nouns. |
+| “Get started” / “Learn more” with no object | Say the next action. |
+| Placeholder leftovers (`[Your Name]`, `TODO copy`) | Fill or delete. |
+
+Second pass: re-read the rewrite. If the same tell remains, rewrite the paragraph, do not synonym-swap.
+
+## Visual P0s — fail if still on screen
+
+These are the 2026 convergence cluster. One is a smell. Two or more is a reject.
+
+- Purple-to-blue (or indigo) gradient hero, or gradient-clipped headline type
+- Inter / Roboto / default shadcn zinc as the whole identity
+- Centered slogan + two pills + three equal icon cards
+- `rounded-2xl` + `shadow-lg` + blur on every surface
+- Cream paper `#F4F1EA` + terracotta accent (the 2026 “editorial default”)
+- Acid green or neon vermilion on near-black used as decoration, not meaning
+- Lucide Sparkles / Zap as the product metaphor
+- Fake dashboard metrics or DiceBear avatars
+
+Copy does not restyle the page. It lists the P0s from the screenshot and sends them to Design.
+
+## Must keep
+
+Facts, commands, file paths, the fail-closed screenshot sentence, and any claim that has proof. Deslop is subtraction, not a new brand voice.
+
+## Done when
+
+- A second read finds no writing tells above.
+- If a screen exists, the screenshot was read and remaining visual P0s are named or gone.
+- Copy’s verdict is not “done” until this pass ran.

package/examples/next-supabase-installed/skills/frontend-design/SKILL.md

@@ -1,26 +1,107 @@
 ---
 name: frontend-design
-description: Use when building or reviewing user-facing UI. Prefer task-first screens. Reject generic AI-looking gradients, card soup, and fake metrics.
+description: Use when building or reviewing user-facing UI. Commit one simple palette and type pairing. Reject default AI layouts, timid color spreads, and decoration that is not the task.
 ---
 
 # Frontend Design
 
+Build or review a screen as if a stranger must name the product from the first viewport. Simple and specific beats decorated.
+
+Scan 2026-09-06 (structure only, no bodies copied): Anthropic `frontend-design` (updated 2026-06), addyosmani `frontend-ui-engineering`, `educlopez/ui-craft`, `funboy322/avoid-ai-design`, `superdesigndev/superdesign-skill`.
+
 ## Use when
 
-Screens, components, layout, visual design, or anti-generic UI review.
+Any user-facing layout, component, HTML page, or “it looks generic.” Required for `USER_GUIDE.html` and for app screens.
+
+## Ground in the subject
+
+Name the product, the user, and this screen’s job before CSS. Tokens come from the domain (materials, time of day, one real object) — not from a theme pack. A toy store and a ledger cannot share a palette.
+
+**This kit’s HTML** (`USER_GUIDE.html`): charcoal assignment desk.
+
+| Token | Value |
+| --- | --- |
+| Paper | `#10100e` |
+| Ink | `#eceae4` |
+| Frame | `#070706` |
+| Line | `#2a2823` |
+| Safelight | `#ff5a2a` (required / fail only) |
+| Pass | `#5ea37a` |
+| Type | `"Helvetica Neue", Helvetica, Arial, ui-sans-serif` |
+| Mono | `ui-monospace, Menlo, Consolas` |
+| Radius | `2px` |
+| Shadow | none |
+
+**Downstream Next.js apps:** do not paste the kit desk onto a product. Extract or invent **4–6 hex tokens** from *this* product’s job. Write them before CSS. Inside an existing design system, stay surgical — swap tells, do not invent a second brand.
+
+## Color — simple schemes that hold up
+
+One field, one ink, one accent, one line. That is enough.
+
+1. **Dominant field** (~80%): the page. Flat. Not a gradient, not a mesh.
+2. **Ink** (~15%): body text. Contrast ≥ 4.5:1 (3:1 for large type).
+3. **Accent** (~5%): one action or one required state. Recolor-as-decoration fails.
+4. **Line / well**: borders and code wells, one step off the field.
+
+Recipes (pick one that fits the product, then stop):
+
+| Scheme | Field | Ink | Accent | Use when |
+| --- | --- | --- | --- | --- |
+| Charcoal desk | `#10100e` | `#eceae4` | `#ff5a2a` | Tools, manuals, this kit |
+| Paper + ink | `#f4f4f1` | `#171717` | `#0b57d0` | Documents, settings, calm apps |
+| Night + signal | `#0e1116` | `#e6edf3` | `#3fb950` | Ops, status, pass/fail |
+| Warm shop | `#1c1916` | `#f3ece3` | `#e8a317` | Craft, commerce with real goods |
+
+Do not:
+
+- Spread six mid-chroma colors evenly.
+- Use purple→blue, default `blue-600`, or untouched shadcn `zinc` as the identity.
+- Use cream `#F4F1EA` + terracotta (the 2026 editorial default) unless the brief asks.
+- Use acid green or neon vermilion on near-black as decoration.
+- Treat Space Grotesk + slate, or any “tasteful” swap you used last week, as a new idea.
+
+Prefer CSS variables. Self-contained kit HTML: no Google Fonts, no CDN CSS.
+
+## Type
+
+One family, or two that are obviously different (display vs mono). Inter + system sans is not a pairing. Roboto, Space Grotesk, and “the last distinctive font you used” are second-order defaults.
+
+- Line length < 80 characters.
+- Tight display tracking on large sans. Do not italicize or recolor one word of a headline.
+- No tracked-out ALL-CAPS eyebrows, middle-dot meta (`A · B · C`), or `WORD — fragment` labels unless the content needs them.
+- Numbered tickets only when the content is a real sequence.
+
+## Layout
+
+- First viewport = the characteristic thing: command, table, form, named owner. Not a slogan over atmosphere.
+- Mobile (~390): the primary CTA still fits above the fold.
+- Hierarchy from size, weight, and space — not from cards.
+- Landing and marketing pages take a full direction. App chrome (settings, tables) stays quiet and dense.
+- Reject: centered hero + two pills + three icon cards; glass navbar; four-column empty footer; fake metrics; broadsheet hairlines + dense newsprint columns (that look is itself a 2026 default).
+
+## Motion
+
+None, or one moment that answers a click. Fade-and-slide on every section is generated. Respect `prefers-reduced-motion`.
+
+## Process
+
+1. Name the product, the user, and the job of this screen.
+2. Write the 4–6 tokens and one-sentence layout idea.
+3. Check the plan is not a 2026 default (cream editorial, neon-on-black decoration, SaaS card kit, newsprint desk, last week’s “tasteful” swap). If it is, change one axis: field, accent, or structure.
+4. Build. Spend boldness once. Remove one accessory.
+5. Screenshot desktop (~1280) and mobile (~390). Fix from pixels. Ask: would a stranger believe a person chose this?
 
 ## Checks
 
-- First screen shows the real product, task, or workflow.
-- Hierarchy, density, and primary action are obvious.
-- Loading, empty, error, disabled, success, and mobile states exist where relevant.
-- Contrast, focus, labels, and tap targets meet WCAG 2.1 AA.
-- Reject purple-blue gradient heroes, vague SaaS copy, fake dashboards, glass-card soup, and glow rails.
+- A stranger can name the product from the first screen.
+- Loading, empty, error, disabled, success exist where the flow has them.
+- Focus visible, tap targets usable.
+- Copy on the screen is real. If words are public-facing, Copy runs `deslop` last.
 
 ## Tools
 
-Critique from `browser` + `screenshot` + `image-review` first. Do not approve UI from TSX alone.
+`browser` + `screenshot` + `image-review` first. Do not approve UI from TSX or HTML alone.
 
 ## Done when
 
-Desktop and mobile screenshots were read. Blocker detector findings are fixed.
+Desktop and mobile images were read. Token list is in the change or in `DESIGN.md`. No P0 slop from `deslop` remains unless Design names it as an accepted exception.

package/examples/next-supabase-installed/skills/product-copy/SKILL.md

@@ -7,16 +7,48 @@ description: Use for headlines, CTAs, empty states, and conversion copy. Review
 
 ## Use when
 
-Landing pages, CTAs, positioning, onboarding, empty states, or pricing copy.
+Landing pages, CTAs, positioning, onboarding, empty states, pricing copy, or the public user guide (`USER_GUIDE.html`).
+
+## Audience
+
+Engineers and coding agents on a Next.js + Supabase repo who already have Cursor, Claude, Codex, Copilot, or Antigravity. They do not need a manifesto. They need to know **who to @**, **what to paste**, and **what “done” looks like**.
+
+## Positioning (this product)
+
+Name the specialist. Prove the screen. Six agents, twelve skills, five IDEs. QA is two screenshots, not a file diff.
+
+Do not describe this as an “agent operating system,” a copilot marketplace, or “AI-powered delivery.”
+
+## Voice
+
+Direct, specific, slightly dry. Prefer verbs: ask, paste, open, capture, reject.
+
+Use: specialist, owner, screenshot, desktop, mobile, fail-closed, paste, Planner, browser-qa.  
+Avoid: supercharge, seamless, unlock, copilot for X, 10x, enterprise-grade, magic, revolutionize.
+
+## Headline test
+
+If the headline could sell GitHub Copilot, Cursor, or any agent marketplace, rewrite it.
+
+Good: `Ask one specialist. Then open the running UI.`  
+Bad: `Supercharge your AI workflow with agents and skills.`
+
+## CTA test
+
+A CTA is a command or a pasteable prompt, not “Get started.”
+
+Good: `Paste this to Planner` followed by the plan prompt.  
+Good: `npx --yes @appsforgood/next-supabase-kit init --activate all`  
+Bad: `Start building today`.
 
 ## Checks
 
 - Audience, pain, and outcome are specific to this product.
-- Claims are backed or marked as assumptions.
+- Claims are backed or marked as assumptions. Do not invent user counts or “best-in-class.”
 - Headlines could not fit any competitor.
 - CTAs say what happens next.
-- Review the words on a screenshot for truncation and hierarchy.
+- Review the words on a screenshot for truncation, wrapping, and hierarchy. Copy that only exists in markdown is not approved for a public HTML page.
 
 ## Done when
 
-Copy is specific and the rendered screenshot shows the key line and CTA clearly.
+Copy is specific and the rendered screenshot shows the key line and CTA clearly on desktop and mobile. Copy then runs `deslop` as the last pass — this skill is not the end of the run.

package/examples/next-supabase-installed/tree.txt

@@ -11,6 +11,7 @@ AGENTS.md
 .antigravity/agent-kit/plugin.json
 .antigravity/runtime-skills/accessibility-wcag/SKILL.md
 .antigravity/runtime-skills/browser-qa/SKILL.md
+.antigravity/runtime-skills/deslop/SKILL.md
 .antigravity/runtime-skills/frontend-design/SKILL.md
 .antigravity/runtime-skills/nextjs-app-router/SKILL.md
 .antigravity/runtime-skills/owasp-security-review/SKILL.md
@@ -42,6 +43,7 @@ CLAUDE.md
 .cursor/rules/cursor-agent-kit.mdc
 .cursor/skills/accessibility-wcag/SKILL.md
 .cursor/skills/browser-qa/SKILL.md
+.cursor/skills/deslop/SKILL.md
 .cursor/skills/frontend-design/SKILL.md
 .cursor/skills/nextjs-app-router/SKILL.md
 .cursor/skills/owasp-security-review/SKILL.md
@@ -54,4 +56,5 @@ CLAUDE.md
 .github/copilot-instructions.md
 README.md
 tree.txt
+USER_GUIDE.html
 USER_GUIDE.md

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appsforgood/next-supabase-kit",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Agents, skills, and a user guide for Next.js and Supabase projects. QA reviews screenshots, not code alone.",
   "type": "module",
   "repository": {
@@ -29,6 +29,7 @@
     "skills",
     "assistant-adapters/cursor-agent-kit.mdc",
     "USER_GUIDE.md",
+    "USER_GUIDE.html",
     "examples/next-supabase-installed",
     "research/agent-skill-gap-report.md",
     "README.md",
@@ -100,7 +101,7 @@
     "@changesets/cli": "^2.31.0",
     "@eslint/js": "^9.39.4",
     "@types/node": "^25.9.3",
-    "@vitest/coverage-v8": "^4.1.9",
+    "@vitest/coverage-v8": "^4.1.11",
     "eslint": "^9.39.4",
     "eslint-config-prettier": "^10.1.8",
     "globals": "^17.7.0",
@@ -110,10 +111,11 @@
     "tsx": "^4.19.2",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.62.1",
-    "vitest": "^4.1.8"
+    "vitest": "^4.1.11"
   },
   "overrides": {
-    "esbuild": "0.28.1"
+    "esbuild": "0.28.1",
+    "vite": "6.4.3"
   },
   "allowScripts": {
     "better-sqlite3@12.11.1": true,

package/research/agent-skill-gap-report.md

@@ -124,5 +124,10 @@ Skills **kept despite being uncommon** in generic zoos:
 **Agents:** planner, app-engineer, security, design, qa, copy  
 **Optional agents:** lead-architect, docs, deploy, research  
 
-**Skills:** planning, nextjs-app-router, supabase-auth-rls, postgres-migrations, owasp-security-review, frontend-design, accessibility-wcag, browser-qa, testing-qa, product-copy, ship  
-**Optional skills:** ui-polish, docs, upgrade, debug  
+**Skills:** planning, nextjs-app-router, supabase-auth-rls, postgres-migrations, owasp-security-review, frontend-design, accessibility-wcag, browser-qa, testing-qa, product-copy, deslop, ship  
+**Optional skills:** ui-polish, docs, upgrade, debug
+
+### 2026-09-06 follow-up
+
+- Added `deslop` as a default skill. Copy’s end run is always `product-copy` then `deslop` (second pass on the rewrite). Patterns from `conorbronsdon/avoid-ai-writing` and `funboy322/avoid-ai-design` — catalogs not copied.
+- Uplifted `frontend-design` against Anthropic `frontend-design` (2026-06), `educlopez/ui-craft`, `superdesigndev/superdesign-skill`. Kit HTML keeps charcoal desk tokens. Downstream apps write 4–6 product tokens. Cream-editorial, neon-on-black decoration, SaaS card kits, and broadsheet newsprint are treated as 2026 defaults.  

package/skills/deslop/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: deslop
+description: Use as the last copy pass. Strip AI-writing tells and leftover visual slop. Copy must run this after product-copy, not instead of it.
+---
+
+# Deslop
+
+Last pass. `product-copy` writes the words. This skill removes the machine accent.
+
+Scan 2026-09-06: `conorbronsdon/avoid-ai-writing`, `funboy322/avoid-ai-design`, `educlopez/ui-craft`, `superdesigndev/superdesign-skill`. Patterns only. Do not copy their catalogs.
+
+## Use when
+
+Copy is about to say “done,” or anyone asked to de-slop, humanize, or “make this less AI.” Always run after `product-copy` on public or conversion copy.
+
+## Order
+
+1. Finish `product-copy` (audience, headline, CTA, claims).
+2. Open the rendered surface if one exists.
+3. Run this skill. Fix words first. If the screenshot still reads as default AI UI, hand back to Design with the P0 list. Do not skip this step.
+
+## Writing tells — cut or rewrite
+
+| Tell | Fix |
+| --- | --- |
+| Chatbot openers (“Certainly!”, “Great question!”) | Delete. Start with the point. |
+| Inflators (seamless, robust, leverage, unlock, supercharge, 10x, paradigm) | Name the thing. “use,” “ships,” “blocks.” |
+| Copula dodge (“serves as,” “boasting,” “featuring”) | “is” / “has.” |
+| “It’s not X, it’s Y” | One positive sentence. |
+| Moreover / Furthermore / In today’s X / In conclusion | Cut or join with “and.” |
+| Vague experts / studies show | Cite or delete. |
+| Title Case Headings on every line | Sentence case. |
+| Em dash stacks, emoji headers, sparkle bullets | Periods. Real nouns. |
+| “Get started” / “Learn more” with no object | Say the next action. |
+| Placeholder leftovers (`[Your Name]`, `TODO copy`) | Fill or delete. |
+
+Second pass: re-read the rewrite. If the same tell remains, rewrite the paragraph, do not synonym-swap.
+
+## Visual P0s — fail if still on screen
+
+These are the 2026 convergence cluster. One is a smell. Two or more is a reject.
+
+- Purple-to-blue (or indigo) gradient hero, or gradient-clipped headline type
+- Inter / Roboto / default shadcn zinc as the whole identity
+- Centered slogan + two pills + three equal icon cards
+- `rounded-2xl` + `shadow-lg` + blur on every surface
+- Cream paper `#F4F1EA` + terracotta accent (the 2026 “editorial default”)
+- Acid green or neon vermilion on near-black used as decoration, not meaning
+- Lucide Sparkles / Zap as the product metaphor
+- Fake dashboard metrics or DiceBear avatars
+
+Copy does not restyle the page. It lists the P0s from the screenshot and sends them to Design.
+
+## Must keep
+
+Facts, commands, file paths, the fail-closed screenshot sentence, and any claim that has proof. Deslop is subtraction, not a new brand voice.
+
+## Done when
+
+- A second read finds no writing tells above.
+- If a screen exists, the screenshot was read and remaining visual P0s are named or gone.
+- Copy’s verdict is not “done” until this pass ran.

package/skills/frontend-design/SKILL.md

@@ -1,26 +1,107 @@
 ---
 name: frontend-design
-description: Use when building or reviewing user-facing UI. Prefer task-first screens. Reject generic AI-looking gradients, card soup, and fake metrics.
+description: Use when building or reviewing user-facing UI. Commit one simple palette and type pairing. Reject default AI layouts, timid color spreads, and decoration that is not the task.
 ---
 
 # Frontend Design
 
+Build or review a screen as if a stranger must name the product from the first viewport. Simple and specific beats decorated.
+
+Scan 2026-09-06 (structure only, no bodies copied): Anthropic `frontend-design` (updated 2026-06), addyosmani `frontend-ui-engineering`, `educlopez/ui-craft`, `funboy322/avoid-ai-design`, `superdesigndev/superdesign-skill`.
+
 ## Use when
 
-Screens, components, layout, visual design, or anti-generic UI review.
+Any user-facing layout, component, HTML page, or “it looks generic.” Required for `USER_GUIDE.html` and for app screens.
+
+## Ground in the subject
+
+Name the product, the user, and this screen’s job before CSS. Tokens come from the domain (materials, time of day, one real object) — not from a theme pack. A toy store and a ledger cannot share a palette.
+
+**This kit’s HTML** (`USER_GUIDE.html`): charcoal assignment desk.
+
+| Token | Value |
+| --- | --- |
+| Paper | `#10100e` |
+| Ink | `#eceae4` |
+| Frame | `#070706` |
+| Line | `#2a2823` |
+| Safelight | `#ff5a2a` (required / fail only) |
+| Pass | `#5ea37a` |
+| Type | `"Helvetica Neue", Helvetica, Arial, ui-sans-serif` |
+| Mono | `ui-monospace, Menlo, Consolas` |
+| Radius | `2px` |
+| Shadow | none |
+
+**Downstream Next.js apps:** do not paste the kit desk onto a product. Extract or invent **4–6 hex tokens** from *this* product’s job. Write them before CSS. Inside an existing design system, stay surgical — swap tells, do not invent a second brand.
+
+## Color — simple schemes that hold up
+
+One field, one ink, one accent, one line. That is enough.
+
+1. **Dominant field** (~80%): the page. Flat. Not a gradient, not a mesh.
+2. **Ink** (~15%): body text. Contrast ≥ 4.5:1 (3:1 for large type).
+3. **Accent** (~5%): one action or one required state. Recolor-as-decoration fails.
+4. **Line / well**: borders and code wells, one step off the field.
+
+Recipes (pick one that fits the product, then stop):
+
+| Scheme | Field | Ink | Accent | Use when |
+| --- | --- | --- | --- | --- |
+| Charcoal desk | `#10100e` | `#eceae4` | `#ff5a2a` | Tools, manuals, this kit |
+| Paper + ink | `#f4f4f1` | `#171717` | `#0b57d0` | Documents, settings, calm apps |
+| Night + signal | `#0e1116` | `#e6edf3` | `#3fb950` | Ops, status, pass/fail |
+| Warm shop | `#1c1916` | `#f3ece3` | `#e8a317` | Craft, commerce with real goods |
+
+Do not:
+
+- Spread six mid-chroma colors evenly.
+- Use purple→blue, default `blue-600`, or untouched shadcn `zinc` as the identity.
+- Use cream `#F4F1EA` + terracotta (the 2026 editorial default) unless the brief asks.
+- Use acid green or neon vermilion on near-black as decoration.
+- Treat Space Grotesk + slate, or any “tasteful” swap you used last week, as a new idea.
+
+Prefer CSS variables. Self-contained kit HTML: no Google Fonts, no CDN CSS.
+
+## Type
+
+One family, or two that are obviously different (display vs mono). Inter + system sans is not a pairing. Roboto, Space Grotesk, and “the last distinctive font you used” are second-order defaults.
+
+- Line length < 80 characters.
+- Tight display tracking on large sans. Do not italicize or recolor one word of a headline.
+- No tracked-out ALL-CAPS eyebrows, middle-dot meta (`A · B · C`), or `WORD — fragment` labels unless the content needs them.
+- Numbered tickets only when the content is a real sequence.
+
+## Layout
+
+- First viewport = the characteristic thing: command, table, form, named owner. Not a slogan over atmosphere.
+- Mobile (~390): the primary CTA still fits above the fold.
+- Hierarchy from size, weight, and space — not from cards.
+- Landing and marketing pages take a full direction. App chrome (settings, tables) stays quiet and dense.
+- Reject: centered hero + two pills + three icon cards; glass navbar; four-column empty footer; fake metrics; broadsheet hairlines + dense newsprint columns (that look is itself a 2026 default).
+
+## Motion
+
+None, or one moment that answers a click. Fade-and-slide on every section is generated. Respect `prefers-reduced-motion`.
+
+## Process
+
+1. Name the product, the user, and the job of this screen.
+2. Write the 4–6 tokens and one-sentence layout idea.
+3. Check the plan is not a 2026 default (cream editorial, neon-on-black decoration, SaaS card kit, newsprint desk, last week’s “tasteful” swap). If it is, change one axis: field, accent, or structure.
+4. Build. Spend boldness once. Remove one accessory.
+5. Screenshot desktop (~1280) and mobile (~390). Fix from pixels. Ask: would a stranger believe a person chose this?
 
 ## Checks
 
-- First screen shows the real product, task, or workflow.
-- Hierarchy, density, and primary action are obvious.
-- Loading, empty, error, disabled, success, and mobile states exist where relevant.
-- Contrast, focus, labels, and tap targets meet WCAG 2.1 AA.
-- Reject purple-blue gradient heroes, vague SaaS copy, fake dashboards, glass-card soup, and glow rails.
+- A stranger can name the product from the first screen.
+- Loading, empty, error, disabled, success exist where the flow has them.
+- Focus visible, tap targets usable.
+- Copy on the screen is real. If words are public-facing, Copy runs `deslop` last.
 
 ## Tools
 
-Critique from `browser` + `screenshot` + `image-review` first. Do not approve UI from TSX alone.
+`browser` + `screenshot` + `image-review` first. Do not approve UI from TSX or HTML alone.
 
 ## Done when
 
-Desktop and mobile screenshots were read. Blocker detector findings are fixed.
+Desktop and mobile images were read. Token list is in the change or in `DESIGN.md`. No P0 slop from `deslop` remains unless Design names it as an accepted exception.

package/skills/product-copy/SKILL.md

@@ -7,16 +7,48 @@ description: Use for headlines, CTAs, empty states, and conversion copy. Review
 
 ## Use when
 
-Landing pages, CTAs, positioning, onboarding, empty states, or pricing copy.
+Landing pages, CTAs, positioning, onboarding, empty states, pricing copy, or the public user guide (`USER_GUIDE.html`).
+
+## Audience
+
+Engineers and coding agents on a Next.js + Supabase repo who already have Cursor, Claude, Codex, Copilot, or Antigravity. They do not need a manifesto. They need to know **who to @**, **what to paste**, and **what “done” looks like**.
+
+## Positioning (this product)
+
+Name the specialist. Prove the screen. Six agents, twelve skills, five IDEs. QA is two screenshots, not a file diff.
+
+Do not describe this as an “agent operating system,” a copilot marketplace, or “AI-powered delivery.”
+
+## Voice
+
+Direct, specific, slightly dry. Prefer verbs: ask, paste, open, capture, reject.
+
+Use: specialist, owner, screenshot, desktop, mobile, fail-closed, paste, Planner, browser-qa.  
+Avoid: supercharge, seamless, unlock, copilot for X, 10x, enterprise-grade, magic, revolutionize.
+
+## Headline test
+
+If the headline could sell GitHub Copilot, Cursor, or any agent marketplace, rewrite it.
+
+Good: `Ask one specialist. Then open the running UI.`  
+Bad: `Supercharge your AI workflow with agents and skills.`
+
+## CTA test
+
+A CTA is a command or a pasteable prompt, not “Get started.”
+
+Good: `Paste this to Planner` followed by the plan prompt.  
+Good: `npx --yes @appsforgood/next-supabase-kit init --activate all`  
+Bad: `Start building today`.
 
 ## Checks
 
 - Audience, pain, and outcome are specific to this product.
-- Claims are backed or marked as assumptions.
+- Claims are backed or marked as assumptions. Do not invent user counts or “best-in-class.”
 - Headlines could not fit any competitor.
 - CTAs say what happens next.
-- Review the words on a screenshot for truncation and hierarchy.
+- Review the words on a screenshot for truncation, wrapping, and hierarchy. Copy that only exists in markdown is not approved for a public HTML page.
 
 ## Done when
 
-Copy is specific and the rendered screenshot shows the key line and CTA clearly.
+Copy is specific and the rendered screenshot shows the key line and CTA clearly on desktop and mobile. Copy then runs `deslop` as the last pass — this skill is not the end of the run.

package/templates/next-supabase/AGENTS.md

@@ -27,4 +27,4 @@ Planner names the owner. Security joins auth/data/secret work. Design joins user
 
 ## Skills
 
-Default skills live in `.cursor/skills/*/SKILL.md` (and the matching Claude/Codex/Antigravity copies). QA of a screen always uses `browser-qa`, not `testing-qa` alone.
+Default skills live in `.cursor/skills/*/SKILL.md` (and the matching Claude/Codex/Antigravity copies). QA of a screen always uses `browser-qa`, not `testing-qa` alone. Copy finishes public words with `deslop`. Planner uses `planning` and names owners; it does not run the other agents. Each agent file points at `catalog.json` for the full skill list.