spec

Generate formal executable specifications from clear requirements via spec-kit.

107|15|Updated Nov 10, 2025
One-click install
npx skills add https://github.com/rhuss/cc-superpowers-sdd --skill spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/rhuss/cc-superpowers-sdd/tree/main/skills/spec
Command: npx skills add https://github.com/rhuss/cc-superpowers-sdd --skill spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill allows you to directly create formal, executable specifications when you already have clear and detailed requirements, bypassing the brainstorming phase. It ensures your specs are sound, complete, and validated against project principles before any coding begins.

Core Features & Use Cases

  • Direct Spec Generation: Transforms clear requirements (e.g., from a PRD or user story) into a structured SKILL.md file.
  • Constitution Validation: Automatically checks the new spec against your project's defined principles and standards.
  • Soundness Review: Ensures the spec is complete, unambiguous, implementable, and testable.
  • Use Case: You receive a detailed product requirements document for a new REST API endpoint. Use this skill to quickly generate a formal spec, including functional, non-functional, error handling, and success criteria sections.

Quick Start

To create a spec for a new API endpoint, provide the details: Create a spec for a REST API endpoint to update user profiles. PUT /api/users/:id/profile

  • Accepts: name, bio, avatar_url
  • Requires: JWT authentication
  • Returns: updated user object

Frequently Asked Questions about spec

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

FAQPage Schema
How do I generate a formal specification from a requirements document?

Formal specifications transform clear requirements directly into structured SKILL.md files with functional, technical, error handling, and success criteria sections. Provide detailed requirements or a PRD, and the spec generation process creates executable contracts that are validated against project principles before implementation begins.

What should I include in requirements before creating a spec?

Requirements must be clear, detailed, and well-defined—ideally from a PRD or user story. Include acceptance criteria, functional and non-functional needs, authentication requirements, API endpoints, data formats, and error scenarios. The more complete your input, the more thorough the generated specification.

Does spec validation check against project principles?

Yes. After spec generation, constitution validation automatically checks the new specification against your project's defined principles and standards. This ensures soundness, completeness, and consistency before any development work begins.

Can I use this for API endpoint specifications?

Yes. Common use cases include REST API endpoints and microservices. Provide endpoint details like HTTP method, path, parameters, authentication type, request/response formats, and error handling requirements to generate formal, executable API specifications.

What's the difference between spec-driven development and exploratory design?

Spec-driven development starts with clear, formal specifications that lock down requirements upfront. This approach skips brainstorming when requirements are already well-defined. Exploratory design iterates through dialogue when requirements are ambiguous or evolving.

Can I validate a spec for completeness and implementability?

Yes. Soundness review ensures specifications are complete, unambiguous, implementable, and testable. This validation catches gaps and inconsistencies before coding, reducing rework and ensuring the spec satisfies all functional and technical requirements.