writing-plans

Generate structured implementation plans with tasks, tests, and validation steps.

Updated Apr 15, 2026
One-click install
npx skills add https://github.com/YangYuS8/dev-2026-grading --skill writing-plans-yangyus8
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/YangYuS8/dev-2026-grading/tree/main/.opencode/skills/writing-plans
Command: npx skills add https://github.com/YangYuS8/dev-2026-grading --skill writing-plans-yangyus8

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan and document multi-step software tasks before implementation to reduce rework, scope creep, and miscommunication across teams.

Core Features & Use Cases

  • Structured plan templates for breaking complex requirements into small tasks, file changes, tests, and validation steps.
  • DRY, YAGNI, TDD oriented guidance to encourage incremental, testable plans and frequent commits.
  • Execution handoff guidance for transitioning plans into subagents or inline runs, with clear checkpoints and headers.
  • Comprehensive plan documentation that captures scope, interfaces, risks, and success criteria.

Quick Start

Create a new plan document with the required header, then outline tasks, files to modify, tests, and how to validate them.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I plan multi-step software development tasks before coding?

Plan multi-step software development tasks by generating a structured plan document with a mandatory header, explicit per-task steps, validation criteria, and clear execution handoffs. This reduces rework and scope creep by breaking complex requirements into small, testable file changes.

What is task breakdown for multiple agents in a project workflow?

Task breakdown for multiple agents is decomposing multi-step software requirements into discrete file changes, tests, and toolchain steps. This process creates traceable commits and clear handoffs, allowing different agents or environments to execute software development tasks independently.

How do I write an implementation plan document for test-driven development?

Write an implementation plan document for test-driven development by outlining tasks, files to modify, tests, and validation steps. This skill enforces DRY, YAGNI, and TDD oriented guidance to encourage incremental, testable plans with frequent commits and rigorous validation.

Does test-driven planning work for multi-module software projects?

Test-driven planning works for multi-module software projects requiring precise file changes and toolchain steps. It captures scope, interfaces, risks, and success criteria within a comprehensive plan document, ensuring traceable commits and clear execution handoffs across modules.

What's the best way to handle execution handoffs to subagents?

Handle execution handoffs to subagents by using a structured plan document with clear checkpoints and headers. This skill provides execution handoff guidance for transitioning plans into subagents or inline runs, ensuring traceable commits and avoiding placeholders.

When should I not use a structured plan document for software tasks?

You should not use a structured plan document for simple software tasks that do not require multi-step decomposition, precise file changes across modules, or multiple agent handoffs. It is designed for complex projects needing rigorous validation steps and traceable commits.