User Story Writer
deanpeters/Product-Manager-Skills
Writes user stories in Mike Cohn's format with Gherkin acceptance criteria, turning user needs into development-ready work with testable conditions.
A skill your agent uses when the user wants a written spec, acceptance criteria, or a task graph before a non-trivial implementation, or runs the WrongStack /sdd workflow.
$ npx skills add WrongStack/WrongStack --skill sdd -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install WrongStack/WrongStack sdd --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/WrongStack/WrongStack.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/core/skills/sdd .claude/skills/sdd && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "sdd" agent skill from https://github.com/WrongStack/WrongStack/tree/main/packages/core/skills/sdd into .claude/skills/sdd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sdd", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/WrongStack/WrongStack/tree/main/packages/core/skills/sddType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add WrongStack/WrongStack --skill sdd -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install WrongStack/WrongStack sdd --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/WrongStack/WrongStack.git skills-src && mkdir -p .agents/skills && cp -r skills-src/packages/core/skills/sdd .agents/skills/sdd && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "sdd" agent skill from https://github.com/WrongStack/WrongStack/tree/main/packages/core/skills/sdd into .agents/skills/sdd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sdd", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add WrongStack/WrongStack --skill sdd -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install WrongStack/WrongStack sdd --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/WrongStack/WrongStack.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/packages/core/skills/sdd .cursor/skills/sdd && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "sdd" agent skill from https://github.com/WrongStack/WrongStack/tree/main/packages/core/skills/sdd into .cursor/skills/sdd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sdd", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/WrongStack/WrongStack.git --path packages/core/skills/sdd--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add WrongStack/WrongStack --skill sdd -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install WrongStack/WrongStack sdd --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/WrongStack/WrongStack.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/packages/core/skills/sdd .gemini/skills/sdd && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "sdd" agent skill from https://github.com/WrongStack/WrongStack/tree/main/packages/core/skills/sdd into .gemini/skills/sdd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sdd", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install WrongStack/WrongStack sddInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add WrongStack/WrongStack --skill sdd -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/WrongStack/WrongStack.git skills-src && mkdir -p .github/skills && cp -r skills-src/packages/core/skills/sdd .github/skills/sdd && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "sdd" agent skill from https://github.com/WrongStack/WrongStack/tree/main/packages/core/skills/sdd into .github/skills/sdd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sdd", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add WrongStack/WrongStack --skill sdd -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install WrongStack/WrongStack sdd --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/WrongStack/WrongStack.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/packages/core/skills/sdd .opencode/skills/sdd && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "sdd" agent skill from https://github.com/WrongStack/WrongStack/tree/main/packages/core/skills/sdd into .opencode/skills/sdd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sdd", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
sddA skill your agent uses when the user wants a written spec, acceptance criteria, or a task graph before a non-trivial implementation, or runs the WrongStack /sdd workflow.
Sdd is an agent skill from WrongStack/WrongStack. Use this skill when the user wants a written spec, acceptance criteria, or a task graph before a non-trivial implementation, or runs the WrongStack /sdd workflow. Triggers: user says "/sdd", "spec", "specification", "task graph", "SDD", "acceptance criteria".
Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `SKILL.save.md`).
It sits in Product & Project Management, covering User stories. The repository describes itself as: An AI coding agent that reads your code, edits files, runs commands, and reasons through bugs — across a terminal REPL, a full-screen TUI, and a browser UI, while you keep your… The licence is MIT.
6 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 57f6018. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Sdd loads about 1.7k tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 785 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from WrongStack/WrongStack at commit 57f6018, republished under its MIT licence (© WrongStack). 785 words, ~1,674 tokens.
.claude/skills/sdd/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.Every non-trivial change starts with a spec. The spec is the source of truth — it defines what to build, how to verify it, and what counts as done. SDD uses /sdd slash commands to create specs, generate task graphs, and track execution.
/sdd for urgent tasks backfires — the spec is what makes "urgent" possible.refactor-planner first.1. /sdd new [title] → Build spec from questions
2. /sdd tasks <id> → Generate task graph from spec
3. /sdd graph <id> → Visualize dependencies
4. /sdd critical <id> → Find bottlenecks
5. /sdd execute <id> → Run tasks (or execute manually)| Command | What it does |
|---|---|
/sdd tasks | Show task list with progress bar (sorted: in_progress → pending → review → blocked → failed → completed) |
/sdd next | Show next executable task + blockers |
/sdd done <N> | Complete a task (by number or fuzzy title match) |
/sdd skip <N> | Skip a task back to pending |
/sdd fail <N> | Mark a task as failed |
/sdd review <N> | Send a task to review |
/sdd edit <N> <text> | Edit task title (short text) or description (long text) |
/sdd undo | Undo last task completion |
/sdd graph | ASCII task dependency visualization |
/sdd critical | Critical path analysis + bottlenecks |
| Template | Best for |
|---|---|
feature | New feature development |
bugfix | Bug fix with root cause analysis |
refactor | Code refactoring with goals |
infra | Infrastructure/tooling changes |
integration | External service integration |
cli-command | New CLI commands/slash commands |
A complete spec has:
[priority] description format[critical] Users can authenticate with OAuth2
[high] Rate limiting: 100 req/min per user
[medium] Response time < 200ms p95
[low] Support dark modeEach requirement generates one or more tasks. Tasks have states:
pending → in_progress → review → completed
↓
blocked (waiting on dependencies)
↓
failedThe critical path finds:
/sdd pairs with /goal for autonomous execution:
| Command | What it does |
|---|---|
/goal set <text> | Set an autonomous mission |
/goal pause | Pause at end of current iteration |
/goal resume | Resume a paused goal |
/goal journal [N] | Show recent journal entries |
/goal clear | Clear goal and stop eternal mode |
/autonomy eternal | Run goal loop indefinitely |
/autonomy stop | Stop eternal mode |
Eternal stage flow: decide → execute → reflect → sleep | paused | stopped
Stage shown in real-time. Pause stops after current iteration completes.
/sdd because the task is urgent. Urgency without a spec produces urgency-shaped rework. The spec is what makes "urgent" possible to ship correctly.refactor-planner for the phased plan. SDD defines the goal; refactor-planner sequences the work.refactor-planner, not absorbed into SDD tasksrefactor-planner — when the spec reveals a multi-file refactorbug-hunter — when a bugfix spec needs a root cause analysis sectionmulti-agent — for executing parallel task groupsoutput-standards — for standardized <nextsteps> formatting© WrongStack, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 1 other file in packages/core/skills/sdd of WrongStack/WrongStack.
Open the folder on GitHubat commit 57f6018
Sdd next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Sdd this skillWrongStack/WrongStack | 370 | — | ~1.7k | Automated safety check: Pass | MIT | |
| User Story Writerdeanpeters/Product-Manager-Skills | 7.2k | 2 repos | ~2.9k | Automated safety check: Pass | Custom licence | |
| To Specbestofjs/bestofjs | 3.1k | 22 repos | ~757 | Automated safety check: Pass | MIT | |
| Walking Skeleton Roadmap Scopingprime-radiant-inc/iterative-development | 181 | — | ~1.7k | Automated safety check: Pass | Apache-2.0 | |
| Design Sprintwondelai/skills | 2.4k | — | ~3.8k | Automated safety check: Pass | MIT | |
| Execute Issuelbedner/aegis-stack | 143 | — | ~1.1k | Automated safety check: Pass | MIT |
deanpeters/Product-Manager-Skills
Writes user stories in Mike Cohn's format with Gherkin acceptance criteria, turning user needs into development-ready work with testable conditions.
bestofjs/bestofjs
Turn the current conversation into a spec and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.
prime-radiant-inc/iterative-development
Turns extracted requirements into a roadmap by choosing a walking skeleton iteration with its first journey scenario and ordering the remaining work into follow-on iterations.
wondelai/skills
Run a structured 5-day process to prototype, test, and validate product ideas with real users.
lbedner/aegis-stack
A skill your agent uses when handed a GitHub issue (number or URL) to execute end to end.
penwyp/ClaudePreference
Produce a professional, code-grounded refactor or implementation design report from identified technical problems, product gaps, review findings, architecture concerns, or frontend-backend contract…
WrongStack/WrongStack
Design or substantially improve user-facing interfaces with a product-specific visual direction, content hierarchy, and rendered critique.
WrongStack/WrongStack
A skill your agent uses to audit an interface that already exists and say precisely why it looks generated, templated, or unfinished — a scored rubric across composition, typography, color, states…
WrongStack/WrongStack
A skill your agent uses when external coding agents (Claude Code, Aider, custom scripts) need to participate in the project's shared WrongStack mailbox, or when a user asks to "expose the mailbox"…
WrongStack/WrongStack
A skill your agent uses whenever work can be split across multiple AI agents running in parallel, or when orchestrating leader/worker patterns in WrongStack.
WrongStack/WrongStack
Use this skill before asserting that a CSS, HTML or accessibility capability is available, unavailable, or the right tool — it carries dated, refreshable platform facts and refuses to let stale…
WrongStack/WrongStack
A skill your agent uses when the user wants to communicate with WrongStack's shared project mailbox from outside WrongStack — read messages sent by WrongStack agents, send replies, broadcast to all…
Categories
A skill your agent uses when the user wants a written spec, acceptance criteria, or a task graph before a non-trivial implementation, or runs the WrongStack /sdd workflow. Sdd is an agent skill from WrongStack/WrongStack. Use this skill when the user wants a written spec, acceptance criteria, or a task graph before a non-trivial implementation, or runs the WrongStack /sdd workflow.
Sdd fits situations like: the user wants a written spec; acceptance criteria; A task graph before a non-trivial implementation; runs the WrongStack /sdd workflow.
Run `npx skills add WrongStack/WrongStack --skill sdd -a claude-code`. Or copy the skill folder (packages/core/skills/sdd in WrongStack/WrongStack) into .claude/skills/sdd in your project. Claude Code loads it when a task matches its description.
Run `npx skills add WrongStack/WrongStack --skill sdd -a codex`. Or copy the skill folder (packages/core/skills/sdd in WrongStack/WrongStack) into .agents/skills/sdd in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add WrongStack/WrongStack --skill sdd -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sdd, .gemini/skills/sdd, .github/skills/sdd and .opencode/skills/sdd in your project.
SKILL.md names no scripts, command-line tools or credentials: Sdd is instructions for the agent only.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Sdd is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.7k tokens (SKILL.md is roughly 6.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Sdd: User Story Writer (deanpeters/Product-Manager-Skills, 7.2k stars), To Spec (bestofjs/bestofjs, 3.1k stars), Walking Skeleton Roadmap Scoping (prime-radiant-inc/iterative-development, 181 stars) and Design Sprint (wondelai/skills, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
WrongStack (a GitHub organization) maintains it in WrongStack/WrongStack, which has 370 GitHub stars. The repository holds 38 skills in this directory. The repository was last updated on October 7, 2026.
Source: WrongStack/WrongStack on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.