Creates structured fix plans in standardized format for GitHub issue comments.
View on GitHubJuniYadi/claude-code
issue-reviews
issue-reviews/skills/plan-generator/SKILL.md
January 24, 2026
Select agents to install to:
npx add-skill https://github.com/JuniYadi/claude-code/blob/main/issue-reviews/skills/plan-generator/SKILL.md -a claude-code --skill plan-generatorInstallation paths:
.claude/skills/plan-generator/## Purpose
Given code exploration results, generate a comprehensive plan that:
- Explains root cause clearly
- Specifies exact changes needed
- Sets scope boundaries (what we won't do)
- Provides testing approach
- Looks professional in GitHub comments
## Usage
Include this file when generating plans:
```
Use lib/plan-generator to create fix plan from exploration results
```
## Template Structure
```markdown
## ๐ค Automated Fix Plan for Issue #<NUMBER>
**Summary:** [One clear sentence: what's broken and how we'll fix it]
**Estimated scope:** X files changed, Y tests added/modified
**Confidence:** [High/Medium/Low based on exploration clarity]
<details>
<summary>๐ Detailed Plan</summary>
### ๐ Root Cause Analysis
[Technical explanation of what's causing the issue]
### โ
What We'll Do
- [ ] Change 1 (`file.ts:line`)
- [ ] Change 2 (`file.ts:line`)
- [ ] Add test for scenario X
### โ What We Won't Do
- Explanation of what's out of scope and why
### ๐ Files to Change
- `path/to/file1.ts` - Description of change
- `path/to/file2.ts` - Description of change
- `tests/file.test.ts` - Add test for X
### โ
Testing Approach
- Unit test strategy
- Integration test needs
- Manual verification steps
### โ ๏ธ Risks & Considerations
[Things to watch during implementation]
</details>
---
**Next Steps:**
- ๐ React with thumbs up if this plan looks good
- ๐ฌ Comment "approve" or "lgtm" to proceed
- โ๏ธ Comment with feedback if changes needed
Once approved, run: `/continue-issue <NUMBER>`
```
## Input Format
Expects exploration results:
```typescript
interface ExplorationResults {
rootCause: string; // What's causing the issue
relevantFiles: FileInfo[]; // Files to modify
confidence: 'High' | 'Medium' | 'Low';
understanding: string; // How the code works
}
interface FileInfo {
path: string; // e.g., "src/auth/config.ts"
lines?: string; // e.g., "12-15"
reason: string; // Why this file matt