Get started · ~5 minutes

Install, run, download your spec.

specmaster is a Claude Code skill. It runs inside Claude Code and writes your PRD + spec as Markdown files you download.

1

Install

Clone it straight into your Claude Code skills directory:

git clone https://github.com/dubedad/specmaster ~/.claude/skills/specmaster

Then restart Claude Code (or open a new session) so it registers the skill.

2

Run it

In any project, start the skill:

/specmaster

It asks one question — which lane:

[M] MODERNIZE — a new thing / new way / new audience [I] IMPROVE — point it at an existing site, app, or doc

Then it interviews you briefly — only for intent (the problem, who it's for, scope, the outcomes). Everything else it generates. Prefer to pre-write the kickoff? Use the configurator →

3

Approve the gate

specmaster generates the full spec, validates it (quality + traceability + anti-vagueness), and shows you the PRD with a score and any findings. Review, then approve. It won't present a stale validation — if the spec changed, it re-validates first.

4

Download your files

Everything lands in one run folder as Markdown:

specs/<your-project>-<M|I>-<date>/
├─ PRD.md                 ← your spec (download this)
├─ requirements.ears.md   ← testable requirements
├─ acceptance/*.feature   ← Gherkin "done" criteria
├─ artifacts/             ← workflow, UX, UI, data model, logic model, ADRs
├─ VALIDATION.md
└─ MANIFEST.md

Open the folder, download PRD.md (and anything else you need). It's plain Markdown — read it, share it, or hand it to a build agent.

5

Build from it (optional)

The requirements.ears.md + acceptance/*.feature are a build contract. Hand them to any coding agent, or if you use the GSD toolchain:

ultraplan            # turn the spec into a plan
# or: /gsd-plan-phase --prd PRD.md
goal                 # build until the Gherkin scenarios pass
?

Good to know

  • Works standalone. No other skills required. If you have ba-*, pump-*, dama-*, gsd-*, bpmn-from-website, or prd-authoring installed, specmaster uses them as accelerators — otherwise it uses its inline method.
  • It runs in Claude Code, not a browser. Generating a real spec needs the agent, your files, and your tools — the website just helps you set up and frame the run.
  • Two lanes, one output. [M] interviews you; [I] captures an evidence-based baseline of the existing thing first, then specs the change.
  • Not showing up after install? Restart Claude Code — skills are registered at startup.

← Back to home