{"id":"2c81b181-6d21-4573-8343-82d21ede5d04","shortId":"Kz5yqY","kind":"skill","title":"writing-plans","tagline":"Use when you have a spec or requirements for a multi-step task, before touching code","description":"# Writing Plans\n\n## Overview\n\nWrite comprehensive implementation plans assuming the engineer has zero context for our codebase and questionable taste. Document everything they need to know: which files to touch for each task, code, testing, docs they might need to check, how to test it. Give them the whole plan as bite-sized tasks. DRY. YAGNI. TDD. Frequent commits.\n\nAssume they are a skilled developer, but know almost nothing about our toolset or problem domain. Assume they don't know good test design very well.\n\n**Announce at start:** \"I'm using the writing-plans skill to create the implementation plan.\"\n\n**Context:** This should be run in a dedicated worktree (created by brainstorming skill).\n\n**Save plans to:** `docs/plans/YYYY-MM-DD-<feature-name>.md`\n\n## Bite-Sized Task Granularity\n\n**Each step is one action (2-5 minutes):**\n- \"Write the failing test\" - step\n- \"Run it to make sure it fails\" - step\n- \"Implement the minimal code to make the test pass\" - step\n- \"Run the tests and make sure they pass\" - step\n- \"Commit\" - step\n\n## Plan Document Header\n\n**Every plan MUST start with this header:**\n\n```markdown\n# [Feature Name] Implementation Plan\n\n> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.\n\n**Goal:** [One sentence describing what this builds]\n\n**Architecture:** [2-3 sentences about approach]\n\n**Tech Stack:** [Key technologies/libraries]\n\n---\n```\n\n## Task Structure\n\n```markdown\n### Task N: [Component Name]\n\n**Files:**\n- Create: `exact/path/to/file.py`\n- Modify: `exact/path/to/existing.py:123-145`\n- Test: `tests/exact/path/to/test.py`\n\n**Step 1: Write the failing test**\n\n```python\ndef test_specific_behavior():\n    result = function(input)\n    assert result == expected\n```\n\n**Step 2: Run test to verify it fails**\n\nRun: `pytest tests/path/test.py::test_name -v`\nExpected: FAIL with \"function not defined\"\n\n**Step 3: Write minimal implementation**\n\n```python\ndef function(input):\n    return expected\n```\n\n**Step 4: Run test to verify it passes**\n\nRun: `pytest tests/path/test.py::test_name -v`\nExpected: PASS\n\n**Step 5: Commit**\n\n```bash\ngit add tests/path/test.py src/path/file.py\ngit commit -m \"feat: add specific feature\"\n```\n```\n\n## Remember\n- Exact file paths always\n- Complete code in plan (not \"add validation\")\n- Exact commands with expected output\n- Reference relevant skills with @ syntax\n- DRY, YAGNI, TDD, frequent commits\n\n## Execution Handoff\n\nAfter saving the plan, offer execution choice:\n\n**\"Plan complete and saved to `docs/plans/<filename>.md`. Two execution options:**\n\n**1. Subagent-Driven (this session)** - I dispatch fresh subagent per task, review between tasks, fast iteration\n\n**2. Parallel Session (separate)** - Open new session with executing-plans, batch execution with checkpoints\n\n**Which approach?\"**\n\n**If Subagent-Driven chosen:**\n- **REQUIRED SUB-SKILL:** Use superpowers:subagent-driven-development\n- Stay in this session\n- Fresh subagent per task + code review\n\n**If Parallel Session chosen:**\n- Guide them to open new session in worktree\n- **REQUIRED SUB-SKILL:** New session uses superpowers:executing-plans\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\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":["writing","plans","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows"],"capabilities":["skill","source-sickn33","skill-writing-plans","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/writing-plans","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 · 34404 github stars · SKILL.md body (3,558 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-22T00:52:00.397Z","embedding":null,"createdAt":"2026-04-18T21:47:47.391Z","updatedAt":"2026-04-22T00:52:00.397Z","lastSeenAt":"2026-04-22T00:52:00.397Z","tsv":"'-145':251 '-3':230 '-5':151 '1':255,379 '123':250 '2':150,229,272,396 '3':292 '4':303 '5':319 'action':149,473 'add':323,330,343 'almost':88 'alway':337 'announc':106 'applic':467 'approach':233,412 'architectur':228 'ask':511 'assert':268 'assum':28,80,96 'bash':321 'batch':407 'behavior':264 'bite':72,141 'bite-s':71,140 'boundari':519 'brainstorm':133 'build':227 'check':60 'checkpoint':410 'choic':368 'chosen':417,441 'clarif':513 'claud':203 'clear':486 'code':20,53,169,339,436 'codebas':36 'command':346 'commit':79,185,320,327,359 'complet':338,370 'compon':243 'comprehens':25 'context':33,122 'creat':118,131,246 'criteria':522 'dedic':129 'def':261,297 'defin':290 'describ':224,474,490 'design':103 'develop':85,427 'dispatch':386 'doc':55 'docs/plans':374 'docs/plans/yyyy-mm-dd-':138 'document':40,188 'domain':95 'dri':75,355 'driven':382,416,426 'engin':30 'environ':502 'environment-specif':501 'everi':190 'everyth':41 'exact':334,345 'exact/path/to/existing.py':249 'exact/path/to/file.py':247 'execut':211,360,367,377,405,408,459,469 'executing-plan':210,404,458 'expect':270,285,301,316,348 'expert':507 'fail':155,164,258,278,286 'fast':394 'feat':329 'featur':198,332 'file':47,245,335 'frequent':78,358 'fresh':387,432 'function':266,288,298 'git':322,326 'give':65 'goal':221 'good':101 'granular':144 'guid':442 'handoff':361 'header':189,196 'implement':26,120,166,200,214,295 'input':267,299,516 'iter':395 'key':236 'know':45,87,100 'limit':478 'm':110,328 'make':161,171,180 'markdown':197,240 'match':487 'md':139,375 'might':57 'minim':168,294 'minut':152 'miss':524 'modifi':248 'multi':15 'multi-step':14 'must':192 'n':242 'name':199,244,283,314 'need':43,58 'new':401,446,454 'noth':89 'offer':366 'one':148,222 'open':400,445 'option':378 'output':349,496 'overview':23,477 'parallel':397,439 'pass':174,183,309,317 'path':336 'per':389,434 'permiss':517 'plan':3,22,27,69,115,121,136,187,191,201,212,216,341,365,369,406,460 'problem':94 'pytest':280,311 'python':260,296 'question':38 'refer':350 'relev':351 'rememb':333 'requir':11,204,418,450,515 'result':265,269 'return':300 'review':391,437,508 'run':126,158,176,273,279,304,310 'safeti':518 'save':135,363,372 'scope':489 'sentenc':223,231 'separ':399 'session':384,398,402,431,440,447,455 'size':73,142 'skill':84,116,134,207,352,421,453,465,481 'skill-writing-plans' 'source-sickn33' 'spec':9 'specif':263,331,503 'src/path/file.py':325 'stack':235 'start':108,193 'stay':428 'step':16,146,157,165,175,184,186,254,271,291,302,318 'stop':509 'structur':239 'sub':206,420,452 'sub-skil':205,419,451 'subag':381,388,415,425,433 'subagent-driven':380,414 'subagent-driven-develop':424 'substitut':499 'success':521 'superpow':209,423,457 'sure':162,181 'syntax':354 'task':17,52,74,143,218,220,238,241,390,393,435,485 'task-by-task':217 'tast':39 'tdd':77,357 'tech':234 'technologies/libraries':237 'test':54,63,102,156,173,178,252,259,262,274,282,305,313,505 'tests/exact/path/to/test.py':253 'tests/path/test.py':281,312,324 'toolset':92 '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':19,49 'treat':494 'two':376 'use':4,111,208,422,456,463,479 'v':284,315 'valid':344,504 'verifi':276,307 'well':105 'whole':68 'workflow':471 'worktre':130,449 'write':2,21,24,114,153,256,293 'writing-plan':1,113 'yagni':76,356 'zero':32","prices":[{"id":"fc90a949-c468-4093-9620-9cee1278bc32","listingId":"2c81b181-6d21-4573-8343-82d21ede5d04","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:47:47.391Z"}],"sources":[{"listingId":"2c81b181-6d21-4573-8343-82d21ede5d04","source":"github","sourceId":"sickn33/antigravity-awesome-skills/writing-plans","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/writing-plans","isPrimary":false,"firstSeenAt":"2026-04-18T21:47:47.391Z","lastSeenAt":"2026-04-22T00:52:00.397Z"}],"details":{"listingId":"2c81b181-6d21-4573-8343-82d21ede5d04","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"writing-plans","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34404,"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-21T16:43:40Z","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":"f7a80b60a16121217838c15ca8ff55855062e273","skill_md_path":"skills/writing-plans/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/writing-plans"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"writing-plans","description":"Use when you have a spec or requirements for a multi-step task, before touching code"},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/writing-plans"},"updatedAt":"2026-04-22T00:52:00.397Z"}}