{"id":"a20ec67e-c9be-487c-971e-dd4bc7771451","shortId":"WsUzv6","kind":"skill","title":"planner","tagline":"Create structured plans for multi-task projects that can be used by the task-orchestrator skill. Use when breaking down complex work into parallel and sequential tasks with dependencies.","description":"# Planner\n\nCreate structured, orchestrator-ready plans for multi-task projects.\n\n**Source**: Adapted from am-will's codex-skills workflow patterns\n**Pairs with**: task-orchestrator skill for follow-on implementation\n\n---\n\n## Quick Start\n\nLoad the full planner prompt from `prompts/planner.md` and follow its process:\n\n1. **Phase 0**: Clarify requirements (ask up to 5 targeted questions)\n2. **Phase 1**: Research & understand the codebase\n3. **Phase 2**: Create detailed plan with sprints, tasks, acceptance criteria\n4. **Phase 3**: Subagent review of the plan\n5. **Phase 4**: Return the plan in markdown and save a file only if the user asked for a persisted artifact\n\n---\n\n## Key Principles\n\n### Task Atomicity\nEach task must be:\n- **Atomic and committable** — small, independent pieces of work\n- **Specific and actionable** — not vague\n- **Testable** — include tests or validation method\n- **Located** — include file paths and code locations\n\n### Bad vs Good Task Breakdown\n\n❌ Bad: \"Implement third-party sign-in\"\n\n✓ Good:\n- \"Add sign-in config to environment variables\"\n- \"Install and configure the required authentication package\"\n- \"Create sign-in callback route handler in src/routes/auth.ts\"\n- \"Add the sign-in button to the login UI\"\n\n### Sprint Structure\n\nEach sprint must:\n- Result in a **demoable, runnable, testable** increment\n- Build on prior sprint work\n- Include clear demo/verification checklist\n\n---\n\n## Plan Template\n\n```markdown\n# Plan: [Task Name]\n\n**Generated**: [Date]\n**Estimated Complexity**: [Low/Medium/High]\n\n## Overview\n[Brief summary of what needs to be done and the general approach]\n\n## Prerequisites\n- [Dependencies or requirements that must be met first]\n- [Tools, libraries, or access needed]\n- [Tooling limitations, e.g., browser relay/CDP restrictions]\n\n## Sprint 1: [Sprint Name]\n**Goal**: [What this sprint accomplishes]\n**Demo/Validation**:\n- [How to run/demo this sprint's output]\n- [What to verify]\n\n### Task 1.1: [Task Name]\n- **Location**: [File paths or components involved]\n- **Description**: [What needs to be done]\n- **Perceived Complexity**: [1-10]\n- **Dependencies**: [Any previous tasks this depends on]\n- **Acceptance Criteria**:\n  - [Specific, testable criteria]\n- **Validation**:\n  - [Test(s) or alternate validation steps]\n\n### Task 1.2: [Task Name]\n[...]\n\n## Sprint 2: [Sprint Name]\n[...]\n\n## Testing Strategy\n- [How to test the implementation]\n- [What to verify at each sprint]\n\n## Potential Risks\n- [Things that could go wrong]\n- [Mitigation strategies]\n\n## Rollback Plan\n- [How to undo changes if needed]\n```\n\n---\n\n## Hand-off\n\nOnce plan is ready, hand off to the **parallel-task worker**:\n\n```\nPlease run parallel-task.md against my-plan.md\n```\n\nOr invoke directly:\n> \"Run all unblocked tasks in plan.md using parallel subagents. Keep looping until all tasks are complete.\"\n\n## Safety Boundaries\n\n- Do not save a plan file unless the user asked for one or the surrounding workflow explicitly needs a persisted artifact.\n- Do not assign overlapping write scopes to parallel tasks without calling out the conflict.\n- Do not invent dependencies, validation steps, or completion status that the repo context does not support.\n- Do not turn a planning request into implementation work unless the user explicitly asks to move from planning to implementation.\n\n---\n\n## Files\n\n- `prompts/planner.md` — Full planner agent prompt\n- `prompts/parallel-task.md` — Parallel task worker prompt\n\nBoth are based on am-will's codex-skills prompts.","tags":["planner","agent","skills","jdrhyne","agent-skills","agentic-ai","ai-agents","automation","claude-code","clawdbot","codex","cursor"],"capabilities":["skill","source-jdrhyne","skill-planner","topic-agent-skills","topic-agentic-ai","topic-ai-agents","topic-automation","topic-claude-code","topic-clawdbot","topic-codex","topic-cursor","topic-developer-tools","topic-gemini-cli","topic-github-copilot","topic-llm-agents"],"categories":["agent-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/jdrhyne/agent-skills/planner","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add jdrhyne/agent-skills","source_repo":"https://github.com/jdrhyne/agent-skills","install_from":"skills.sh"}},"qualityScore":"0.565","qualityRationale":"deterministic score 0.56 from registry signals: · indexed on github topic:agent-skills · 230 github stars · SKILL.md body (3,490 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:54:19.792Z","embedding":null,"createdAt":"2026-04-18T22:05:03.689Z","updatedAt":"2026-04-22T00:54:19.792Z","lastSeenAt":"2026-04-22T00:54:19.792Z","tsv":"'-10':325 '0':83 '1':81,94,287,324 '1.1':307 '1.2':346 '2':92,101,350 '3':99,112 '4':110,120 '5':89,118 'accept':108,333 'access':278 'accomplish':294 'action':157 'adapt':46 'add':187,211 'agent':499 'altern':342 'am-wil':48,510 'approach':265 'artifact':138,444 'ask':86,134,433,488 'assign':447 'atom':142,147 'authent':200 'bad':173,178 'base':508 'boundari':423 'break':22 'breakdown':177 'brief':254 'browser':283 'build':233 'button':216 'call':455 'callback':206 'chang':380 'checklist':241 'clarifi':84 'clear':239 'code':171 'codebas':98 'codex':53,515 'codex-skil':52,514 'committ':149 'complet':421,466 'complex':24,251,323 'compon':314 'config':191 'configur':197 'conflict':458 'context':471 'could':370 'creat':2,34,102,202 'criteria':109,334,337 'date':249 'demo/validation':295 'demo/verification':240 'demoabl':229 'depend':32,267,326,331,462 'descript':316 'detail':103 'direct':405 'done':261,321 'e.g':282 'environ':193 'estim':250 'explicit':440,487 'file':129,168,311,429,495 'first':274 'follow':65,78 'follow-on':64 'full':72,497 'general':264 'generat':248 'go':371 'goal':290 'good':175,186 'hand':384,390 'hand-off':383 'handler':208 'implement':67,179,359,482,494 'includ':161,167,238 'increment':232 'independ':151 'instal':195 'invent':461 'invok':404 'involv':315 'keep':415 'key':139 'librari':276 'limit':281 'load':70 'locat':166,172,310 'login':219 'loop':416 'low/medium/high':252 'markdown':125,244 'met':273 'method':165 'mitig':373 'move':490 'multi':7,42 'multi-task':6,41 'must':145,225,271 'my-plan.md':402 'name':247,289,309,348,352 'need':258,279,318,382,441 'one':435 'orchestr':18,37,61 'orchestrator-readi':36 'output':302 'overlap':448 'overview':253 'packag':201 'pair':57 'parallel':27,395,413,452,502 'parallel-task':394 'parallel-task.md':400 'parti':182 'path':169,312 'pattern':56 'perceiv':322 'persist':137,443 'phase':82,93,100,111,119 'piec':152 'plan':4,39,104,117,123,242,245,376,387,428,479,492 'plan.md':411 'planner':1,33,73,498 'pleas':398 'potenti':366 'prerequisit':266 'previous':328 'principl':140 'prior':235 'process':80 'project':9,44 'prompt':74,500,505,517 'prompts/parallel-task.md':501 'prompts/planner.md':76,496 'question':91 'quick':68 'readi':38,389 'relay/cdp':284 'repo':470 'request':480 'requir':85,199,269 'research':95 'restrict':285 'result':226 'return':121 'review':114 'risk':367 'rollback':375 'rout':207 'run':399,406 'run/demo':298 'runnabl':230 'safeti':422 'save':127,426 'scope':450 'sequenti':29 'sign':184,189,204,214 'sign-in':183,188,203,213 'skill':19,54,62,516 'skill-planner' 'small':150 'sourc':45 'source-jdrhyne' 'specif':155,335 'sprint':106,221,224,236,286,288,293,300,349,351,365 'src/routes/auth.ts':210 'start':69 'status':467 'step':344,464 'strategi':354,374 'structur':3,35,222 'subag':113,414 'summari':255 'support':474 'surround':438 'target':90 'task':8,17,30,43,60,107,141,144,176,246,306,308,329,345,347,396,409,419,453,503 'task-orchestr':16,59 'templat':243 'test':162,339,353,357 'testabl':160,231,336 'thing':368 'third':181 'third-parti':180 'tool':275,280 'topic-agent-skills' 'topic-agentic-ai' 'topic-ai-agents' 'topic-automation' 'topic-claude-code' 'topic-clawdbot' 'topic-codex' 'topic-cursor' 'topic-developer-tools' 'topic-gemini-cli' 'topic-github-copilot' 'topic-llm-agents' 'turn':477 'ui':220 'unblock':408 'understand':96 'undo':379 'unless':430,484 'use':13,20,412 'user':133,432,486 'vagu':159 'valid':164,338,343,463 'variabl':194 'verifi':305,362 'vs':174 'without':454 'work':25,154,237,483 'worker':397,504 'workflow':55,439 'write':449 'wrong':372","prices":[{"id":"7604977c-3e03-4200-90c9-e7b9a2d229b8","listingId":"a20ec67e-c9be-487c-971e-dd4bc7771451","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"jdrhyne","category":"agent-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T22:05:03.689Z"}],"sources":[{"listingId":"a20ec67e-c9be-487c-971e-dd4bc7771451","source":"github","sourceId":"jdrhyne/agent-skills/planner","sourceUrl":"https://github.com/jdrhyne/agent-skills/tree/main/skills/planner","isPrimary":false,"firstSeenAt":"2026-04-18T22:05:03.689Z","lastSeenAt":"2026-04-22T00:54:19.792Z"}],"details":{"listingId":"a20ec67e-c9be-487c-971e-dd4bc7771451","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"jdrhyne","slug":"planner","github":{"repo":"jdrhyne/agent-skills","stars":230,"topics":["agent-skills","agentic-ai","ai-agents","automation","claude-code","clawdbot","codex","cursor","developer-tools","gemini-cli","github-copilot","llm-agents","mcp","openclaw","prompt-engineering","prompts"],"license":null,"html_url":"https://github.com/jdrhyne/agent-skills","pushed_at":"2026-03-27T14:29:53Z","description":"A collection of AI agent skills for Clawdbot, Claude Code, Codex","skill_md_sha":"d8e6d745332049b4d16a0319e84414b6dce65709","skill_md_path":"skills/planner/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/jdrhyne/agent-skills/tree/main/skills/planner"},"layout":"multi","source":"github","category":"agent-skills","frontmatter":{"name":"planner","description":"Create structured plans for multi-task projects that can be used by the task-orchestrator skill. Use when breaking down complex work into parallel and sequential tasks with dependencies."},"skills_sh_url":"https://skills.sh/jdrhyne/agent-skills/planner"},"updatedAt":"2026-04-22T00:54:19.792Z"}}