bmad-spec

Distills ideas, PRDs, and transcripts into a five-field SPEC.md contract with companion files.

Updated Mar 1, 2026
One-click install
npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-spec-hexalith
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-spec
Source: https://github.com/Hexalith/Hexalith.Parties/tree/main/.agents/skills/bmad-spec
Command: npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-spec-hexalith

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Raw intent inputs like brain dumps, meeting transcripts, PRDs, and customer emails are unstructured and inconsistent, making them unreliable inputs for downstream planning and implementation work. This Skill condenses any such input into a canonical SPEC.md contract with a stable five-field kernel (Why, Capabilities, Constraints, Non-goals, Success signal) that downstream skills and agents can consume without ambiguity. ## Core Features & Use Cases - Spec distillation: Transforms any intent input into SPEC.md plus content-typed companion files (glossaries, diagrams, entity catalogs), preserving every load-bearing claim. - Append-only memory log: Records every decision, capability, and assumption in .memlog.md and re-derives SPEC.md from it, so updates never cause merge drift and capability IDs stay stable. - Validation and story breakdown: Self-validates each spec against eight Spec Law rules and can break a spec into a stories.yaml file of independently shippable slices. - Use Case: Paste a messy Slack thread about a new feature and receive a spec folder containing SPEC.md, a glossary companion, and a validated capability list ready for PRD, UX, or architecture skills. ## Quick Start Ask the assistant to distill the attached product brief into a spec using the bmad-spec skill.

Frequently Asked Questions about bmad-spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a PRD or meeting transcript into a structured spec?

Provide the file or pasted content as input and the skill distills it into SPEC.md with five fields: Why, Capabilities, Constraints, Non-goals, and Success signal. Load-bearing overflow content is routed into companion files like glossaries or diagram documents.

What is the five-field spec kernel format?

The kernel consists of Why, Capabilities (each with intent and success criteria), Constraints, Non-goals, and a concrete Success signal. Every capability gets a stable CAP-N identifier that is never reused or renumbered across updates.

Can I update an existing spec without losing capability IDs?

Yes. Invoking the skill with the same slug targets the existing spec folder and updates it in place. The append-only .memlog.md is the authority on prior decisions, so existing CAP-N identifiers are preserved and new capabilities get the next unused number.

Does the skill work in headless or programmatic mode?

Yes. When invoked without a TTY or by another skill, it runs headless and returns a JSON response listing the files written, or a blocked status with an error_code such as insufficient_intent or missing_slug.

When should I use a PRD skill instead of spec distillation?

When the input is too thin to distill, such as a one-line idea with no surrounding context, the skill stops and suggests a PRD-style elicitation skill instead. It distills existing intent rather than coaching new vision out of the user.