The Skeptral CLI.
The validation engine and the code generator, in your terminal. Read the pool, derive a build spec, and scaffold a runnable Next.js app. It runs today from the repo. Publishing to npm is the next step.
Eight commands. list, spec, scaffold, deck and seed work offline with no key. validate and init read with the local claude CLI, and they never fabricate a score, if they can't read, they say so. push needs your own GitHub token.
Validate
Score raw idea text, then read what already lives in the pool.Score raw text
skeptra validate "<idea text>"A quick LLM read of demand, feasibility, and moat, with a one-line kill-shot. A heuristic read, not a live-signal run. Needs the local claude CLI.
Read the pool
skeptra list [--limit N] [--survived]Print every idea: id, name, score, verdict. Filter to the survivors. Works offline, no key needed.
Validate, then build
the all-in-oneneeds claude CLIskeptra init "<idea text>"Score raw text and scaffold it if it lives. Refuses to scaffold a kill. Skips list and spec straight to a runnable app.
Build
Take a pooled idea-id from a brief to a runnable, seeded app.Derive the build spec
skeptra spec <idea-id> [--json]Turn a pooled idea into a written brief: data model, routes, auth, payments. Offline by default. If the local claude CLI is on your PATH, it enriches the spec, otherwise it falls back cleanly.
Generate the app
skeptra scaffold <idea-id> [--multi-tenant] [--brand NAME] [--push]Emit a runnable Next.js 15 app: App Router, a typed Drizzle schema, CRUD routes, and Stripe when the idea is paid. Add --multi-tenant for Postgres row-level security, --brand to white-label it, --push to commit and (with your GitHub token) push it. Offline.
Mock the data
skeptra seed <idea-id> [--out FILE]Write a seed file for the idea's schema. Clearly labelled placeholder rows, three per model, so you can run the app before you have real data. Offline.
Ship
Pitch it and push it. Your repo, your credentials.Build the seed deck
skeptra deck <idea-id> [--brand NAME] [--accent #HEX]Turn the idea into an eleven-slide seed deck (HTML, print to PDF). Traction and projections stay blank: we never fabricate a number. --brand white-labels it. Offline.
Push to GitHub
skeptra push <dir> [--repo NAME] [--private]Commit a scaffolded app and, with your own GITHUB_TOKEN set, create a repo and push it. No token? It commits locally and tells you to set one. We never push on our own credentials.
Honest about distribution.
The CLI is built and works today, you run it from the repo with skeptra <command> after a build. It is not yet published to npm, so npm install -g skeptra-cli won't work right now. Publishing is the next step. We'll say the day it lands, and not a day before.