{"slug":"plan-writing","title":"plan-writing","summary":"Structured task planning with clear breakdowns, dependencies, and verification criteria. Use when implementing features, refactoring, or any multi-step work.","platform":"ChatGPT","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-08-16T13:38:45.203175Z","repo":{"url":"https://github.com/sickn33/agentic-awesome-skills","stars":46883,"forks":6831,"license":"MIT","updatedAt":"2026-09-25T05:43:16Z"},"bodyHtml":"<hr>\n<h2>name: plan-writing\ndescription: \"Structured task planning with clear breakdowns, dependencies, and verification criteria. Use when implementing features, refactoring, or any multi-step work.\"\nrisk: critical\nsource: community\ndate_added: \"2026-02-27\"</h2>\n<h1>Plan Writing</h1>\n<blockquote>\n<p>Source: obra/superpowers</p>\n</blockquote>\n<h2>Overview</h2>\n<p>This skill provides a framework for breaking down work into clear, actionable tasks with verification criteria.</p>\n<h2>Task Breakdown Principles</h2>\n<h3>1. Small, Focused Tasks</h3>\n<ul>\n<li>Each task should take 2-5 minutes</li>\n<li>One clear outcome per task</li>\n<li>Independently verifiable</li>\n</ul>\n<h3>2. Clear Verification</h3>\n<ul>\n<li>How do you know it's done?</li>\n<li>What can you check/test?</li>\n<li>What's the expected output?</li>\n</ul>\n<h3>3. Logical Ordering</h3>\n<ul>\n<li>Dependencies identified</li>\n<li>Parallel work where possible</li>\n<li>Critical path highlighted</li>\n<li><strong>Phase X: Verification is always LAST</strong></li>\n</ul>\n<h3>4. Dynamic Naming in Project Root</h3>\n<ul>\n<li>Plan files are saved as <code>{task-slug}.md</code> in the PROJECT ROOT</li>\n<li>Name derived from task (e.g., \"add auth\" → <code>auth-feature.md</code>)</li>\n<li><strong>NEVER</strong> inside <code>.claude/</code>, <code>docs/</code>, or temp folders</li>\n</ul>\n<h2>Planning Principles (NOT Templates!)</h2>\n<blockquote>\n<p>\uD83D\uDD34 <strong>NO fixed templates. Each plan is UNIQUE to the task.</strong></p>\n</blockquote>\n<h3>Principle 1: Keep It SHORT</h3>\n<table>\n<thead>\n<tr>\n<th>❌ Wrong</th>\n<th>✅ Right</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>50 tasks with sub-sub-tasks</td>\n<td>5-10 clear tasks max</td>\n</tr>\n<tr>\n<td>Every micro-step listed</td>\n<td>Only actionable items</td>\n</tr>\n<tr>\n<td>Verbose descriptions</td>\n<td>One-line per task</td>\n</tr>\n</tbody>\n</table>\n<blockquote>\n<p><strong>Rule:</strong> If plan is longer than 1 page, it's too long. Simplify.</p>\n</blockquote>\n<hr>\n<h3>Principle 2: Be SPECIFIC, Not Generic</h3>\n<table>\n<thead>\n<tr>\n<th>❌ Wrong</th>\n<th>✅ Right</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>\"Set up project\"</td>\n<td>\"Run <code>npx create-next-app</code>\"</td>\n</tr>\n<tr>\n<td>\"Add authentication\"</td>\n<td>\"Install next-auth, create <code>/api/auth/[...nextauth].ts</code>\"</td>\n</tr>\n<tr>\n<td>\"Style the UI\"</td>\n<td>\"Add Tailwind classes to <code>Header.tsx</code>\"</td>\n</tr>\n</tbody>\n</table>\n<blockquote>\n<p><strong>Rule:</strong> Each task should have a clear, verifiable outcome.</p>\n</blockquote>\n<hr>\n<h3>Principle 3: Dynamic Content Based on Project Type</h3>\n<p><strong>For NEW PROJECT:</strong></p>\n<ul>\n<li>What tech stack? (decide first)</li>\n<li>What's the MVP? (minimal features)</li>\n<li>What's the file structure?</li>\n</ul>\n<p><strong>For FEATURE ADDITION:</strong></p>\n<ul>\n<li>Which files are affected?</li>\n<li>What dependencies needed?</li>\n<li>How to verify it works?</li>\n</ul>\n<p><strong>For BUG FIX:</strong></p>\n<ul>\n<li>What's the root cause?</li>\n<li>What file/line to change?</li>\n<li>How to test the fix?</li>\n</ul>\n<hr>\n<h3>Principle 4: Scripts Are Project-Specific</h3>\n<blockquote>\n<p>\uD83D\uDD34 <strong>DO NOT copy-paste script commands. Choose based on project type.</strong></p>\n</blockquote>\n<table>\n<thead>\n<tr>\n<th>Project Type</th>\n<th>Relevant Scripts</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>Frontend/React</td>\n<td><code>ux_audit.py</code>, <code>accessibility_checker.py</code></td>\n</tr>\n<tr>\n<td>Backend/API</td>\n<td><code>api_validator.py</code>, <code>security_scan.py</code></td>\n</tr>\n<tr>\n<td>Mobile</td>\n<td><code>mobile_audit.py</code></td>\n</tr>\n<tr>\n<td>Database</td>\n<td><code>schema_validator.py</code></td>\n</tr>\n<tr>\n<td>Full-stack</td>\n<td>Mix of above based on what you touched</td>\n</tr>\n</tbody>\n</table>\n<p><strong>Wrong:</strong> Adding all scripts to every plan\n<strong>Right:</strong> Only scripts relevant to THIS task</p>\n<hr>\n<h3>Principle 5: Verification is Simple</h3>\n<table>\n<thead>\n<tr>\n<th>❌ Wrong</th>\n<th>✅ Right</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>\"Verify the component works correctly\"</td>\n<td>\"Run <code>npm run dev</code>, click button, see toast\"</td>\n</tr>\n<tr>\n<td>\"Test the API\"</td>\n<td>\"curl localhost:3000/api/users returns 200\"</td>\n</tr>\n<tr>\n<td>\"Check styles\"</td>\n<td>\"Open browser, verify dark mode toggle works\"</td>\n</tr>\n</tbody>\n</table>\n<hr>\n<h2>Plan Structure (Flexible, Not Fixed!)</h2>\n<pre><code># [Task Name]\n\n## Goal\nOne sentence: What are we building/fixing?\n\n## Tasks\n- [ ] Task 1: [Specific action] → Verify: [How to check]\n- [ ] Task 2: [Specific action] → Verify: [How to check]\n- [ ] Task 3: [Specific action] → Verify: [How to check]\n\n## Done When\n- [ ] [Main success criteria]\n</code></pre>\n<blockquote>\n<p><strong>That's it.</strong> No phases, no sub-sections unless truly needed.\nKeep it minimal. Add complexity only when required.</p>\n</blockquote>\n<h2>Notes</h2>\n<p>[Any important considerations]</p>\n<pre><code>\n---\n\n## Best Practices (Quick Reference)\n\n1. **Start with goal** - What are we building/fixing?\n2. **Max 10 tasks** - If more, break into multiple plans\n3. **Each task verifiable** - Clear \"done\" criteria\n4. **Project-specific** - No copy-paste templates\n5. **Update as you go** - Mark `[x]` when complete\n\n---\n\n## When to Use\n- New project from scratch\n- Adding a feature\n- Fixing a bug (if complex)\n- Refactoring multiple files\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.\n</code></pre>\n","files":[{"path":"SKILL.md","sizeBytes":4346,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-08-16T13:44:12.867289Z","sha256":"87E8ABB0C5E23CC27D65337FD03D43B8462C067A5D06681A3CC2F1F35581369A","sizeBytes":2248},"review":null,"source":{"repositoryUrl":"https://github.com/sickn33/agentic-awesome-skills","path":"skills/plan-writing","license":"MIT","commit":"f2bba339de74414b0771234cbe4f6a15258e32a3","subtreeSha":"08F4ED8B46E61E0044B879E13316E0FF83FB7387D916B7841CC0A70BEDF91CE5","lastSyncedAt":"2026-09-25T06:48:39.853703Z"},"reviewedAt":"2026-08-16T13:52:47.589402Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/plan-writing"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install sickn33-agentic-awesome-skills@llmmart"},{"target":"git","command":"git clone https://github.com/sickn33/agentic-awesome-skills.git"}]}