skills.rest
snits
snitsCOMMUNITY
Explore all skills by this author →
GitHub

writing-plans

Generate detailed implementation plans with expert-validated atomic tasks.

1|2|Updated Aug 7, 2025
Search Tags:#planning#task management#TDD#software development#code generation#implementation#expert validation
One-click install
npx skills add https://github.com/snits/claude-files --skill writing-plans-snits
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/snits/claude-files/tree/main/skills/writing-plans
Command: npx skills add https://github.com/snits/claude-files --skill writing-plans-snits

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translating a high-level design into actionable, error-free implementation steps can be challenging, especially for complex features or when working with developers unfamiliar with the codebase. This Skill ensures plans are precise, expert-validated, and ready for execution, eliminating ambiguity and reducing rework.

Core Features & Use Cases

  • Expert-Validated Tasks: Consults domain-specific agents (security, performance, database) to validate technical approaches before detailing steps, ensuring best practices are followed.
  • Bite-Sized Granularity: Breaks down implementation into atomic, 2-5 minute tasks, including TDD steps and commit instructions, making complex projects manageable.
  • Comprehensive Detail: Provides exact file paths, complete code examples, commands, and expected outputs for each step, leaving no room for guesswork.
  • Use Case: After a design is approved, use this Skill to generate a plan for adding a new API endpoint. It will first consult a "security specialist" agent to validate the authentication approach, then a "database specialist" for schema changes, and finally produce a step-by-step plan with exact code for tests, implementation, and commits. This ensures a smooth, high-quality development process, letting AI handle the meticulous planning.

Quick Start

Example: Structure of a detailed implementation task

Task N: [Component Name]

Subagent to Task: [subagent that will be tasked]

Files:

  • Create: exact/path/to/file.py
  • Modify: exact/path/to/existing.py:123-145
  • Test: tests/exact/path/to/test.py

Step 1: Write the failing test

... code ...

Step 2: Run test to verify it fails

... command ...

Step 3: Write minimal implementation

... code ...

Step 4: Run test to verify it passes

... command ...

Step 5: Commit

... git commands ...