Installation

Step 1 — npx skills add saif-shines/doraval. Then install the dora CLI if you want it on PATH.

1. Install the doraval skill (first step)

npx skills add saif-shines/doraval

This uses the skills CLI to install the doraval skill into your agent’s skill directory. After this, Claude, Cursor, Codex, Copilot, or Grok can load the checklist and run dora when you edit skills, plugins, rules, or agent config.

How the skill drives checks: Use with your agent.

2. Review context on your project

npx @hacksmith/doraval
# same engine the skill uses; after permanent install: dora

Review my context walks through the output.

3. Optional — put `dora` on PATH

After a permanent install, dora and doraval are the same binary. Not required if you are fine with npx @hacksmith/doraval (the skill falls back to that when dora is missing).

Homebrew (recommended, macOS)

brew tap saif-shines/tap && brew trust saif-shines/tap && brew install doraval

Upgrade later with brew upgrade doraval or dora update.

npm (cross-platform)

npm install -g @hacksmith/doraval

Ships a prebuilt binary per platform (macOS arm64/x64, Linux x64/arm64, Windows x64). Node ≥ 14.18.

Bun

bun add -g @hacksmith/doraval
# one-shot:
bunx @hacksmith/doraval

Alpine / musl

Platform binaries target glibc. On Alpine/musl, run from source with Bun:

bunx @hacksmith/doraval

Verify

# skill (skills CLI)
npx skills list

# CLI (after permanent install)
doraval --version
dora --version

Common mistakes

Skipped step 1: agents will not auto-load the doraval checklist until npx skills add saif-shines/doraval.
npx skills add fails: need network + a recent Node; retry the same command.
Global install succeeds but dora is missing: ensure your npm/Bun global bin directory is on PATH.
Alpine or musl hosts: use Bun (bunx / bun add -g), not the glibc platform binary.

Audit my agent context — skill + review only.
Quickstart — full tutorial.
Use with your agent — JSON, exit codes, CI.