sdd-skill-creator

SDD Skill Creator

Generate project-specific SDD skills that live in a repository.

Prerequisites

You (the generator) must first:

1. Read docs/sdd-guidelines.md (especially §1 Artifacts, §9 Customization Points, §10 Multi-Agent)
2. Have project context available

Generated skills will be self-contained—their users won't need to read Guidelines.

Output Structure

{project}/.sdd/skills/
├── sdd-foundation/SKILL.md
├── sdd-requirements/SKILL.md
├── sdd-design/SKILL.md
├── sdd-verify/SKILL.md
└── sdd-workflow/SKILL.md

Instructions

Step 1: Gather Project Context

Skip questions already answered in conversation.

Step 2: Define Customizations

Fill out the customization record. See templates/customization.yaml.

Step 3: Generate Each Skill

For each skill, create SKILL.md with proper frontmatter and these sections:

Skill-to-Guidelines Mapping

What "Project-Adapted" Means

If multi-agent: Add §10 coordination to each skill.

Step 4: Write Skills

Create files in .sdd/skills/. Each skill must be:

• Self-contained — User can follow without reading Guidelines
• Project-specific — Uses project terminology throughout
• Guidelines-aligned — Doesn't contradict §1-10
• Concise — Under 200 lines

Step 5: Verify Generated Skills

For each skill:

1. Frontmatter has name and description with triggers?
2. All Step 2 customization values applied?
3. Complete workflow, no placeholders?
4. Concrete, domain-relevant example?
5. Actionable verification checklist?

Step 6: Inform User

Created SDD skills in {project}/.sdd/skills/:

- sdd-foundation   → Foundation documents (§1.1)
- sdd-requirements → Requirements documents (§1.2)
- sdd-design       → Design documents (§1.3)
- sdd-verify       → Integrity verification (§3)
- sdd-workflow     → End-to-end orchestration

Customizations: {prefixes}, {req_format}, multi-agent={yes/no}

Examples

See examples/taskcli.md for a complete walkthrough.

Anti-patterns