definition

Convert vague requirements into delta specs and design artifacts under .superspec.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Serien3/SuperSpec --skill definition-serien3
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: definition
Source: https://github.com/Serien3/SuperSpec/tree/main/src/superspec/skills/definition
Command: npx skills add https://github.com/Serien3/SuperSpec --skill definition-serien3

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps teams convert vague user needs into precise specifications and design artifacts before coding.

Core Features & Use Cases

  • Delta Specs creation: generate structured specs that define WHAT the system should do.
  • Template-driven workflow: guides from proposal to spec storage under .superspec, enabling traceability.
  • Collaboration and governance: ensures requirements, design, and acceptance criteria stay aligned across teams.

Quick Start

Review the current project state and begin drafting delta specs for the upcoming feature.

Frequently Asked Questions about definition

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

FAQPage Schema
How do I turn vague project requirements into concrete specs and design artifacts?

Delta specs define exactly WHAT a system should do by structuring changes into ADDED, MODIFIED, REMOVED, and RENAMED operations. They are needed for brownfield projects and ongoing feature work to maintain traceability from proposal to implementation.

How do I create delta specs for ongoing feature work in a brownfield project?

To create delta specs for ongoing feature work, you assess the current project state and apply delta operations like ADDED, MODIFIED, REMOVED, and RENAMED. The resulting specs are then stored under the .superspec directory for team traceability.

What is the best way to manage requirements and design alignment across teams?

Yes, using delta specs for brownfield project state assessment requires a valid SKILL.md frontmatter containing name and description. This frontmatter enforces the template-driven workflow needed to orchestrate spec creation effectively.

When should I avoid using delta specs for project proposals?

You should avoid using delta specs for project proposals when dealing with greenfield projects lacking an existing state to assess. Delta operations like MODIFIED and REMOVED are designed for brownfield feature work rather than entirely new system architectures.