{"id":"50ed5019-bf4f-4d6b-ad41-8399faa7784a","shortId":"8EHUuY","kind":"skill","title":"refactor-plan","tagline":"Create a concrete plan before starting a multi-file refactor. Use when the user asks to plan, sequence, scope, or safely execute a refactor across multiple files; always investigate first, output the plan, and wait for confirmation before making code changes.","description":"# Refactor Plan\n\nCreate a detailed plan before making any code changes.\n\n## Instructions\n\n1. Do not edit files while preparing the plan.\n2. Search the codebase to understand the current state. Read enough implementation, tests, configuration, and docs to make the plan specific to the repository.\n3. Identify affected files, ownership boundaries, dependencies, and likely hidden coupling.\n4. Plan changes in a safe sequence. Prefer contracts and types first, then implementations, then callers, then tests, then cleanup.\n5. Include verification steps between phases and a final validation command.\n6. Include rollback or recovery steps for the riskiest phases.\n7. Output the complete plan using the format below.\n8. Stop after the plan and ask for confirmation before implementing. If the user already asked you to implement, still produce the plan first and wait for confirmation unless they explicitly said to continue without review after the plan.\n\nIf the request is too ambiguous to plan safely, ask concise clarifying questions instead of editing files.\n\n## Output Format\n\n```markdown\n## Refactor Plan: [title]\n\n### Current State\n[Brief description of how things work now]\n\n### Target State\n[Brief description of how things will work after]\n\n### Affected Files\n| File | Change Type | Dependencies |\n|------|-------------|--------------|\n| path | modify/create/delete | blocks X, blocked by Y |\n\n### Execution Plan\n\n#### Phase 1: Types and Interfaces\n- [ ] Step 1.1: [action] in `file.ts`\n- [ ] Verify: [how to check it worked]\n\n#### Phase 2: Implementation\n- [ ] Step 2.1: [action] in `file.ts`\n- [ ] Verify: [how to check]\n\n#### Phase 3: Tests\n- [ ] Step 3.1: Update tests in `file.test.ts`\n- [ ] Verify: Run `npm test`\n\n#### Phase 4: Cleanup\n- [ ] Remove deprecated code\n- [ ] Update documentation\n\n### Rollback Plan\nIf something fails:\n1. [Step to undo]\n2. [Step to undo]\n\n### Risks\n- [Potential issue and mitigation]\n```\n\nAfter the plan, ask: \"Shall I proceed with Phase 1?\"","tags":["refactor","plan","awesome","copilot","github","agent-skills","agents","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"capabilities":["skill","source-github","skill-refactor-plan","topic-agent-skills","topic-agents","topic-awesome","topic-custom-agents","topic-github-copilot","topic-hacktoberfest","topic-prompt-engineering"],"categories":["awesome-copilot"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/github/awesome-copilot/refactor-plan","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add github/awesome-copilot","source_repo":"https://github.com/github/awesome-copilot","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 33270 github stars · SKILL.md body (1,984 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-05-18T18:52:23.614Z","embedding":null,"createdAt":"2026-04-18T20:25:25.748Z","updatedAt":"2026-05-18T18:52:23.614Z","lastSeenAt":"2026-05-18T18:52:23.614Z","tsv":"'1':58,249,302,324 '1.1':254 '2':67,265,306 '2.1':268 '3':91,277 '3.1':280 '4':102,290 '5':122 '6':133 '7':143 '8':152 'across':29 'action':255,269 'affect':93,233 'alreadi':166 'alway':32 'ambigu':196 'ask':19,158,167,200,318 'block':241,243 'boundari':96 'brief':216,225 'caller':117 'chang':45,56,104,236 'check':261,275 'clarifi':202 'cleanup':121,291 'code':44,55,294 'codebas':70 'command':132 'complet':146 'concis':201 'concret':6 'configur':80 'confirm':41,160,179 'continu':185 'contract':110 'coupl':101 'creat':4,48 'current':74,214 'depend':97,238 'deprec':293 'descript':217,226 'detail':50 'doc':82 'document':296 'edit':61,206 'enough':77 'execut':26,246 'explicit':182 'fail':301 'file':13,31,62,94,207,234,235 'file.test.ts':284 'file.ts':257,271 'final':130 'first':34,113,175 'format':150,209 'hidden':100 'identifi':92 'implement':78,115,162,170,266 'includ':123,134 'instead':204 'instruct':57 'interfac':252 'investig':33 'issu':312 'like':99 'make':43,53,84 'markdown':210 'mitig':314 'modify/create/delete':240 'multi':12 'multi-fil':11 'multipl':30 'npm':287 'output':35,144,208 'ownership':95 'path':239 'phase':127,142,248,264,276,289,323 'plan':3,7,21,37,47,51,66,86,103,147,156,174,190,198,212,247,298,317 'potenti':311 'prefer':109 'prepar':64 'proceed':321 'produc':172 'question':203 'read':76 'recoveri':137 'refactor':2,14,28,46,211 'refactor-plan':1 'remov':292 'repositori':90 'request':193 'review':187 'risk':310 'riskiest':141 'rollback':135,297 'run':286 'safe':25,107,199 'said':183 'scope':23 'search':68 'sequenc':22,108 'shall':319 'skill' 'skill-refactor-plan' 'someth':300 'source-github' 'specif':87 'start':9 'state':75,215,224 'step':125,138,253,267,279,303,307 'still':171 'stop':153 'target':223 'test':79,119,278,282,288 'thing':220,229 'titl':213 'topic-agent-skills' 'topic-agents' 'topic-awesome' 'topic-custom-agents' 'topic-github-copilot' 'topic-hacktoberfest' 'topic-prompt-engineering' 'type':112,237,250 'understand':72 'undo':305,309 'unless':180 'updat':281,295 'use':15,148 'user':18,165 'valid':131 'verif':124 'verifi':258,272,285 'wait':39,177 'without':186 'work':221,231,263 'x':242 'y':245","prices":[{"id":"415abb3f-e29b-4431-a683-b98d8caa7be8","listingId":"50ed5019-bf4f-4d6b-ad41-8399faa7784a","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"github","category":"awesome-copilot","install_from":"skills.sh"},"createdAt":"2026-04-18T20:25:25.748Z"}],"sources":[{"listingId":"50ed5019-bf4f-4d6b-ad41-8399faa7784a","source":"github","sourceId":"github/awesome-copilot/refactor-plan","sourceUrl":"https://github.com/github/awesome-copilot/tree/main/skills/refactor-plan","isPrimary":false,"firstSeenAt":"2026-04-18T21:51:01.873Z","lastSeenAt":"2026-05-18T18:52:23.614Z"},{"listingId":"50ed5019-bf4f-4d6b-ad41-8399faa7784a","source":"skills_sh","sourceId":"github/awesome-copilot/refactor-plan","sourceUrl":"https://skills.sh/github/awesome-copilot/refactor-plan","isPrimary":true,"firstSeenAt":"2026-04-18T20:25:25.748Z","lastSeenAt":"2026-05-07T22:40:16.847Z"}],"details":{"listingId":"50ed5019-bf4f-4d6b-ad41-8399faa7784a","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"github","slug":"refactor-plan","github":{"repo":"github/awesome-copilot","stars":33270,"topics":["agent-skills","agents","ai","awesome","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"license":"mit","html_url":"https://github.com/github/awesome-copilot","pushed_at":"2026-05-18T01:26:59Z","description":"Community-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.","skill_md_sha":"ebeab3e11652f350def9676463e6e42cf5806cb0","skill_md_path":"skills/refactor-plan/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/github/awesome-copilot/tree/main/skills/refactor-plan"},"layout":"multi","source":"github","category":"awesome-copilot","frontmatter":{"name":"refactor-plan","description":"Create a concrete plan before starting a multi-file refactor. Use when the user asks to plan, sequence, scope, or safely execute a refactor across multiple files; always investigate first, output the plan, and wait for confirmation before making code changes."},"skills_sh_url":"https://skills.sh/github/awesome-copilot/refactor-plan"},"updatedAt":"2026-05-18T18:52:23.614Z"}}