Back to Skills

plan-generator

verified

Creates structured fix plans in standardized format for GitHub issue comments.

View on GitHub

Marketplace

development

JuniYadi/claude-code

Plugin

issue-reviews

productivity

Repository

JuniYadi/claude-code

issue-reviews/skills/plan-generator/SKILL.md

Last Verified

January 24, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/JuniYadi/claude-code/blob/main/issue-reviews/skills/plan-generator/SKILL.md -a claude-code --skill plan-generator

Installation paths:

Claude
.claude/skills/plan-generator/
Powered by add-skill CLI

Instructions

## 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

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
10077 chars