Scaffold
Skill robzilla1738/roberts-skills/plugins/scaffold/skills/scaffold
Greenfield or extend a Next.js app with Tailwind v4, tRPC, TanStack Query, optional Clerk, Neon/Drizzle, Vercel, and intake-selected add-ons (AI SDK, Resend, Stripe, Sentry, PostHog) fully installed and build-green. Use for /scaffold or new project setup.From its SKILL.md
npx -y skills add robzilla1738/roberts-skills --skill scaffoldAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- reads credentialsReads from 2 credential sources: `.env.local` and 1 more.
- 5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
6.5 KB, ~1.7k tokens by cl100k_base, as published. Nobody here has run it
Stack Scaffold
Workflow skill for greenfielding a Next.js + Tailwind v4 + tRPC + TanStack Query + Neon/Drizzle + Vercel app, with optional Clerk auth — driven by product intake so the foundation matches what you are building.
Read this hub first, run product intake, then open only the spokes for your profile.
Mission
Deliver a fully configured repo matching intake: core stack (Phases 0–8) plus every selected add-on installed and wired (Phase 9). No product business logic beyond integration demos/stubs. Phase 10 verification (typecheck, lint, test, build, smoke tests) must pass before the skill is complete.
Non-negotiables
- Product intake first — ask what you are building; record scaffold profile before
create-next-app. See intake-product-profiles.md. - App Router only — no Pages Router for new apps.
- Package manager — default
pnpm; pin Node22.xand pnpm>=10 <11unless intake saysnpm. - Environment —
lib/env.ts(Zod); secrets in.env.local; committed.env.example. No rawprocess.envinlib/elsewhere. - Server boundary — DB and tRPC routers are server-only;
import "server-only"where appropriate. - Safe tRPC errors —
AppError+ Zod mapped in formatter; never leak stacks. - Clerk on Next 16 —
proxy.ts+clerkMiddlewarewhen auth is enabled. - Lazy database —
getDb()must not throw at import time whenDATABASE_URLis missing. - Scaffold profile in README — record profile ID, stack choices, installed add-ons, and production-habits.md checklist.
- Intake add-ons are installed — when add-ons are not
none, run Phase 9 (phase-integrations.md); do not leave them README-only.
When to use
- Starting a SaaS dashboard, internal tool, or API-first Next app
- Adding tRPC + Drizzle + Clerk to an empty Next.js repo
- User invokes
/scaffold
When not to use
- Marketing-only → the web-marketing-landing skill
- Supabase / Prisma-first → custom plan (not default spokes)
- Expo / mobile-only → separate skill
- macOS / non-Next → out of scope
Intake router
| Profile | Summary |
|---|---|
saas-dashboard | Default — Clerk, full stack, shadcn, foundations |
internal-tool | Full stack; simpler shell; optional dev auth bypass |
api-first | tRPC + DB; minimal UI; auth optional |
marketing-only | Redirect web-marketing-landing |
extend-existing | Gap-fill only |
Details: intake-product-profiles.md.
Phase bundle
Execute in order. Details: phases-greenfield.md.
| Step | Spoke |
|---|---|
| 0 | intake-product-profiles.md |
| 1–2 | stack-and-tooling.md |
| 2b | foundation-env-and-errors.md |
| 2c | foundation-testing.md |
| 3 | foundation-ui.md + file-tree-and-conventions.md |
| 4 | database-neon-drizzle.md |
| 5 | trpc-and-query.md |
| 6 | auth-clerk-optional.md (if auth) |
| 7 | App shell — file-tree-and-conventions.md |
| 8 | vercel-and-env.md |
| 9 | phase-integrations.md + ai-sdk-and-integrations.md — skip only if add-ons = none |
| 10 | verification-checklist.md |
| post | production-habits.md — document remaining launch habits in README |
Skip phases per profile (e.g. api-first skips shadcn and often auth). Never skip Phase 9 when intake lists add-ons.
After Phase 10, recommend /review via the autoreview skill (/review).
Spoke index
| File | Contents |
|---|---|
| intake-product-profiles.md | Product question, profiles, intake template |
| intake-and-variants.md | Extend-existing, monorepo, out-of-scope |
| stack-and-tooling.md | Versions, create-next-app, scripts |
| foundation-env-and-errors.md | lib/env.ts, lib/errors.ts |
| foundation-testing.md | Vitest |
| foundation-ui.md | shadcn vs minimal |
| phases-greenfield.md | Phases 0–10 |
| phase-integrations.md | Phase 9 — install intake add-ons |
| file-tree-and-conventions.md | Canonical tree |
| database-neon-drizzle.md | Neon, Drizzle |
| trpc-and-query.md | tRPC server, client, route |
| auth-clerk-optional.md | Clerk |
| vercel-and-env.md | Deploy |
| verification-checklist.md | Build gate |
| production-habits.md | Post-scaffold checklist |
| ai-sdk-and-integrations.md | AI SDK streaming, Resend, Stripe, provider/env patterns |
Related skills
- the autoreview skill (
/review) - the web-marketing-landing skill
- clerk-auth (global) — deep Clerk patterns
Default stack
| Layer | Package / tool |
|---|---|
| Runtime | Node 22.x, pnpm 10.x |
| Framework | Next.js 16, React 19, TypeScript 5.9+ |
| CSS | Tailwind CSS 4 |
| API | tRPC 11, @trpc/tanstack-react-query, TanStack Query 5, superjson, zod |
| Testing | Vitest |
| Auth | @clerk/nextjs 7 (profile-dependent) |
| DB | Neon, Drizzle |
| Deploy | Vercel |
| AI (intake) | ai, @ai-sdk/react — Phase 9 |
| Email / billing (intake) | resend, stripe — Phase 9 |
| Observability (intake) | @sentry/nextjs, posthog-js — Phase 9 |
Verify latest minors on npm when scaffolding.
What ships with it: 17 files
71.2 KB alongside SKILL.md
- ai-sdk-and-integrations.md6.8 KB
- auth-clerk-optional.md6.5 KB
- database-neon-drizzle.md3.8 KB
- file-tree-and-conventions.md3.6 KB
- foundation-env-and-errors.md4.4 KB
- foundation-testing.md1.5 KB
- foundation-ui.md1.6 KB
- intake-and-variants.md1.3 KB
- intake-product-profiles.md4.9 KB
- phase-integrations.md9.1 KB
- phases-greenfield.md3.9 KB
- production-habits.md2.8 KB
- README.md2.0 KB
- stack-and-tooling.md3.8 KB
- trpc-and-query.md8.3 KB
- vercel-and-env.md3.9 KB
- verification-checklist.md3.0 KB