Installation

Install the dora CLI, then add the four skills.

dora and doraval are the same binary.

npm install -g @hacksmith/doraval     # all platforms
brew install saif-shines/tap/doraval  # macOS
bun add -g @hacksmith/doraval         # Bun

# or try without installing
npx @hacksmith/doraval --version

Then:

npx skills add saif-shines/doraval    # four skills
dora review --quick                   # Findings, no LLM

Homebrew

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

npm

npm install -g @hacksmith/doraval

Prebuilt binaries: macOS arm64/x64, Linux x64/arm64, Windows x64. Node ≥ 14.18.

Bun

bun add -g @hacksmith/doraval
bunx @hacksmith/doraval

Alpine / musl

Platform binaries target glibc. Use Bun:

bunx @hacksmith/doraval

AI agent setup

npx skills add saif-shines/doraval

That add installs ask-dora, review-with-dora, grilling-for-routine, and writing-for-routine. Details: Skills.

Verify

dora --version
npx skills list

Common mistakes

dora missing after a global install: put the npm/Bun global bin on PATH.
Alpine/musl: use Bun, not the glibc binary.
npx skills add fails: need network and a current Node. Retry the same command.
Empty dora prints --help, not a Scan. Run dora scan for the workspace map.

Quick Start · Skills