writing-plans
Use when you have a spec or requirements for a multi-step task, before touching code
Security Assessment
About writing-plans
The writing-plans skill is designed to assist developers in creating comprehensive implementation plans for multi-step tasks, particularly when they have little to no context regarding the existing codebase. By providing clear instructions and bite-sized tasks, this skill helps ensure that developers can execute their work efficiently and effectively, addressing the common pitfalls of miscommunication and incomplete understanding of project requirements. This structured approach minimizes ambiguity and sets a clear path for execution, which is essential in collaborative coding environments.
Key features of the writing-plans skill include the ability to create detailed task structures that outline necessary actions, required files, and specific testing protocols. Each task is broken down into manageable steps, promoting best practices such as DRY (Don't Repeat Yourself), YAGNI (You Aren't Gonna Need It), and TDD (Test-Driven Development). This skill is particularly beneficial for skilled developers who may not be familiar with the specific toolsets or problem domains of a new project, ensuring they have the guidance needed to contribute effectively from the start.
Use cases for the writing-plans skill include onboarding new developers to a project, enhancing documentation practices, and streamlining collaboration between teams. Target users are software engineers looking to maintain high standards in their development processes, particularly in agile environments where rapid iterations and frequent commits are essential for success.
FAQ
How do I start using the writing-plans skill?
You can start by announcing that you are using the writing-plans skill to create an implementation plan.
What file format should the plans be saved in?
Plans should be saved in Markdown format with the naming convention `docs/plans/YYYY-MM-DD-<feature-name>.md`.
What is the recommended task granularity?
Each task should consist of a single action that can be completed in 2-5 minutes.
Can this skill be used for any programming language?
While the skill is applicable to any programming environment, it assumes familiarity with Python syntax for code examples.
What are the execution options after saving a plan?
You can choose between a Subagent-Driven approach or a Parallel Session for executing the tasks.
Install writing-plans
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
obra/superpowers