{"id":"3bd3380f-ce6a-4d3d-b4e0-6e4f9526d838","shortId":"kNt4ug","kind":"skill","title":"plan-writing","tagline":"Structured task planning with clear breakdowns, dependencies, and verification criteria. Use when implementing features, refactoring, or any multi-step work.","description":"# Plan Writing\n\n> Source: obra/superpowers\n\n## Overview\nThis skill provides a framework for breaking down work into clear, actionable tasks with verification criteria.\n\n## Task Breakdown Principles\n\n### 1. Small, Focused Tasks\n- Each task should take 2-5 minutes\n- One clear outcome per task\n- Independently verifiable\n\n### 2. Clear Verification\n- How do you know it's done?\n- What can you check/test?\n- What's the expected output?\n\n### 3. Logical Ordering\n- Dependencies identified\n- Parallel work where possible\n- Critical path highlighted\n- **Phase X: Verification is always LAST**\n\n### 4. Dynamic Naming in Project Root\n- Plan files are saved as `{task-slug}.md` in the PROJECT ROOT\n- Name derived from task (e.g., \"add auth\" → `auth-feature.md`)\n- **NEVER** inside `.claude/`, `docs/`, or temp folders\n\n## Planning Principles (NOT Templates!)\n\n> 🔴 **NO fixed templates. Each plan is UNIQUE to the task.**\n\n### Principle 1: Keep It SHORT\n\n| ❌ Wrong | ✅ Right |\n|----------|----------|\n| 50 tasks with sub-sub-tasks | 5-10 clear tasks max |\n| Every micro-step listed | Only actionable items |\n| Verbose descriptions | One-line per task |\n\n> **Rule:** If plan is longer than 1 page, it's too long. Simplify.\n\n---\n\n### Principle 2: Be SPECIFIC, Not Generic\n\n| ❌ Wrong | ✅ Right |\n|----------|----------|\n| \"Set up project\" | \"Run `npx create-next-app`\" |\n| \"Add authentication\" | \"Install next-auth, create `/api/auth/[...nextauth].ts`\" |\n| \"Style the UI\" | \"Add Tailwind classes to `Header.tsx`\" |\n\n> **Rule:** Each task should have a clear, verifiable outcome.\n\n---\n\n### Principle 3: Dynamic Content Based on Project Type\n\n**For NEW PROJECT:**\n- What tech stack? (decide first)\n- What's the MVP? (minimal features)\n- What's the file structure?\n\n**For FEATURE ADDITION:**\n- Which files are affected?\n- What dependencies needed?\n- How to verify it works?\n\n**For BUG FIX:**\n- What's the root cause?\n- What file/line to change?\n- How to test the fix?\n\n---\n\n### Principle 4: Scripts Are Project-Specific\n\n> 🔴 **DO NOT copy-paste script commands. Choose based on project type.**\n\n| Project Type | Relevant Scripts |\n|--------------|------------------|\n| Frontend/React | `ux_audit.py`, `accessibility_checker.py` |\n| Backend/API | `api_validator.py`, `security_scan.py` |\n| Mobile | `mobile_audit.py` |\n| Database | `schema_validator.py` |\n| Full-stack | Mix of above based on what you touched |\n\n**Wrong:** Adding all scripts to every plan\n**Right:** Only scripts relevant to THIS task\n\n---\n\n### Principle 5: Verification is Simple\n\n| ❌ Wrong | ✅ Right |\n|----------|----------|\n| \"Verify the component works correctly\" | \"Run `npm run dev`, click button, see toast\" |\n| \"Test the API\" | \"curl localhost:3000/api/users returns 200\" |\n| \"Check styles\" | \"Open browser, verify dark mode toggle works\" |\n\n---\n\n## Plan Structure (Flexible, Not Fixed!)\n\n```\n# [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```\n\n> **That's it.** No phases, no sub-sections unless truly needed.\n> Keep it minimal. Add complexity only when required.\n\n## Notes\n[Any important considerations]\n```\n\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.","tags":["plan","writing","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows"],"capabilities":["skill","source-sickn33","skill-plan-writing","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/plan-writing","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34616 github stars · SKILL.md body (4,062 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-23T00:51:23.853Z","embedding":null,"createdAt":"2026-04-18T21:42:26.635Z","updatedAt":"2026-04-23T00:51:23.853Z","lastSeenAt":"2026-04-23T00:51:23.853Z","tsv":"'-10':167 '-5':58 '/api/auth':223 '1':49,153,192,413,469 '10':479 '2':57,67,200,421,477 '200':387 '3':86,244,429,487 '3000/api/users':385 '4':104,303,494 '5':166,361,503 '50':159 'accessibility_checker.py':327 'action':41,177,415,423,431 'ad':347,519 'add':128,216,229,456 'addit':272 'affect':276 'alway':102 'api':382 'api_validator.py':329 'app':215 'ask':563 'auth':129,221 'auth-feature.md':130 'authent':217 'backend/api':328 'base':247,317,341 'best':465 'boundari':571 'break':36,483 'breakdown':9,47 'browser':391 'bug':286,524 'building/fixing':410,476 'button':377 'caus':292 'chang':296 'check':388,419,427,435 'check/test':80 'choos':316 'clarif':565 'class':231 'claud':133 'clear':8,40,61,68,168,240,491,538 'click':376 'command':315 'complet':511 'complex':457,526 'compon':369 'consider':464 'content':246 'copi':312,500 'copy-past':311,499 'correct':371 'creat':213,222 'create-next-app':212 'criteria':13,45,440,493,574 'critic':95 'curl':383 'dark':393 'databas':333 'decid':257 'depend':10,89,278 'deriv':124 'describ':542 'descript':180 'dev':375 'doc':134 'done':76,436,492 'dynam':105,245 'e.g':127 'environ':554 'environment-specif':553 'everi':171,351 'expect':84 'expert':559 'featur':17,264,271,521 'file':111,268,274,529 'file/line':294 'first':258 'fix':143,287,301,401,522 'flexibl':399 'focus':51 'folder':137 'framework':34 'frontend/react':325 'full':336 'full-stack':335 'generic':204 'go':507 'goal':404,472 'header.tsx':233 'highlight':97 'identifi':90 'implement':16 'import':463 'independ':65 'input':568 'insid':132 'instal':218 'item':178 'keep':154,453 'know':73 'last':103 'limit':530 'line':183 'list':175 'localhost':384 'logic':87 'long':197 'longer':190 'main':438 'mark':508 'match':539 'max':170,478 'md':118 'micro':173 'micro-step':172 'minim':263,455 'minut':59 'miss':576 'mix':338 'mobil':331 'mobile_audit.py':332 'mode':394 'multi':22 'multi-step':21 'multipl':485,528 'mvp':262 'name':106,123,403 'need':279,452 'never':131 'new':252,515 'next':214,220 'next-auth':219 'nextauth':224 'note':461 'npm':373 'npx':211 'obra/superpowers':28 'one':60,182,405 'one-lin':181 'open':390 'order':88 'outcom':62,242 'output':85,548 'overview':29 'page':193 'parallel':91 'past':313,501 'path':96 'per':63,184 'permiss':569 'phase':98,445 'plan':2,6,25,110,138,146,188,352,397,486 'plan-writ':1 'possibl':94 'practic':466 'principl':48,139,152,199,243,302,360 'project':108,121,209,249,253,307,319,321,496,516 'project-specif':306,495 'provid':32 'quick':467 'refactor':18,527 'refer':468 'relev':323,356 'requir':460,567 'return':386 'review':560 'right':158,206,353,366 'root':109,122,291 'rule':186,234 'run':210,372,374 'safeti':570 'save':113 'schema_validator.py':334 'scope':541 'scratch':518 'script':304,314,324,349,355 'section':449 'security_scan.py':330 'see':378 'sentenc':406 'set':207 'short':156 'simpl':364 'simplifi':198 'skill':31,533 'skill-plan-writing' 'slug':117 'small':50 'sourc':27 'source-sickn33' 'specif':202,308,414,422,430,497,555 'stack':256,337 'start':470 'step':23,174 'stop':561 'structur':4,269,398 'style':226,389 'sub':163,164,448 'sub-sect':447 'sub-sub-task':162 'substitut':551 'success':439,573 'tailwind':230 'take':56 'task':5,42,46,52,54,64,116,126,151,160,165,169,185,236,359,402,411,412,420,428,480,489,537 'task-slug':115 'tech':255 'temp':136 'templat':141,144,502 'test':299,380,557 'toast':379 'toggl':395 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'touch':345 'treat':546 'truli':451 'ts':225 'type':250,320,322 'ui':228 'uniqu':148 'unless':450 'updat':504 'use':14,514,531 'ux_audit.py':326 'valid':556 'verbos':179 'verif':12,44,69,100,362 'verifi':66,241,282,367,392,416,424,432,490 'work':24,38,92,284,370,396 'write':3,26 'wrong':157,205,346,365 'x':99,509","prices":[{"id":"4b919a72-730d-4d99-824f-e94c0490352d","listingId":"3bd3380f-ce6a-4d3d-b4e0-6e4f9526d838","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:42:26.635Z"}],"sources":[{"listingId":"3bd3380f-ce6a-4d3d-b4e0-6e4f9526d838","source":"github","sourceId":"sickn33/antigravity-awesome-skills/plan-writing","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/plan-writing","isPrimary":false,"firstSeenAt":"2026-04-18T21:42:26.635Z","lastSeenAt":"2026-04-23T00:51:23.853Z"}],"details":{"listingId":"3bd3380f-ce6a-4d3d-b4e0-6e4f9526d838","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"plan-writing","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34616,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-22T06:40:00Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"6dcda3ef084272363310f18f6f122bbe94e87b48","skill_md_path":"skills/plan-writing/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/plan-writing"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"plan-writing","description":"Structured task planning with clear breakdowns, dependencies, and verification criteria. Use when implementing features, refactoring, or any multi-step work."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/plan-writing"},"updatedAt":"2026-04-23T00:51:23.853Z"}}