agents-standards
Standards for authoring SDD plugin agents — frontmatter, self-containment, skill references, and no-user-interaction rules.
@liorcohenInstall SkillDevelopment
Skill
/spec-decomposition
Analyze specifications and decompose into independent changes.
Claude Code
$ npx -y skills add LiorCohen/sdd --skill spec-decomposition --agent claude-code
Codex
$ npx skills add LiorCohen/sdd --skill spec-decomposition -a codex -y
Cursor
$ npx skills add LiorCohen/sdd --skill spec-decomposition -a cursor -y
Gemini CLI
$ npx skills add LiorCohen/sdd --skill spec-decomposition -a gemini-cli -y
GitHub Copilot
$ npx skills add LiorCohen/sdd --skill spec-decomposition -a github-copilot -y
OpenCode
$ npx skills add LiorCohen/sdd --skill spec-decomposition -a opencode -y
Windsurf
$ npx skills add LiorCohen/sdd --skill spec-decomposition -a windsurf -y
SKILL.md
spec-decomposition.SKILL.mdname: spec-decomposition
description: Analyze specifications and decompose into independent changes.
user-invocable: false
Spec Decomposition Skill
Purpose
Analyze a specification document to identify natural change boundaries and return a structured decomposition result. This is a pure analysis skill that takes input and returns output without user interaction.
Input
Schema: [`schemas/input.schema.json`](./schemas/input.schema.json)
Accepts decomposition mode, spec content, and mode-specific parameters for outline, section, or hierarchical decomposition.
Output
Schema: [`schemas/output.schema.json`](./schemas/output.schema.json)
Returns mode-specific results: outline sections, or hierarchical epic/feature groupings with dependency graph.
Resource Files
For detailed guidance, read these on-demand:
- [outline-modes.md](resources/outline-modes.md) — Outline, section, hierarchical mode documentation with examples
- [decomposition-algorithm.md](resources/decomposition-algorithm.md) — 5-phase algorithm, formulas, heuristics
- [data-structures.md](resources/data-structures.md) — DecomposedChange, DecompositionResult schemas, special cases
Quick Reference
**Modes:** outline (extract headers), section (analyze one section), hierarchical (epics + features), default (full analysis)
**Algorithm phases:** Structure Extraction -> Boundary Detection -> Dependency Detection -> Independence Scoring -> Refinement
**Complexity levels:** SMALL (<= 3 ACs), MEDIUM (4-8 ACs), LARGE (> 8 ACs), EPIC (> 10 ACs + 3+ components)
**Independence score:** 0.0-1.0 scale; >= 0.5 is standalone, < 0.3 should be merged
Read more
name: spec-decomposition description: Analyze specifications and decompose into independent changes. user-invocable: false
Spec Decomposition Skill
Purpose
Analyze a specification document to identify natural change boundaries and return a structured decomposition result. This is a pure analysis skill that takes input and returns output without user interaction.
Input
Schema: [`schemas/input.schema.json`](./schemas/input.schema.json)
Accepts decomposition mode, spec content, and mode-specific parameters for outline, section, or hierarchical decomposition.
Output
Schema: [`schemas/output.schema.json`](./schemas/output.schema.json)
Returns mode-specific results: outline sections, or hierarchical epic/feature groupings with dependency graph.
Resource Files
For detailed guidance, read these on-demand:
- [outline-modes.md](resources/outline-modes.md) — Outline, section, hierarchical mode documentation with examples
- [decomposition-algorithm.md](resources/decomposition-algorithm.md) — 5-phase algorithm, formulas, heuristics
- [data-structures.md](resources/data-structures.md) — DecomposedChange, DecompositionResult schemas, special cases
Quick Reference
**Modes:** outline (extract headers), section (analyze one section), hierarchical (epics + features), default (full analysis)
**Algorithm phases:** Structure Extraction -> Boundary Detection -> Dependency Detection -> Independence Scoring -> Refinement
**Complexity levels:** SMALL (<= 3 ACs), MEDIUM (4-8 ACs), LARGE (> 8 ACs), EPIC (> 10 ACs + 3+ components)
**Independence score:** 0.0-1.0 scale; >= 0.5 is standalone, < 0.3 should be merged
Stats
43
Stars
4
Forks
Quiet
Maintenance
TypeScript
Language
Last commit
Created
Ships withsdd
Structure for AI-assisted development AI coding assistants are powerful but chaotic. You prompt, you get code, but then what?
4359 skills7 agents
Stars on GitHub
Momentum
- stars in total
- 43
Other skills on sdd.
@liorcohenInstall Skillcommands-standards
Standards for authoring SDD plugin commands — frontmatter, user interaction, skill/agent invocation, CLI integration, and output…
@liorcohenInstall Skillcommit
Create a commit following repository guidelines with proper versioning and changelog updates.
@liorcohenInstall Skillcritic
Two-step self-review at every task lifecycle phase. Step 1 (this skill) runs in-context to gather session signals — files read vs…
@liorcohenInstall Skilld2
D2 diagramming language reference for architecture diagrams, sequence diagrams, grid layouts, SQL tables, and class diagrams.…
@liorcohenInstall Skilldocs-standards
Writes and maintains user-facing documentation for the SDD plugin. Proactively detects when docs are out of sync with plugin…
@liorcohenInstall SkillMore skills from other plugins.
Auto-invoked
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
@obraInstall Skillask-matt
Ask which skill or flow fits your situation. A router over the skills in this repo.
@mattpocockInstall SkillAuto-invoked
Questions about spec-decomposition.
- Which coding agents can use spec-decomposition?
- spec-decomposition installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.