create-spec

Generate specification documents through a nine-phase workflow with YAML test data.

226|55|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/Miosa-osa/canopy --skill create-spec-miosa-osa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-spec
Source: https://github.com/Miosa-osa/canopy/tree/main/library/skills/development/create-spec
Command: npx skills add https://github.com/Miosa-osa/canopy --skill create-spec-miosa-osa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

People and teams often struggle to translate ideas into complete, actionable specifications. This skill provides a repeatable, guided process to generate fully formed specs from discovery through testing.

Core Features & Use Cases

  • Nine-phase guided spec creation: Drives discovery, context gathering, requirements, constraints, architecture, interfaces, error handling, testing strategy, and final assembly.
  • Type-flexible templates: Supports library, feature, and change spec types with type-specific templates and YAML test data generation.
  • Output-ready specs: Produces comprehensive documentation plus ready-to-use test data for TDD workflows.
  • Use Case: A product team rapidly produces a complete spec for a new API client, ensuring alignment across engineering, product, and QA.

Quick Start

Run the guided spec creation workflow with /create-spec --type feature to start.

Frequently Asked Questions about create-spec

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

FAQPage Schema
What is a phase-driven specification process for software development?

A phase-driven specification process guides the creation of specification documents through structured stages, moving from initial context gathering to requirements, architecture, interfaces, error handling, and testing strategy. It ensures comprehensive documentation for libraries, features, or changes.

How do I automate creating complete specifications from requirements to testing?

You can automate end-to-end specification creation by using a guided nine-phase workflow that generates requirements, architecture, interface definitions, error handling strategies, and a YAML test data set. This process translates initial ideas into output-ready documentation for TDD workflows.

Can I generate YAML test data sets for different types of software specifications?

Yes, you can generate YAML test data sets for library, feature, and change specification types. The process applies type-specific templates during the final assembly phase to produce ready-to-use test data alongside the complete specification document.

Does automated spec creation include architecture and interface definitions?

Yes, automated spec creation includes architecture and interface definitions as dedicated phases. The workflow systematically captures constraints, defines system architecture, and details interfaces before moving into error handling and testing strategy assembly.

What is the best way to structure error handling and testing strategy in a feature spec?

The best way to structure error handling and testing strategy is through a guided nine-phase process that dedicates specific phases to defining error conditions and assembling testing data. This ensures feature specs align engineering, product, and QA requirements comprehensively.