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.