bmad-spec

Transform project documentation into a standardized machine-readable spec kernel.

Updated May 22, 2026
One-click install
npx skills add https://github.com/JaronTam/SDONE --skill bmad-spec-jarontam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-spec
Source: https://github.com/JaronTam/SDONE/tree/main/.agents/skills/bmad-spec
Command: npx skills add https://github.com/JaronTam/SDONE --skill bmad-spec-jarontam

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, resolve_customization.py, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill turns intent inputs into standardized spec kernels and companions, enabling clear and efficient communication for downstream tasks.

Core Features & Use Cases

  • Input Transformation: Converts vague or multi-source inputs into a machine-readable spec kernel and companions.
  • Kernel Generation: Outputs a five-field kernel with Why, Capabilities, Constraints, Non-goals, and Success signal.
  • Companion Files: Includes optional companion files for additional detail, such as glossaries, diagrams, and editorial rules.
  • Interactive & Headless modes: Supports interactive guidance and headless operation for programmatic integration.

Quick Start

To create a new spec, use the command: bmad-spec create -i "input-description"

Frequently Asked Questions about bmad-spec

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

FAQPage Schema
How do I generate machine-readable software requirements from project documentation?

To generate machine-readable software requirements, you can distill inputs from PRDs and RFCs into a standardized spec kernel. This process outputs a five-field structure covering capabilities, constraints, and success signals for clear downstream communication.

What is a spec kernel and how does it structure software development intent?

A spec kernel structures software development intent into a standardized machine-readable format. It organizes inputs into five distinct fields: Why, Capabilities, Constraints, Non-goals, and Success signal, ensuring clear communication for downstream tasks.

Can I convert a Game Design Document into a standardized spec kernel?

Yes, you can convert a Game Design Document into a standardized spec kernel. The tool distills requirements from various project documentation formats, including GDDs, transforming vague inputs into structured machine-readable outputs.

Do I need Python to process specification kernels and companion files?

Yes, you need Python 3 to process specification kernels and companion files. Python execution is required for applying templates and resolving customizations during the transformation of intent inputs into the final machine-readable format.

How do I automate spec generation for programmatic integration?

To automate spec generation for programmatic integration, you can use the headless operation mode. This allows you to process inputs and generate spec kernels without interactive guidance, enabling seamless integration into automated pipelines.

What are the limitations of using generated spec kernels for project management?

A limitation of using generated spec kernels is that they focus strictly on five core fields, requiring optional companion files like glossaries and diagrams for additional detail. Complex project management documentation may need supplementary processing.