name: pracht-scaffold\nversion: 1.5.0\ndescription: |\nScaffold pracht code with the native generators (pracht generate route|shell|middleware|api), falling back to manual edits only when the CLI\nflags cannot express the requested shape.\nUse for \"scaffold\", \"generate a route\", \"create a new page\", \"add middleware\",\n\"add an API route\", \"create a shell\".\nallowed-tools:
Parse what the user wants to create and generate it with the CLI. Ask when\nsomething is ambiguous (render mode, shell assignment). Keep generated code\nminimal — only the exports they actually need — and finish by summarizing what\nwas created and how it was wired.
\npracht generate route --path /dashboard --render ssr\npracht generate shell --name app\npracht generate middleware --name auth\npracht generate api --path /health --methods GET,POST\nIf the CLI can express the request, do not reimplement the scaffold by hand.\npracht generate route covers this flag matrix:
| Flag | \nMeaning | \n
|---|---|
--path (required) | \nRoute path, e.g. /dashboard or /blog/:slug | \n
--render | \nssr (default), spa, ssg, or isg | \n
--shell | \nRegistered shell name (manifest apps only) | \n
--middleware | \nRegistered middleware names, comma-separated (manifest apps only) | \n
--loader | \nInclude a loader export | \n
--error-boundary | \nInclude an ErrorBoundary export | \n
--static-paths | \nInclude getStaticPaths (automatic for dynamic ssg/isg paths) | \n
--title | \nPage title for the head() export | \n
--revalidate | \nISG window in seconds (isg only, default 3600) | \n
--json | \nMachine-readable output | \n
generate shell and generate middleware take --name; generate shell --loader adds a shell loader export read in the shell with useShellData()\n(layout-level data such as the signed-in user). generate api takes\n--path and --methods. All subcommands accept --json — use it when another\nagent or tool consumes the output. When the pracht MCP server is registered\n(pracht dev-mcp), call the generate_route/generate_shell/generate_middleware/\ngenerate_api MCP tools instead of Bash: same behavior, structured results.
--shell/--middleware names must already be registered or the CLI errors.\nGenerate the shell or middleware first, then the route referencing it.pracht generate middleware --name _middleware scaffolds the root src/pages/_middleware.ts, which runs\non every page route (API routes are not wrapped). Other names error in pages\nmode, pure static exports cannot use request middleware, and generate shell\nstays manifest-only — pages apps add an _app.tsx to the directory they want\nit to wrap (src/pages/blog/_app.tsx registers pages:blog).generate capability works in both modes. Manifest apps get a capabilities\nregistry entry; pages apps auto-discover src/capabilities/, so the module\ndeclares its own name and no manifest is written. Pages agents and\nconstraints are named exports in src/pages/_app.config.ts.generate route also emits a Playwright smoke test in e2e/ when the app\nhas a Playwright setup (playwright.config.* or an e2e/ directory);\n--no-test skips it, --test forces it. The test imports\n@playwright/test — if that dependency is missing, follow the generator's\ninstall note before typechecking. Keep the test: it is the output-level proof\nthe route works.generate route inserts the\nroute(...) call into src/routes.ts (adding route/timeRevalidate\nimports as needed) and generate shell/generate middleware upsert their\nregistry entries. Do not re-edit the manifest after a successful run.| Kind | \nDirectory | \nKey exports | \n
|---|---|---|
| Route | \nsrc/routes/ | \nloader, head, Component, ErrorBoundary, getStaticPaths, search | \n
| Shell | \nsrc/shells/ | \nShell, loader (read with useShellData()), head, headers, Loading, ErrorBoundary | \n
| Middleware | \nsrc/middleware/ | \nmiddleware | \n
| API route | \nsrc/api/ | \nNamed method handlers (GET, POST, PUT, PATCH, DELETE) or one default dispatcher | \n
Render modes: \"ssr\" (default), \"ssg\" (static at build), \"isg\"\n(incremental static, revalidate: timeRevalidate(seconds) — import\ntimeRevalidate from @pracht/core), \"spa\" (client-only). Use Preact\nidioms: class not className, functional components, import type for\ntype-only imports.
Before and after scaffolding:
\npracht inspect routes --json / pracht inspect api --json to confirm\ncurrent wiring when the existing graph matters. pracht inspect needs the\npracht plugin in the vite config.src/routes.ts declares constraints:, respect them — e.g. put new\n/app/** routes behind the required middleware. Never delete or weaken a\nconstraint to make pracht verify pass; that is a policy change only the\nuser can approve.pracht typegen after adding or renaming routes in a typed-routes app\n(src/pracht-routes.ts / .d.ts), and include the generated files.pracht plan --write if the app commits .pracht/app-graph.json —\npracht verify fails on a stale snapshot.pracht verify.Only for shapes the CLI cannot express. Read the existing src/routes.ts first\nto pick up current shells, middleware, and structure.
Route — head() plus Component; add loader only when the route needs\nserver data (the CLI omits it unless --loader is passed), ErrorBoundary\nonly if requested, and getStaticPaths only for SSG/ISG routes with dynamic\nsegments:
import type { LoaderArgs, RouteComponentProps } from \"@pracht/core\";\n\nexport async function loader(_args: LoaderArgs) {\n return {/* loader data */};\n}\n\nexport function head() {\n return { title: \"Page Title\" };\n}\n\nexport function Component({ data }: RouteComponentProps<typeof loader>) {\n return <section>{/* route UI */}</section>;\n}\nShell — Shell({ children }: ShellProps) rendering {children}, plus an\noptional head(). Never render <html>, <head>, or <body>.
Middleware — wrap-around via next():
import { redirect, type MiddlewareFn } from \"@pracht/core\";\n\nexport const middleware: MiddlewareFn = async ({ context, request }, next) => {\n // `return next()` continues; returning any Response short-circuits, e.g.\n // `redirect(\"/path\", { request })`. Wrap `await next()` in try/catch/finally\n // for tracing.\n return next();\n};\nAPI route — one export per method the user needs (or a default export only\nwhen they want to branch on request.method manually), parsing bodies with\nrequest.json() / request.formData() and always returning a Response:
import type { ApiRouteArgs } from \"@pracht/core\";\n\nexport function GET({ params, url }: ApiRouteArgs) {\n return Response.json({/* response data */});\n}\nDynamic segments use bracket filenames: [id].ts, [...slug].ts. API routes\nare auto-discovered — no manifest entry.
For live server→client updates, use Server-Sent Events:\ncreateEventStream(request, { keepAlive: 15 }) from @pracht/core/server\nreturns { response, send, close } — return response, push with\nsend({ data, event?, id? }), and stop producing when send() returns false\n(client disconnected). Consume with useEventSource(url, { json: true }) from\n@pracht/core. Works on every adapter. For WebSockets use\nisUpgradeRequest(request) plus the per-adapter recipes in https://pracht.resynapse.dev/docs/adapters\n(Cloudflare: API route + Durable Object; Node:\nnodeAdapter({ configureServerFrom }); Vercel: unsupported — use SSE).
Manifest wiring, only for hand-created files:
\nroute(\"/path\", () => import(\"./routes/file.tsx\"), { id: \"name\", render: \"ssr\" }) call in the right group or at the top level.shellName: () => import(\"./shells/file.tsx\") in the shells record.mwName: () => import(\"./middleware/file.ts\") in the\nmiddleware record.Plain \"./routes/file.tsx\" strings work in place of the import functions.
$ARGUMENTS
\n","files":[{"path":"SKILL.md","sizeBytes":9225,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-10-19T21:18:12.508189Z","sha256":"120D36C96C1E5FEEDD7CE30EA0502B087394D658D58914B5B1103AEFA2A98778","sizeBytes":3859},"review":null,"source":{"repositoryUrl":"https://github.com/JoviDeCroock/pracht","path":"skills/pracht-scaffold","license":"MIT","commit":"8bcdd52989de3e97708e7f16221839d6313cfdac","subtreeSha":"914935DD361DC8F875B62164F32FC710982F9C6E2AA12259058771F6055348E7","lastSyncedAt":"2026-10-19T21:17:21.911347Z"},"reviewedAt":"2026-10-19T21:19:40.508131Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/JoviDeCroock/pracht/tree/main/skills/pracht-scaffold"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install jovidecroock-pracht@llmmart"},{"target":"git","command":"git clone https://github.com/JoviDeCroock/pracht.git"}]}