generate-spec

Generate functional specification documents from Breeze functional graphs.

2|2|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/accionlabs/breezeai-claude-plugin --skill generate-spec-accionlabs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: generate-spec
Source: https://github.com/accionlabs/breezeai-claude-plugin/tree/main/skills/generate-spec
Command: npx skills add https://github.com/accionlabs/breezeai-claude-plugin --skill generate-spec-accionlabs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jinja2, and includes scripts (resource) components.

What problem does it solve?

Generate a complete, structured functional specification from a Breeze functional graph so teams can move from scattered requirements and scenarios into a single stakeholder-ready document with citations and numbered artefacts.

Core Features & Use Cases

  • Aggregates personas, outcomes, scenarios, steps, actions and their citations into a numbered Functional Requirements Document suitable for reviews, PRs, or handoff.
  • Supports multiple output modes: plain Markdown, enriched Markdown, single-file HTML viewer, and optional exports to DOCX/PDF with pre-rendered mermaid diagrams.
  • Handles scoped generation (full project, single persona, single outcome), preserves source citations, and provides AI enrichment pipelines for executive summaries, business objectives, and per-outcome business value.
  • Use Case: Convert a Breeze project graph into a stakeholder-ready FRD and then export it to DOCX for client delivery.

Quick Start

Run /breeze:generate-spec --full --mermaid to produce a rich functional specification with synthesized overview, per-outcome business value, and rendered diagrams.

Frequently Asked Questions about generate-spec

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

FAQPage Schema
How do I generate a functional specification document from a functional graph?▼

To generate a functional specification document from a functional graph, this Skill transforms personas, outcomes, scenarios, steps, and actions into a structured Markdown or HTML document with optional mermaid diagrams.

Can I export a functional specification to DOCX or PDF with mermaid diagrams?▼

Yes, you can export a functional specification to DOCX or PDF by pre-rendering mermaid diagrams via mmdc and using pandoc to convert the enriched Markdown into standalone document formats for client delivery.

Do I need pandoc and npx mmdc installed to export functional specs to standalone HTML?▼

Yes, you need local tools like pandoc and npx mmdc installed to execute the export workflow, as the Skill relies on them for pandoc-based document conversion and mermaid diagram pre-rendering.

What is the best way to create a scoped functional requirements document for a single persona?▼

The best way to create a scoped functional requirements document for a single persona is to apply scoped generation parameters, which filters the functional graph to produce a targeted Markdown or HTML output with numbered artefacts.

How does AI enrichment work when generating a functional spec from a Breeze project export?▼

AI enrichment in functional spec generation synthesizes executive summaries, business objectives, and per-outcome business value by processing the saved MCP JSON from a Breeze project export into an enriched Markdown pipeline.

Why are citations and numbered identifiers important in a functional specification document?▼

Citations and numbered identifiers are important in a functional specification document because they preserve source traceability for personas, outcomes, and scenarios, ensuring stakeholder-ready reviews and accurate technical handoffs.