writing-plans

Generate task-by-task implementation plans with file changes, tests, and commits.

7|2|Updated Feb 20, 2026
One-click install
npx skills add https://github.com/PracticalSwan/agent-skills --skill writing-plans-practicalswan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/PracticalSwan/agent-skills/tree/main/writing-plans
Command: npx skills add https://github.com/PracticalSwan/agent-skills --skill writing-plans-practicalswan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill streamlines the development process by creating detailed, step-by-step implementation plans for complex tasks, ensuring clarity and reducing ambiguity for engineers.

Core Features & Use Cases

  • Bite-Sized Task Granularity: Breaks down large features into small, actionable steps (e.g., write failing test, implement, commit).
  • Comprehensive Documentation: Specifies exact files to modify, code snippets, testing commands, and commit messages.
  • Use Case: When starting a new feature, use this Skill to generate a plan that guides a developer through every necessary code change, test, and commit, even if they are unfamiliar with the codebase.

Quick Start

Use the writing-plans skill to create an implementation plan for adding user authentication.

Frequently Asked Questions about writing-plans

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I break down a complex software feature into an implementation plan?

An implementation plan breaks down complex software features into granular, actionable steps. It specifies exact file modifications, code snippets, testing procedures, and commit instructions to reduce ambiguity and guide developers through every necessary code change.

What is the best way to document a development workflow for unfamiliar codebases?

The best way to document a development workflow for unfamiliar codebases is to create detailed, step-by-step implementation guides that outline specific file modifications, testing commands, and commit messages, ensuring clarity and reducing ambiguity for engineers with limited context.

How do I generate a step-by-step coding task breakdown for TDD workflows?

You generate a step-by-step coding task breakdown for TDD workflows by creating bite-sized tasks that sequence writing failing tests, implementing code, and committing changes. This granular approach adheres to best practices like TDD and DRY.

Does this implementation plan generation work for engineers with limited project context?

Yes, implementation plan generation works explicitly for engineers with limited project context. It ensures clarity by providing comprehensive documentation that specifies exact files to modify, code examples, testing commands, and commit messages for every necessary code change.

Can I include specific code examples and commit instructions in my development plan?

Yes, you can include specific code examples and commit instructions in your development plan. The generated documentation provides comprehensive details, specifying exact files to modify, code snippets, testing commands, and exact commit messages for each task.

When do I need a detailed task-by-task implementation guide for software development?

You need a detailed task-by-task implementation guide when starting a new feature that requires reducing ambiguity. It is designed to guide developers through necessary code changes, tests, and commits, ensuring adherence to best practices even in unfamiliar codebases.