skillflow

Local-first agentic workflow orchestrator for engineering blueprints — plan any feature before touching code.

TL;DR quickstart

Requires Node.js ≥ 18

# 1. Install
npm install -g skillflow

# 2. Navigate to your git repo
cd my-project

# 3. Set up skillflow in the project
skillflow init

# 4. Plan a feature
skillflow run --name "My feature"

skillflow will interview you about the feature, then produce a full spec in docs/features/my-feature/ — CONTEXT.md, PRD.md, EDGE_CASES.md, PLAN.md, and GIT_STRATEGY.md.

Once the plan is ready, implement it:

skillflow implement --slug my-feature

If something goes wrong at any step, re-run npm install -g skillflow and try again. If a planning run was interrupted, use skillflow resume to pick up where you left off.

How it works

flowchart TD
    A([skillflow run --name]) --> B[Load .skillflowrc]
    B --> C[Load workflow]
    C --> D[grill-me\nDiscover feature context]
    D --> E[write-a-prd\nGenerate PRD.md]
    E --> F[edge-case-matrix\nGenerate EDGE_CASES.md]
    F --> G[prd-to-plan\nGenerate PLAN.md]
    G --> H[git-strategy\nGenerate GIT_STRATEGY.md]
    H --> I[(docs/features/slug/)]
    I --> J([skillflow implement --slug])
    J --> K[Dev harness\nClaude Code session]
    K --> L[(Code changes in repo)]

Each arrow is a call to the configured harness (default: Claude Code). You stay in the loop at every checkpoint — review, revise, or approve before the next step runs.

Installation

Global install (recommended)

npm install -g skillflow

Installs the skillflow binary globally. Works with any project.

Ephemeral — no install

npx skillflow <command>

Runs skillflow without a global install. Slower on first use (downloads on each invocation).

Local development / contributing

git clone [email protected]:Sa-ar/skillflow.git
cd skillflow
npm install
npm run build
npm link          # makes `skillflow` available globally from this clone

Node version

Node.js ≥ 18 is required. Check your version:

node --version

skillflow init

Sets up your project with default skills, workflows, and a .skillflowrc config file:

skillflow init          # project-level setup (copies skills + workflows)
skillflow init --global # write only ~/.skillflowrc (harness config, no files)
skillflow init --force  # overwrite existing files with bundled defaults

It is safe to run skillflow init more than once without --force — existing files are left untouched.

Docs

| Topic | File | |---|---| | Complete command reference (flags, examples, artifact locations) | docs/commands.md | | Configuration reference (all .skillflowrc keys) | docs/configuration.md | | Harness deep-dive (annotated script, invocation mechanics) | docs/harness.md | | Skills (directory layout, discovery, authoring) | docs/skills.md | | Workflows (step types, customization, composition) | docs/workflows.md | | Contributing (PR guide, tests, extension points) | CONTRIBUTING.md |