Installation

Add the four skills, then install the dora CLI.

Add the four skills. Then assess this project, or ship a pocket agent.

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

dora scan lists the gaps in this project. dora fix applies the safe fixes. dora review --run runs the skill off, then on. A pocket agent ships the work that repeats.

Install the CLI when you want dora on PATH:

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

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.

Pull request check

name: dora
on: [pull_request]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
      - run: npm install @hacksmith/doraval
      - run: ./node_modules/.bin/dora review --quick --ci skills

Pass the folder that holds the skills you ship. A check of the whole repo also scores test fixtures and can exit 1.

--ci prints JSON and does not prompt. Exit 1 fails the check.

Quick Start · Skills · Run a pocket agent