Skip to content
Veritas
  • Nothing matches. Try the name of a library or a stack.

Titles, descriptions and sections of every skill.

create-veritas

The package is create-veritas. npm create, pnpm create and bun create run it without installing anything.

npm create veritas@latest my-app

Commands

create-veritas new <name>
Creates the project in ./<name> from the stack template (vite or nextjs), which ships inside the package, and writes .veritas/, AGENTS.md and CLAUDE.md. This is what npm create veritas@latest <name> calls.
create-veritas init
In the directory of an existing project: detects the stack from package.json, pyproject.toml, requirements.txt or manage.py, asks for confirmation and writes only .veritas/ plus a block in AGENTS.md and CLAUDE.md. The code is not touched.
create-veritas list
Lists the available conventions by scope and marks with [new] the ones that have a template for new.

The flags

Every question has a flag. In a terminal that is not interactive (CI, a script, an agent), a question without an answer is an error that names the flag to pass. Never a silent default.

FlagWhat it answers
--stack <vite|nextjs>The stack of the new project: React + Vite + TypeScript with Tailwind, or Next.js with the App Router.
--skills a,bUses exactly these conventions instead of the ones picked by the stack. Names come from create-veritas list.
--dir <folder>Where to write. With new, the default is ./<name>; with init, the current folder.
--yes, -yConfirms init without asking.
--no-installWrites the files and stops, without running install.
--lang <pt|en>Language of the CLI messages. The conventions stay in Portuguese.

Without --skills

You get the stack's skill, principios and lgpd. If the stack is front end or mobile, atomic-design, cores, tipografia-e-espacamento, direcao-de-arte, revisao-de-design and responsividade come too. With init, projeto-existente is added, which decides between keeping the project's architecture or remodelling it.

The whole command

This way it runs in CI or in the hands of an agent, without a single question:

npx create-veritas new my-app --stack nextjs --skills nextjs,principios,lgpd,atomic-design --dir apps/web --no-install
npx create-veritas init --yes

What gets written

FileWhat it is
.veritas/INDEX.mdOne line per installed convention, with the description that says when to use each.
.veritas/<skill>/The convention: the SKILL.md and the supporting files beside it, with the same text as the plugin.
.veritas/VERSIONThe version of create-veritas that wrote the folder.
AGENTS.mdA block between <!-- veritas:start --> and <!-- veritas:end --> telling the assistant to read INDEX.md before changing code. Read by Codex, Cursor, Copilot and others.
CLAUDE.mdThe same block, for Claude Code. Running again replaces the block instead of duplicating it, and the rest of the file stays as it was.

On Claude Code? The plugin brings the same skills, plus the process ones, without writing anything into the project. Get started →