skills sourced live from GitHub · all skills listed are free · each skill is provided under its author's license.
home / Writing / Writing Plans Skill by @obra
The skill is the skills/writing-plans folder inside that repository. Copy it into the folder your agent loads skills from; check your agent's documentation for where that is.
Use when you have a spec or requirements for a multi-step task, before touching code.
Turns a spec into an implementation plan before any code is touched: scope check, file structure, right-sized tasks and bite-sized task granularity.
The original SKILL.md is organised into these sections:
Written and maintained by @obra. It is published under the MIT license, which allows reuse with attribution. See the author profile. SkillDirectory does not claim authorship: this page adds our own review and links back to the original, and the skill's text belongs to its author.
--- name: writing-plans description: Use when you have a spec or requirements for a multi-step task, before touching code # Writing Plans ## Overview Write comprehensive implementation plans assuming the engineer has zero context for our codebase and questionable taste. Document everything they need to know: which files to touch for each task, code, testing, docs they might need to check, how to test it. Give them the whole plan as bite-sized tasks. DRY. YAGNI. TDD. Frequent commits. Assume they are a skilled developer, but know almost nothing about our toolset or problem domain. Assume they don't know good test design very well. **Announce at start:** "I'm using the writing-plans skill to create the implementation plan." **Context:** If working in an isolated worktree, it should have been created via the `superpowers:using-git-worktrees` skill at execution time. **Save plans to:** `docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md` …
Excerpt only, quoted from the author's repository. Open the repository for the complete file.