Spec Generator

Generate OpenSpec proposals from TaskMaster tasks using coupling analysis.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/turbobeest/claude-dev-pipeline --skill spec-generator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Spec Generator
Source: https://github.com/turbobeest/claude-dev-pipeline/tree/main/skills/spec-gen
Command: npx skills add https://github.com/turbobeest/claude-dev-pipeline --skill spec-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation of detailed technical specifications (OpenSpec proposals) directly from TaskMaster tasks, incorporating coupling analysis for optimal development strategy. It ensures that every task has a clear, test-driven specification before implementation begins, saving design time.

Core Features & Use Cases

  • Automated OpenSpec Creation: Generates comprehensive OpenSpec proposals for tasks, detailing requirements, scenarios, and test strategies.
  • Coupling-Aware Strategy: Utilizes coupling analysis to determine if proposals should be single-task or per-subtask, enabling efficient parallel development.
  • Batched Processing: Processes tasks in isolated batches, preventing cross-contamination and ensuring atomic commits for each set of specifications.
  • Use Case: After tasks are decomposed and analyzed for coupling, activate this skill to automatically produce all necessary OpenSpec proposals, providing developers with clear, actionable blueprints for TDD implementation.

Quick Start

Generate OpenSpec proposals for the next batch of tasks, considering coupling analysis.

Frequently Asked Questions about Spec Generator

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

FAQPage Schema
How do I generate technical specifications from task decomposition?

Spec Generator automates OpenSpec proposal creation from TaskMaster tasks by analyzing coupling relationships and converting them into actionable specifications. It processes tasks in batches, producing one proposal per subtask with test-driven requirements and implementation strategies.

What's the best way to ensure tasks have specifications before development starts?

Activate Spec Generator after coupling analysis completes to automatically produce comprehensive OpenSpec proposals for all tasks. Each proposal includes functional requirements, test scenarios, and development strategy, providing developers with clear blueprints before TDD implementation begins.

How does coupling analysis improve specification generation?

Coupling-aware strategy determines whether proposals should be single-task or per-subtask based on dependency analysis. This enables efficient parallel development by isolating independent work and preventing cross-contamination across batches while maintaining atomic commits.

Can I batch process multiple tasks into separate OpenSpec proposals?

Yes. Spec Generator batches master tasks into dedicated phase-2 worktrees with sequential processing and cross-batch isolation. Each batch produces dedicated proposals per subtask, updating the TASKMASTER_OPENSPEC_MAP with dependency contracts integrated throughout.

When should I use OpenSpec proposals instead of manual specification writing?

Use OpenSpec proposals after tasks are decomposed and coupling analysis is complete. Automation saves design time by eliminating manual specification overhead while ensuring consistency, traceability, and alignment with test-driven development requirements across all task types.

What happens if tasks have unresolved dependencies or unclear coupling?

Spec Generator requires completed coupling analysis to determine proposal granularity. Run coupling analysis before activation to identify dependencies and coupling relationships; unresolved dependencies will produce less optimized proposal batching and may require manual review of cross-task contract integration.