specification-generation

Convert requirements into structured technical specifications with architecture decisions

509 stars

Best use case

specification-generation is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Convert requirements into structured technical specifications with architecture decisions

Teams using specification-generation should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/specification-generation/SKILL.md --create-dirs "https://raw.githubusercontent.com/a5c-ai/babysitter/main/library/methodologies/maestro/skills/specification-generation/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/specification-generation/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How specification-generation Compares

Feature / Agentspecification-generationStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Convert requirements into structured technical specifications with architecture decisions

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Specification Generation

## Capabilities

Transforms requirements from PM interviews into structured technical specifications. Includes technology stack selection, system architecture, data models, API contracts, and architecture decision records (ADRs).

## Tool Use Instructions

- Use **Read** to examine requirements documents and existing specs
- Use **Grep/Glob** to find related architectural patterns in the codebase
- Use **Write** to generate the technical specification document
- Use **Edit** to refine specs based on Architect feedback

## Process Integration

- Used in `maestro-orchestrator.js` Phase 2-3 (Architect Review, Tech Spec)
- Maps to tasks: `maestro-pm-spec-generation`, `maestro-architect-tech-spec`
- Agents: Product Manager (requirements spec), Architect (technical spec)
- Iterates with Architect feedback loop until approved
- Outputs feed into `story-decomposition` skill

Related Skills

pdf-generation

509
from a5c-ai/babysitter

Professional PDF documentation generation. Convert Markdown to PDF with custom templates, styling, table of contents, cross-references, and optimized output for print and archival.

diagram-generation

509
from a5c-ai/babysitter

Multi-format diagram generation from text descriptions. Create Mermaid, PlantUML, D2, and Graphviz diagrams including flowcharts, sequence diagrams, architecture diagrams (C4), and data models.

test-data-generation

509
from a5c-ai/babysitter

Synthetic test data generation and management using Faker.js and similar tools. Generate realistic test data, create data factories, implement database seeding, and manage test data anonymization.

procedural-generation

509
from a5c-ai/babysitter

Procedural level generation skill for PCG algorithms.

style-specification

509
from a5c-ai/babysitter

Create ultra-detailed musical style specifications including genres, BPM, instrumentation, vocal direction, production aesthetics, and reference tracks for AI music generation

synthesis-specification-language

509
from a5c-ai/babysitter

Define specifications for program synthesis using various paradigms

csi-specification-writer

509
from a5c-ai/babysitter

CSI MasterFormat specification writing skill for construction document preparation

rag-embedding-generation

509
from a5c-ai/babysitter

Batch embedding generation with caching, rate limiting, and multiple provider support

specification-writing

509
from a5c-ai/babysitter

Write feature specifications as requirements and user stories with acceptance criteria, focusing on business value and testable conditions.

Epic Generation

509
from a5c-ai/babysitter

Transform PRD into a technical implementation plan with architecture decisions and dependency mapping.

code-generation

509
from a5c-ai/babysitter

Minimal, pattern-matching code output. Write the least code that satisfies requirements. Match existing project patterns. Use Write/Edit tools only.

process-builder

509
from a5c-ai/babysitter

Scaffold new babysitter process definitions following SDK patterns, proper structure, and best practices. Guides the 3-phase workflow from research to implementation.

Workflow & Productivity