specification-phase

Transform natural language feature requests into structured specification artifacts.

Updated Oct 26, 2025
One-click install
npx skills add https://github.com/oxie/portfolio-cms-project --skill specification-phase-oxie
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: specification-phase
Source: https://github.com/oxie/portfolio-cms-project/tree/main/.claude/skills/specification-phase
Command: npx skills add https://github.com/oxie/portfolio-cms-project --skill specification-phase-oxie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill transforms natural language feature requests into structured, unambiguous specifications. It ensures clear scope, measurable success criteria, and proper classification, preventing misinterpretations and costly rework in later development phases.

Core Features & Use Cases

  • Feature Classification: Automatically classifies features (e.g., HAS_UI, IS_IMPROVEMENT) to guide subsequent workflow and artifact generation.
  • Informed Guess Strategy: Applies reasonable defaults for non-critical technical decisions, minimizing clarification overhead and speeding up the process.
  • Measurable Success Criteria: Defines quantifiable metrics and measurement methods for each requirement, ensuring objective validation.
  • Roadmap Integration: Automatically links new specifications to existing roadmap entries and updates their status, maintaining project alignment.
  • Use Case: A user provides a high-level feature idea. This skill helps convert it into a detailed specification, complete with classifications, assumptions, and measurable success criteria, ready for planning and implementation.

Quick Start

Specify the 'Student Progress Dashboard' feature, classifying it, defining success criteria, and integrating it with the roadmap.

Frequently Asked Questions about specification-phase

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

FAQPage Schema
How do I transform feature requests into structured specifications?

Transform feature requests into structured specifications by defining scope, measurable success criteria, and classifications. This Skill converts natural language ideas into detailed specs with artifacts including spec documents, notes, visuals, and workflow state, ready for roadmap integration and team implementation.

What should I include in a product specification?

Include classification flags (HAS_UI, IS_IMPROVEMENT, HAS_METRICS, HAS_DEPLOYMENT_IMPACT), measurable success criteria, informed-guess defaults for technical decisions, and clear scope boundaries. The Skill generates spec.md, NOTES.md, visuals documentation, and workflow-state.yaml to ensure nothing is ambiguous.

How do specifications integrate with project roadmaps?

Specifications automatically link to existing roadmap entries and update their status during the specification phase. This maintains project alignment, prevents duplicate work, and ensures new features fit within planned development cycles and resource constraints.

Can I define measurable success criteria during planning?

Yes. Define quantifiable metrics and measurement methods for each requirement during specification. This ensures objective validation later and prevents scope creep by establishing clear, testable success criteria upfront.

What's the benefit of classifying features early?

Early classification (HAS_UI, IS_IMPROVEMENT, HAS_METRICS, HAS_DEPLOYMENT_IMPACT) guides downstream workflow, artifact generation, and team allocation. It prevents misinterpretations and reduces rework by making technical implications explicit before development begins.

How does the informed-guess strategy speed up specification?

Informed-guess strategy applies reasonable defaults for non-critical technical decisions, minimizing clarification overhead. This accelerates the specification process by resolving low-stakes ambiguities automatically rather than blocking on perfect clarity.