Quick Start

Install the four skills, run review --quick, then fix until exit 0.

Run this loop after you install dora. You get Findings first, then mechanical fixes, then a clean Review.

Core workflow

# 1. Install ask-dora, review-with-dora, grilling-for-routine, writing-for-routine
npx skills add saif-shines/doraval

# 2. Review: structure + heuristics, no Judge
dora review --quick

# 3. Mechanical fix
dora fix . --yes

# 4. Judgment: read Brief, replace Authored SKILL.md
dora fix . --brief

# 5. Re-review until exit 0
dora review --quick

Exit 0 clean · 1 issues · 2 could not run.

If dora is not on PATH, use npx @hacksmith/doraval in place of dora.

Common commands

dora                         # short --help
dora review --quick          # Findings first, no LLM
dora review --quick --format json
dora scan                    # workspace map
dora fix . --yes             # mechanical only; no TTY
dora memory add "Never use default exports" --weight 8
dora conflicts --dry-run

Review quality

--quick is tiers 1–2 (structure + heuristics). No Judge.

dora review --quick .
dora review --quick ./path/to/skill-dir
dora review --all --quick --ci     # CI gate, no LLM
dora review --deep                 # require Judge

Tiers: Review tiers.

Fix

dora fix . --dry-run
dora fix . --yes                 # agents / CI
dora fix . --brief               # Judgment items; then replace

Mechanical issues apply with --yes. Judgment items do not. Re-run dora review --quick until exit 0.

Memory

dora memory add "Never use default exports" --weight 8
dora memory list
dora memory promote              # hard rules → AGENTS.md

Weights: 8+ hard · 5 default · 1–3 soft. Memory.

Common mistakes

Empty dora prints --help. It does not Scan. Use dora scan for a workspace map.
dora new and dora reconcile exit 2. Use dora skill new and dora conflicts --dry-run.

Commands