writing-plans

Convert written specs into step-by-step implementation plans saved under docs/plans.

Updated Jan 28, 2026
One-click install
npx skills add https://github.com/kckylechen1/ai-agent-toolkit --skill writing-plans-kckylechen1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/kckylechen1/ai-agent-toolkit/tree/main/skills/writing-plans
Command: npx skills add https://github.com/kckylechen1/ai-agent-toolkit --skill writing-plans-kckylechen1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill turns a formal spec or requirements document into a structured, executable implementation plan, guiding engineers through tasks, tests, and documentation before coding begins.

Core Features & Use Cases

  • Plan generation from a spec for multi-step features, including which files to touch, tests to write, docs to update, and how to validate success.
  • Task granularity drafting: break down work into clear, incremental steps with file paths and command examples.
  • Use Case: Given a feature spec, generate a step-by-step plan and save it to docs/plans/2026-02-08-feature.md.

Quick Start

Use the writing-plans skill to generate an implementation plan from a provided spec and save it to docs/plans/YYYY-MM-DD-<feature-name>.md

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I convert a feature spec into an actionable implementation plan?

To convert a feature spec into an implementation plan, provide the written requirements to generate a step-by-step plan. This process breaks down multi-step features into incremental tasks, specifying files to touch, tests to write, and docs to update.

What is the best way to break down software engineering tasks before coding?

The best way to break down software engineering tasks is generating a structured plan that enforces TDD, DRY, and YAGNI principles. This ensures task granularity drafting defines clear incremental steps with file paths and command examples before coding begins.

How does task granularity drafting work for multi-step features?

Task granularity drafting for multi-step features works by breaking work into clear, incremental steps. It explicitly defines which files to touch, tests to write, documentation to update, and command examples to execute for validating success.

Does generating implementation plans enforce TDD, DRY, and YAGNI principles?

Generating implementation plans does enforce TDD, DRY, and YAGNI principles. It ensures tasks, tests, and documentation are clearly defined before coding begins, guiding engineers through structured execution saved under the docs/plans directory.

Can I save generated implementation plans to a specific directory structure?

You can save generated implementation plans to a specific directory structure. The skill enforces saving the output plan file directly under docs/plans, specifically using the YYYY-MM-DD-<feature-name>.md naming convention for organization.

When do I need to generate an implementation plan from a spec?

You need to generate an implementation plan from a spec when tackling multi-step features requiring structured execution. It is necessary when you must define task breakdowns, test strategies, and documentation updates clearly before starting the actual coding phase.