Writing Plans
Create detailed implementation plans with bite-sized tasks for engineers with zero codebase context
Install
npx skills add obra/clank --skill Writing Plansgit clone --depth 1 https://github.com/obra/clank.git /tmp/clank
mkdir -p ~/.claude/skills
cp -r /tmp/clank/skills/collaboration/writing-plans ~/.claude/skills/Writing-PlansPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# 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:** This should be run in a dedicated worktree (created by brainstorming skill). **Save plans to:** `docs/plans/YYYY-MM-DD-<feature-name>.md` ## Bite-Sized Task Granularity **Each step is one action (2-5 minutes):** - "Write the failing test" - step - "Run it to make sure it fails" - step - "Implement the minimal code to make the test pass" - step - "Run the tests and make sure they pass" - step - "Commit" - step ## Plan Document Header **Every plan MUST start with this header:** ```markdown # [Feature Name] Implementation Plan > **For Claude:** Use `@skills/collaboration/executing-plans/SKILL.md` to implement this plan task-by-task. **Goal:** [One sentence describing what this builds] **Architecture:** [2-3 sentences about approach] **Tech Stack:** [Key technologies/libraries] --- ``` ## Task Structure
Details
- Skill name
Writing Plans- Repository
- obra/clank
- Path
skills/collaboration/writing-plans/SKILL.md- Repo updated
- 9 October 2025
FAQ
What does the Writing Plans skill do?
Create detailed implementation plans with bite-sized tasks for engineers with zero codebase context
How do I install the Writing Plans skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add obra/clank --skill Writing Plans. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Writing Plans popular?
It lives in obra/clank, which has 43 GitHub stars and 26 forks.
Related skills
Gardening Skills Wiki
43obra/clank
Maintain skills wiki health - check links, naming, cross-references, and coverage
Remembering Conversations
43obra/clank
Search previous Claude Code conversations for facts, patterns, decisions, and context using semantic or text search
Brainstorming Ideas Into Designs
43obra/clank
Interactive idea refinement using Socratic method to develop fully-formed designs
Architectural Proposals
45Azure-Samples/agent-skills-dotnet-demo
How to write comprehensive architectural proposals that drive alignment before code is written
Writing Evergreen Comments
43obra/clank
Write comments explaining WHAT and WHY, never temporal context or history
Docs Standards
45Azure-Samples/agent-skills-dotnet-demo
Microsoft Style Guide + Squad-specific documentation patterns
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.