writing-specs

Create delta specs with ADDED, MODIFIED, REMOVED, and RENAMED sections.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Delta specs describe what's changing relative to the current specs, enabling focused, incremental software decisions without restating the entire system behavior.

Core Features & Use Cases

  • Template-guided: Follow the provided template to ensure consistent, machine-parsable spec artifacts.
  • Capability-aligned: Generate one delta spec per capability listed in the proposal to keep scope clear.
  • Versioned artifacts: Save specs to standardized paths for traceability and automated reviews.

Quick Start

Fill in the template for a given capability and save the resulting spec to the designated path.

Frequently Asked Questions about writing-specs

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

FAQPage Schema
What is a delta spec and when do I need to write one for software requirements?

A delta spec describes what a system should do relative to current specs, enabling focused incremental decisions without restating entire system behavior. You need delta specs when proposing capability changes that require structured, machine-parsable artifacts for automated reviews.

How do I write a delta spec with testable scenarios for modified capabilities?

To write a delta spec with testable scenarios, apply the provided template to each capability listed in your proposal. Enforce a structured format with ADDED, MODIFIED, REMOVED, and RENAMED sections, ensuring every requirement includes specific testable scenarios for validation.

How do I structure requirements specs to keep capability scope clear and traceable?

To keep requirements scope clear and traceable, generate one delta spec per capability listed in the proposal. Save the resulting versioned artifacts to standardized designated paths, ensuring each spec maintains a consistent, machine-parsable format for traceability and automated reviews.

Does writing delta specs require restating the entire system behavior for each change?

Writing delta specs does not require restating entire system behavior. Delta specs specifically describe only what is changing relative to current specs, using ADDED, MODIFIED, REMOVED, and RENAMED sections to enable focused, incremental software decisions without duplicating existing documentation.

Can I use a custom format for delta specs or do I need to follow a specific template?

You must follow the provided template to ensure consistent, machine-parsable spec artifacts. The template enforces a structured format with ADDED, MODIFIED, REMOVED, and RENAMED sections, and requires testable scenarios for each requirement to maintain spec quality and automated review compatibility.

What is the best way to define removed and renamed capabilities in a requirements proposal?

The best way to define removed and renamed capabilities is using a delta spec template with dedicated REMOVED and RENAMED sections. This structured approach describes changes relative to current specs, keeping scope clear and generating versioned artifacts for traceability and automated reviews.