writing-plans

Transform product or engineering specs into task-by-task Markdown implementation plans.

1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/TruCol270/salty-pickle --skill writing-plans-trucol270
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/TruCol270/salty-pickle/tree/main/.claude-skills/writing-plans
Command: npx skills add https://github.com/TruCol270/salty-pickle --skill writing-plans-trucol270

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams convert a written spec or requirements into a complete, executable implementation plan for engineers, reducing ambiguity and guiding task decomposition.

Core Features & Use Cases

  • Comprehensive planning: generates step-by-step tasks, files touched, tests, and documentation requirements.
  • Structured plans: organizes work into plan sections, with clear ownership and checkpoints.
  • Knowledge transfer: enables engineers to work with zero context by providing all necessary guidance in one plan.

Quick Start

Generate a plan from the provided spec and save it to docs/superpowers/plans/YYYY-MM-DD-writing-plans.md.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I turn a product spec into an actionable engineering plan?

To turn a product spec into an engineering plan, you decompose requirements into step-by-step tasks, file touchpoints, testing steps, and documentation checkpoints, outputting a structured Markdown plan file.

What is task decomposition in software implementation planning?

Task decomposition is breaking down a written specification into comprehensive, executable tasks that map specific files, tests, and documentation requirements, enabling engineers to work with zero context.

How do I generate a version-control-ready implementation plan for a multi-step software project?

You generate a version-control-ready implementation plan by transforming your spec into a structured document with clear ownership, testing guides, and file touchpoints, saved as a Markdown file.

Can I use this to create a testing guide alongside task mapping for my engineering spec?

Yes, the plan generation process explicitly outputs testing steps and documentation requirements alongside task mapping and file touchpoints, ensuring comprehensive coverage for engineering teams.

Does this planning approach work for any multi-step tooling project?

Yes, this approach works for any multi-step software or tooling project where you need to map tasks, files, tests, and documentation before coding begins, regardless of specific stack.