skill-bill

Skill Bill

Hand Skill Bill a spec and get back a merge-ready PR — planned, implemented, stack-specialist-reviewed, audited against the spec, and quality-gated. AI coding agents are powerful but inconsistent: the same prompt yields different work every run, with no process holding it together. Skill Bill gives yours the structure of a real engineering process and runs it the same way every time, across whichever agents you use.

A /bill-feature-task run carrying a spec through every phase to a merge-ready PR — and because the run is interrupted mid-flight (usage limit, crash, lost connection) it also shows the part most demos hide: it resumes from durable workflow state and finishes, nothing lost. The demo is generated, not hand-recorded (docs/assets/generate_demo_gif.py), so it never goes stale.

Built with itself. Skill Bill's own features ship through this pipeline. #177 was planned, implemented, reviewed, and written up by the same process described here — click through and judge the actual output, not a demo.

Who it's for: developers and teams who want their AI agent to implement whole features with the rigor of a real engineering process — planned, reviewed, audited, and quality-gated — instead of one-off code they have to babysit and re-review. You still review the final PR; the point is that what reaches you was already planned, reviewed, and checked, not dumped on you raw. Probably overkill if you only want quick single-file completions. Pre-1.0 and solo-maintained.

Quickstart (≈60 seconds)

curl -fsSL https://raw.githubusercontent.com/Sermilion/skill-bill/main/install.sh | bash

Downloads and checksum-verifies the prebuilt runtime for your OS — no clone, no JDK, no Gradle. Needs only curl, tar, unzip, and either shasum or sha256sum on macos-arm64, macos-x64, windows-x64, or linux-x64.

Don't pipe a stranger's script straight into your shell? Read it first:

curl -fsSL https://raw.githubusercontent.com/Sermilion/skill-bill/main/install.sh -o install.sh
less install.sh   # it's a plain shell script — read it
bash install.sh

skill-bill version
skill-bill doctor
skill-bill update-check
skill-bill update

If skill-bill is not found, the launcher directory (~/.local/bin by default) isn't on your PATH. Add it — export PATH="$HOME/.local/bin:$PATH" — and put that line in your shell's rc file (~/.bashrc, ~/.zshrc, ~/.config/fish/config.fish).

Contributors or unsupported hosts: clone the repo and run ./install.sh --from-source (requires a JDK). Any host not in the four prebuilt targets falls back to this automatically.

Why it exists

AI coding agents don't follow a consistent process. The same prompt produces different work each run — sometimes it reviews thoroughly, sometimes it skims; sometimes it follows your conventions, sometimes it invents new ones; sometimes it finishes the feature, sometimes it wanders off. That is fine for a quick completion and a real problem for shipping a feature you have to stand behind.

Dropping skill files into ~/.claude/skills/ doesn't fix that — they're just prompts the agent can follow or skip, with nothing checking. Skill Bill runs a curated skill set as a structured, enforced process instead: a durable runtime that owns each feature run, a fleet of specialist subagents, contracts that fail loudly when skills drift, and the same skill set working across every agent. The skills carry the engineering judgment; the runtime makes the agent actually follow it on every run.

What you get

A feature implemented end-to-end from a spec — planning, implementation, stack-specialist review, completeness audit, and quality gates, all the way to a merge-ready PR. That is the headline. Everything else exists to make it reliable, repeatable, and yours: