Skill Catalog
This page is auto-generated by bin/generate-skill-docs.mjs from every skill under skills/*/SKILL.md. Do not edit by hand — regenerate with node bin/generate-skill-docs.mjs.
30 skills available.
| Skill | What it's for | Use case | Install | Deep dive |
|---|---|---|---|---|
| appium-attribute-waits | Documents the narrow, honest scope of waiting on native UI state in swarmdriver: NativeBase.waitForIsShown()/waitForIsNotShown() (base.ts:39-66) already wrap driver.waitUntil(), and the isShown()… | writing or updating a WDIO/Appium spec or page-object method that must wait on async native UI state — a spinner clearing, a busy accessibilityState settling, a screen transition finishing, a list finishing a refresh — before asserting against or interacting with the screen | skills add git@github.com:catesworks/next-starters.git --skill skills/appium-attribute-waits -g | Read more |
| appium-page-objects | Defines the class structure and locator/wait discipline for Appium/WDIO Page Object classes in 7 invariants: every page object extends the exported NativeBase (base.ts's file-local Base name is… | creating a new Appium/WDIO Page Object class, or expanding a stub one into a fully-locator'd, action-bearing page object | skills add git@github.com:catesworks/next-starters.git --skill skills/appium-page-objects -g | Read more |
| appium-testid-attributes | Instruments React Native components — screens, list items, and anything whose visible content depends on async loading, mutation, or disabled state — with disciplined accessibility-prop usage… | instrumenting a React Native component's accessibility props — accessibilityState.busy, accessibilityState.disabled, accessibilityValue, and similar — so it reliably reflects async loading, mutation, or disabled state for Appium-driven tests | skills add git@github.com:catesworks/next-starters.git --skill skills/appium-testid-attributes -g | Read more |
| appium-testid-catalog | Builds a single typed, bare testID catalog per feature area instead of scattering string literals across React Native components and WDIO specs. A shared registry helper builds a nested, as-const… | adding bare testID values for a new RN screen or feature area, or migrating hardcoded testID strings scattered across components and WDIO specs into a single typed catalog | skills add git@github.com:catesworks/next-starters.git --skill skills/appium-testid-catalog -g | Read more |
| auth-email-provisioning | Provisions the AWS SES + Terraform + Cloudflare + Turnstile infrastructure a domain needs before it can send branded auth email — SES identity (Easy DKIM) + MAIL FROM, IAM scoped by ses:FromAddress… | provisioning the AWS SES + Terraform + Cloudflare + Turnstile infrastructure a domain needs before it can send branded auth email, and pushing the resulting SMTP credentials + captcha secret into Supabase Auth's config — the infra/provisioning half of the auth-email pattern, not template authoring (that's the sibling skill auth-transactional-emails) | skills add git@github.com:catesworks/next-starters.git --skill skills/auth-email-provisioning -g | Read more |
| auth-org-onboarding | Scaffolds the auto-create-or-join-org-on-first-login flow that closes a real, independently-observed product gap: a brand-new signup with zero org membership hits a 403/no-access wall on every… | scaffolding the auto-create-or-join-org-on-first-login flow that closes the "new signup lands on a 403/no-access page because they have zero org membership" gap — a pre-existing product gap observed independently in multiple fleet repos (jobweave, work-loom, and others), not a one-off bug | skills add git@github.com:catesworks/next-starters.git --skill skills/auth-org-onboarding -g | Read more |
| auth-transactional-emails | The template-authoring half of the auth-email pattern — the counterpart to auth-email-provisioning (Terraform SES/DNS/Turnstile infra + SMTP/captcha config push). Encodes 7 invariants: the lead split… | authoring, compiling, or syncing the MJML/EJS transactional-email templates a branded app sends through Supabase Auth — the template-authoring half of the auth-email pattern, not infra/provisioning (that's the sibling skill auth-email-provisioning) | skills add git@github.com:catesworks/next-starters.git --skill skills/auth-transactional-emails -g | Read more |
| catesworks-repo-standards | Topic-dispatched conformance skill for the catesworks GitHub org, built from a RALPLAN-DR consensus plan (6 revisions, 7 independent adversarial reviews). Runs an org-wide baseline (verify-only Node… | assessing or bringing a catesworks org repo toward shared org-wide conventions — dispatched by the repo's real GitHub topics, not its name | skills add git@github.com:catesworks/next-starters.git --skill skills/catesworks-repo-standards -g | Read more |
| cinematic-scroll-site | Runs a full cinematic scroll-driven website build end to end for any business or idea: customer-language research, a Creative Director's Loop that designs the page before storyboarding the hero… | the user asks to build a website, landing page, cinematic site, scroll site, one-page site, or hero-video site for any business, product, brand, place, portfolio, or concept (plumber, lawyer, hotel, SaaS, coffee shop, design studio, anything) | skills add git@github.com:catesworks/next-starters.git --skill skills/cinematic-scroll-site -g | Read more |
| docker-ecr-caprover-migration | Migrates one repo's service onto a Docker image pushed to a private AWS ECR registry and deployed to a self-hosted CapRover box, which pulls the image itself. Codifies a real rollout — 20+ repos… | migrating one of this portfolio's services (web APIs, background workers, cron-shaped jobs) onto a Docker image in AWS ECR deployed to the self-hosted CapRover box — trigger on phrases like "move X to CapRover", "dockerize the API for X", "cut X over to CapRover", "deploy X to the Hostinger box", or any request naming a repo plus a CapRover app name (e.g. "hullkit-api", "dealnight-api") in the same breath | skills add git@github.com:catesworks/next-starters.git --skill skills/docker-ecr-caprover-migration -g | Read more |
| evidence-not-confidence | Documents when to build a multi-source evidence-scoring system (kind→weight→band→gate) versus when a single AI-inferred signal should just be honestly labeled with a trust class instead of dressed up… | a system needs to decide how much to trust an AI-extracted or AI-inferred fact before writing it to a record, applying it, or showing it to a user as verified — designing a "confidence score," a verification badge, a fact-corroboration step, or reviewing whether an existing one is trustworthy | skills add git@github.com:catesworks/next-starters.git --skill skills/evidence-not-confidence -g | Read more |
| fleet-port-audit | Audits and allocates local dev-server ports (WEB_PORT/API_PORT) and local Supabase port blocks (54N2x/55N2x) across a fleet of repos sharing one host. Companion to local-dev-stack, whose own… | auditing or allocating local dev-server ports (WEB_PORT/API_PORT) and local Supabase port blocks (54N2x/55N2x) across a fleet of repos that share one host — assigning a new repo its next free port pair and Supabase block, sweeping for collisions after a change, or investigating an EADDRINUSE / "port is already allocated" that doesn't match any known repo | skills add git@github.com:catesworks/next-starters.git --skill skills/fleet-port-audit -g | Read more |
| local-dev-stack | The operational half of an ENV-selected local+prod stack — the counterpart to runtime-env-config (which is the app-side loader + EnvProvider chain). Encodes 11 invariants (the 10th: verify a repo's… | standing up the operational local+prod stack for an ENV-selected app — the process orchestration and database/Supabase side that sits UNDER the app's env loader | skills add git@github.com:catesworks/next-starters.git --skill skills/local-dev-stack -g | Read more |
| mcp-tool-server | Scaffolds one MCP tool with four front doors over a single implementation: a core domain layer, a commander CLI adapter, a transport-agnostic server.ts, and one file per transport binding… | building or scaffolding an MCP tool that needs more than one front door — a CLI for humans and CI, a local stdio MCP server for coding agents, and a remote Streamable-HTTP MCP server for hosted callers — all over one shared core and one transport-agnostic server module | skills add git@github.com:catesworks/next-starters.git --skill skills/mcp-tool-server -g | Read more |
| mobile-expo-app | The Expo/React Native mobile companion to an ENV-selected Next.js+api stack — apps/mobile in the same pnpm workspace, Expo Router, sharing the SAME Supabase auth backend as apps/web (same… | standing up, developing, or shipping the Expo/React Native mobile companion to an ENV-selected Next.js+api stack — apps/mobile in the same pnpm workspace, Expo Router, sharing the same Supabase auth backend as web | skills add git@github.com:catesworks/next-starters.git --skill skills/mobile-expo-app -g | Read more |
| mobile-store-submission | The app-record/listing/review side of shipping an Expo/React Native app to the App Store and Play Store — distinct from mobile-expo-app, which covers the build/EAS/push side and only briefly touches… | submitting an Expo/React Native app (built via the local fastlane path from skills/mobile-expo-app) to the App Store or Play Store — the app-record/listing/review side, not the build side | skills add git@github.com:catesworks/next-starters.git --skill skills/mobile-store-submission -g | Read more |
| next-backend-quality-loop | A stack-aware backend quality grader for the Hono/Drizzle/Zod/Kubb/Supabase API side of these starters. Six lenses: build-test (runs typecheck/build/test and gates every other lens, so broken code is… | grading backend code in the Hono / Drizzle / Zod / Kubb / Supabase stack this repo's starters ship — request validation, OpenAPI contract drift, runtime env handling, database and RLS safety, and test coverage of new schemas and policies | skills add git@github.com:catesworks/next-starters.git --skill skills/next-backend-quality-loop -g | Read more |
| next-frontend-quality-loop | A stack-specialized frontend quality grader for the Next.js/React family these starters ship — App Router apps with a Kubb-generated React Query data layer, the runtime @cogs/config env layer,… | grading frontend code in the Next.js / React / TypeScript family used by this repo's starters — App Router apps, a Kubb-generated React Query data layer, the runtime @cogs/config env layer, Supabase, and the four Playwright testid/attribute conventions | skills add git@github.com:catesworks/next-starters.git --skill skills/next-frontend-quality-loop -g | Read more |
| playwright-attribute-waits | Provides the consumer-side helpers for waiting on data-/aria- state a component already exposes: a load-state gate that checks for a transient error flash before asserting ready, a close/unmount… | writing or updating a Playwright spec or page-object method that must wait on async UI state — a spinner clearing, a modal closing, an optimistic update settling, a search debounce resolving, a counter advancing after a destructive action — before asserting against or interacting with the page | skills add git@github.com:catesworks/next-starters.git --skill skills/playwright-attribute-waits -g | Read more |
| playwright-page-objects | Defines the class structure and selector/wait discipline for Playwright Page Object classes: a shared BasePage contract (route, constructor(page: Page), navigate()), get-accessor locators, and… | creating a new Playwright Page Object class, or expanding a stub one into a fully-locator'd, action-bearing page object | skills add git@github.com:catesworks/next-starters.git --skill skills/playwright-page-objects -g | Read more |
| playwright-testid-attributes | Instruments React components — Sheets, Dialogs, and async data tables — with data-/aria- attributes derived from the exact same state driving the render, so Playwright can assert on state… | authoring or editing a Sheet, Dialog, async data table, or any component whose visible content depends on async loading or mutation state, and it needs to be reliably testable with Playwright | skills add git@github.com:catesworks/next-starters.git --skill skills/playwright-testid-attributes -g | Read more |
| playwright-testid-catalog | Builds a single typed data-testid catalog per feature area instead of scattering string literals across components and specs. A shared createTestIdRegistry helper builds a nested, as-const catalog… | adding data-testid attributes for a new feature area, or migrating hardcoded testid strings scattered across components and specs into a single typed catalog | skills add git@github.com:catesworks/next-starters.git --skill skills/playwright-testid-catalog -g | Read more |
| prod-deploy | The prod half of an ENV-selected runtime-env stack (api→CapRover self-hosted, web→Vercel, DB→Supabase Cloud) — the counterpart to runtime-env-config (app-side loader/EnvProvider) and local-dev-stack… | doing the FIRST production deploy of an ENV-selected runtime-env stack — api→CapRover (self-hosted, image-backed from ECR), web→Vercel, DB→Supabase Cloud — where a git push alone does NOT bring prod up because secrets, DB migrations, and Supabase-cloud auth config are manual, per-env, one-time setup | skills add git@github.com:catesworks/next-starters.git --skill skills/prod-deploy -g | Read more |
| reveal-shot-prompts | Fills two AI-image prompt templates for a manual product-reveal pipeline: an explosion-shot prompt (deconstructed engineering visualization with internal parts and fluid dynamics against a solid… | the user wants to build an AI-generated product "reveal" video — a deconstructed/exploded engineering shot plus a cinematic assembled-to-exploded transition — and needs the prompt text filled in for pasting into image/video tools | skills add git@github.com:catesworks/next-starters.git --skill skills/reveal-shot-prompts -g | Read more |
| runtime-env-config | Wires runtime (not build-time) environment variables into a Next.js App Router app: env vars are read from process.env at request time with NO NEXT_PUBLIC_ prefix and are NOT baked into the build, so… | wiring runtime (not build-time) environment variables into a Next.js App Router app — layered .env files loaded by ENV stage (dev/test/staging/prod) via a dotenv+dotenv-expand loader, read from process.env at request time with NO NEXT_PUBLIC_ prefix and NOT baked into the build, snapshotted into a client EnvProvider so values can change across stop/start/restart, and fed into a Kubb-generated client's baseURL via setClientConfig plus auth headers via useAccessToken | skills add git@github.com:catesworks/next-starters.git --skill skills/runtime-env-config -g | Read more |
| scrollytelling-frames-site | Fills an antigravity-ready prompt that turns an already-extracted image-frame sequence (frame_0.webp -> frame_N.webp, e.g. from the sibling reveal-shot-prompts pipeline) into a scroll-linked HTML5… | an extracted image-frame sequence (a scrollytelling-ready set of frame_0.webp -> frame_N.webp stills, e.g. from the reveal-shot-prompts pipeline's ezgif frame-extraction step) needs to become a filled antigravity prompt for a scroll-linked canvas landing page | skills add git@github.com:catesworks/next-starters.git --skill skills/scrollytelling-frames-site -g | Read more |
| secret-scan-onboarding | Use when onboarding a new catesworks repo (or a new deploy target inside an existing repo) to the published-artifact secret-scan gate -- wiring the gitleaks+trufflehog CI job that scans build output… | onboarding a new catesworks repo (or a new deploy target inside an existing repo) to the published-artifact secret-scan gate -- wiring the gitleaks+trufflehog CI job that scans build output before signing/upload/deploy | skills add git@github.com:catesworks/next-starters.git --skill skills/secret-scan-onboarding -g | Read more |
| secrets-source-of-truth | Use when you need to find where a secret's authoritative value lives, add a new secret, rotate one, or wire a new platform (Render/Vercel/SSM/CapRover/GitHub Actions/mobile) into the 1Password-backed… | you need to find where a secret's authoritative value lives, add a new secret, rotate one, or wire a new platform (Render/Vercel/SSM/CapRover/GitHub Actions/mobile) into the 1Password-backed sync pipeline | skills add git@github.com:catesworks/next-starters.git --skill skills/secrets-source-of-truth -g | Read more |
| skill-channel-rollout | Replicates next-starters' own multi-channel skill distribution wiring (pnpm workspace + per-skill npm packages via Changesets, private-by-default with a committed public/private allowlist, a… | replicating next-starters' own multi-channel skill distribution pattern — pnpm workspace + per-skill npm packages via Changesets (private-by-default, allowlist-gated), a self-hosted Claude Code plugin marketplace, and CI to publish it — into ANOTHER repo in the fleet | skills add git@github.com:catesworks/next-starters.git --skill skills/skill-channel-rollout -g | Read more |
| uptime-monitor-onboarding | Turns a newly-deployed or freshly ECR-cutover service into one actually covered by UptimeRobot. Grew out of a real production incident where a shallow /health check (no DB call) stayed green through… | a service just went live (or was redeployed) on CapRover or Fly.io — especially cut over to an image-backed/ECR deploy — and needs UptimeRobot coverage, or when scaffolding a brand-new next-starters-based API | skills add git@github.com:catesworks/next-starters.git --skill skills/uptime-monitor-onboarding -g | Read more |