Skills
.Work. You
Rest

define-spec

Community

Turn vague ideas into build-ready specs.

Software Engineering#specification#requirements#acceptance criteria#product planning#given when then#piter classification
AuthorCleanExpo
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill removes ambiguity from raw engineering ideas by converting them into a structured, build-ready specification with clear scope, acceptance criteria, and constraints.

Core Features & Use Cases

  • PITER classification: Labels the idea as hotfix, bug, chore, spike, or feature to set the expected intent and delivery shape.
  • Deterministic spec output: Produces a spec.md containing Summary, Goals, Non-Goals, Acceptance Criteria (Given/When/Then), Constraints, and Out of Scope in the exact required format.
  • Quality gates for verifiability: Enforces specific, testable goals; independently verifiable acceptance criteria; explicit non-goals; and real constraints (or “None identified”).
  • Vague-idea handling: Returns a structured clarification question set when the input is too vague or contradictory instead of generating an unreliable spec.
  • Use case: Hand a plain-English request from a product or engineering backlog to generate a spec ready for the planning phase.

Quick Start

Provide the raw idea and a pipeline id so the skill can generate a complete spec.md ready for the /plan phase.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: define-spec
Download link: https://github.com/CleanExpo/Pi-Dev-Ops/archive/main.zip#define-spec

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.