writing-plans

Generate detailed implementation plans with exact file paths and code examples.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Theopsguide/claude-agents --skill writing-plans-theopsguide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/Theopsguide/claude-agents/tree/main/plugins/development-workflow/skills/writing-plans
Command: npx skills add https://github.com/Theopsguide/claude-agents --skill writing-plans-theopsguide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the challenge of creating actionable implementation plans for engineers who may lack codebase or domain context. It ensures plans are comprehensive, with exact file paths, complete code examples, and clear verification steps, enabling efficient and error-free execution, regardless of the implementer's prior knowledge.

Core Features & Use Cases

  • Bite-Sized Tasks: Breaks down implementation into small, atomic steps (2-5 minutes each).
  • Zero-Context Guidance: Provides all necessary information, assuming minimal domain knowledge from the implementer.
  • Exact Code & Commands: Includes complete code snippets and precise command-line instructions with expected outputs.
  • Test-Driven Development (TDD) Integration: Guides the engineer through writing failing tests before implementing solutions.
  • Use Case: After a design is approved, use this Skill to generate a detailed plan for a new feature. This plan can then be handed off to any developer, ensuring they can implement the feature correctly and efficiently without constant clarification.

Quick Start

Example: Task Structure

Task N: [Component Name]

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 def test_specific_behavior(): result = function(input) assert result == expected

Step 2: Run test to verify it fails Run: pytest tests/path/test.py::test_name -v Expected: FAIL with "function not defined"