Use with your agent

Install the doraval skill with npx skills add, then JSON mode, exit codes, and CI.

Two pieces:

Piece	What it is
`dora` CLI	The engine — `npx @hacksmith/doraval` or install on PATH
doraval skill	Agent instructions so Claude / Cursor / etc. run that engine for you

You can always run the CLI by hand (Review my context). The skill is how the agent reaches for it without a paste every time.

Install the doraval skill

Uses the open skills CLI (not the dora binary):

npx skills add saif-shines/doraval

That installs the skill from this repo into your agent’s skill directory (e.g. .claude/skills/, .agents/skills/, host-specific paths). After that, when you author or edit a skill, plugin, rule, or agent config, the agent should load doraval and run dora (or npx @hacksmith/doraval if dora is not on PATH).

List / remove with the same CLI: npx skills list, npx skills remove ….

What the skill expects

dora review <path> --format json (or npx @hacksmith/doraval review <path> --format json)
Exit codes as truth: do not report done on 1 or 2
Mechanical fixes: dora fix <path> --dry-run, then dora fix <path> --yes
Judgment items: dora fix <path> --brief, hand-edit, re-review until exit 0

Agent sessions cannot answer TTY prompts — never bare interactive dora fix, reconcile, or memory promote.

Without the skill (paste)

Review my agent context with dora (npx @hacksmith/doraval). Fix mechanical issues with --yes. Do not say you're done until review exits 0.

Machine output

npx @hacksmith/doraval --format json
npx @hacksmith/doraval --ci
npx @hacksmith/doraval review --all --quick --ci
dora --capabilities          # if dora is on PATH

Flag	Meaning
`--format table\|json`	Output format
`--ci`	Machine mode (implies JSON)
`--cwd <path>`	Working directory
`--capabilities`	Emit command capability manifest

Exit codes

Code	Meaning
`0`	Clean
`1`	Issues found
`2`	Could not run (e.g. `--deep` with no judge)

CI example

npx @hacksmith/doraval review --all --quick --ci

Agent-ready fixes

npx @hacksmith/doraval fix --yes
npx @hacksmith/doraval fix --brief
npx @hacksmith/doraval fix --dry-run

Machine-readable docs

URL	Content
llms.txt	Compact index of every page
llms-full.txt	Full corpus Markdown
Any page + `.md`	Raw Markdown (e.g. `/commands/#review.md`)

Hooks

dora memory context --json --quiet