bmad-spec

Converts intent input into structured SPEC kernels using Python scripts and YAML configurations.

Updated Dec 26, 2025
One-click install
npx skills add https://github.com/tiween/tiween --skill bmad-spec-tiween
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-spec
Source: https://github.com/tiween/tiween/tree/main/.agents/skills/bmad-spec
Command: npx skills add https://github.com/tiween/tiween --skill bmad-spec-tiween

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, yaml, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill distills any intent input into a SPEC kernel, a machine contract for downstream work, solving the problem of creating, validating, and updating machine-readable specifications.

Core Features & Use Cases

  • Intent to Spec Conversion: Converts vague ideas, brain dumps, and detailed documents into a structured SPEC kernel.
  • Spec Kernel Creation: Generates a five-field kernel (Why, Capabilities, Constraints, Non-goals, Success signal) and companion files for additional content.
  • Spec Updates: Allows multiple skills to update the same spec over time, ensuring consistency and preservation of the contract.

Quick Start

Use the bmad-spec skill to create a spec for a new project. Provide the intent or input document, and the skill will generate the SPEC.md file and any companion files.

Frequently Asked Questions about bmad-spec

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

FAQPage Schema
How do I convert a project intent document into a machine-readable specification?

A SPEC kernel is a machine contract for downstream work, structured around five core fields: Why, Capabilities, Constraints, Non-goals, and Success signal, ensuring consistent specification preservation and updates across multiple skills.

How do I create a validated specification kernel from a brain dump using YAML?

You create a validated specification kernel by providing your brain dump as intent input; the Skill applies YAML parsing and file manipulation to generate the SPEC.md file alongside any required companion files for additional content.

Do I need Python and YAML configurations to generate a SPEC.md file?

Yes, you need Python and YAML configurations to generate a SPEC.md file, as the Skill relies on YAML parsing and Python scripts to process intent input and output the structured specification kernel.

What is the best way to update a machine contract specification over time without breaking consistency?

The best way to update a machine contract specification without breaking consistency is using a Skill that allows multiple skills to update the same spec over time, applying validation to ensure preservation of the original contract.

What are the limitations of using Python scripts for specification generation?

Limitations of using Python scripts for specification generation include the strict dependency on YAML parsing and file manipulation for output generation, requiring correct YAML configurations to successfully create and update the machine contract.