bmad-spec

Create and manage BMad specifications from PRDs, GDDs, RFCs, and briefs.

1|Updated Apr 27, 2026
One-click install
npx skills add https://github.com/peshay/portfolixir --skill bmad-spec-peshay
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-spec
Source: https://github.com/peshay/portfolixir/tree/main/.claude/skills/bmad-spec
Command: npx skills add https://github.com/peshay/portfolixir --skill bmad-spec-peshay

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill assists in the creation and management of BMad specifications, providing a structured way to document project requirements and goals.

Core Features & Use Cases

  • Spec Creation: Transform various input types into a BMad specification format, including PRDs, GDDs, RFCs, and briefs.
  • Companion Files: Generate companion files for content that doesn't fit the specification kernel, ensuring comprehensive documentation.
  • Spec Validation: Apply Spec Law rules to ensure the quality and completeness of the specifications.

Quick Start

Run the bmad-spec skill with the input text to generate a BMad specification.

Frequently Asked Questions about bmad-spec

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

FAQPage Schema
How do I create a BMad specification from a PRD or brief?

To create a BMad specification, provide your PRD, brief, or RFC as input text. The skill transforms these documents into a structured BMad specification format, generating both kernel and companion files for comprehensive documentation.

What are Spec Law rules for specification validation?

Spec Law rules are validation constraints applied to ensure the quality and completeness of your specifications. When you generate a BMad specification, the skill automatically validates the output against these rules to maintain documentation standards.

Can I use this skill to manage RFCs and GDDs alongside PRDs?

Yes, you can manage RFCs and GDDs alongside PRDs. The skill accepts various input types including Product Requirement Documents, Game Design Documents, and Requests for Comments to create standardized BMad specifications.

What is the best way to document project requirements that don't fit the specification kernel?

The best way to document overflow content is through companion files. When content doesn't fit the main specification kernel, the skill generates companion files to ensure all project requirements and goals are comprehensively captured.

How are the generated BMad specifications structured in the output folder?

Generated BMad specifications are output in a structured folder containing kernel and companion files. This organization separates the core specification logic from supplementary documentation, ensuring project requirements remain structured and accessible.