SDD Delta Spec Writer

Trust Score 79/100

Compose structured SDD delta specs: generate ADDED/MODIFIED/REMOVED requirements and testable Given/When/Then scenarios for change proposals (executor-only).

triggers:sdddelta specspecificationwrite specrequirementsGiven/When/Thenopenspec

GitHub SKILL.md

What it does

Generates Software Design Document (SDD) delta specifications for proposed changes. The skill accepts a change proposal and produces structured requirements and scenarios describing what is ADDED, MODIFIED, or REMOVED. It follows strict workflows for copying existing requirements, writing deltas, and producing testable Given/When/Then scenarios.

When to use it

When an orchestrator or change proposal requests a formal delta spec for implementation planning.
During the specification phase where requirements must be written or modified as full blocks (archive-safe).
In workflows that persist specs to an artifact store (engram/openspec/hybrid) or return in-memory spec artifacts.

What's included

Scripts: none (this is a procedural skill with authoring rules).
References: links to shared conventions and exact delta-format templates embedded in the skill body.
Instructions: step-by-step rule set for ADDED/MODIFIED/REMOVED sections, requirement copy-and-edit workflow, RFC2119 usage, and size budget guidance.

Compatible agents

Executor-capable agents that can be delegated tasks by an orchestrator. This skill is marked delegate-only and disables inline model invocation — intended for sub-agents that persist spec artifacts.

Audit Summary

SDD Delta Spec Writer is an executor-only sub-agent skill for composing structured requirement specs (ADDED/MODIFIED/REMOVED) with Given/When/Then scenarios. No bundled scripts. The SKILL.md is detailed with clear phases and output contracts, but references external shared files (sdd-phase-common.md, openspec-convention.md) not included in the skill bundle, making it non-self-contained. Only usable within its parent orchestration pipeline.

Watch Out

Skill is executor-only (user-invocable: false) — cannot be directly invoked by users
References shared files (sdd-phase-common.md, openspec-convention.md) not bundled with the skill
Requires the full Gentleman Programming SDD ecosystem to function

Notes

Well-structured instruction document for a niche orchestration role. Clean from a security standpoint — no scripts, no network calls, no credentials. Main limitation is that it's fragmentary without its ecosystem dependencies and not user-invocable.

Information

Repository: gentle-ai
Stars: 3,029

Trust Score

Overall79

Security100

Code Quality55

Architecture62

Usefulness40

More from gentle-ai

SDD Onboard

Interactive onboarding that guides a user through a full SDD (spec-driven development) cycle on their real codebase, producing proposal, specs, design, tasks, a

Related Skills

Starlark Dev

Create, debug, and test Kurtosis Starlark packages — write package structure, run dry-runs, and inspect plan execution for reliable orchestration.

Maestro Orchestrate

Orchestrates complex engineering workflows with enforced design and approval gates, child-agent delegation, and session state management.

Run Execute

Orchestrates execution of work items across modes (autopilot, confirm, validate) with scripted init/complete tooling, plan/test/report artifacts and strict gati

Chinese Software Copyright Application

Generate complete Chinese software copyright application materials (application form, code documentation, user manual, design docs) and export them to PDF from

CTF Write-up Generator

Generate a concise, reproducible submission-style CTF writeup with a one-path solution script, metadata, and a short checklist for fast verification.

Overnight — Autonomous Long-Running Coding

Orchestrates long-running coding goals: decomposes objectives into atomic tasks, dispatches isolated worktree workers, verifies acceptance criteria, and merges

Verifying Markdown Formatting

Checks Markdown files for structural and stylistic formatting issues (headings, lists, code blocks, links) and applies deterministic fixes.

Code Spec Backfill

Identify missing function-level contracts and backfill docstrings and type annotations; report ambiguous gaps with misuse scenarios. Incremental, state-driven w

Back to Skills