issue-solver

Parse GitHub issues and generate actionable solution plans in Markdown.

Updated Feb 23, 2026
One-click install
npx skills add https://github.com/dwertent/.cursor --skill issue-solver
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-solver
Source: https://github.com/dwertent/.cursor/tree/main/skills/issue-solver
Command: npx skills add https://github.com/dwertent/.cursor --skill issue-solver

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyze GitHub issues (or user-provided descriptions), survey linked resources, and produce a concrete, step-by-step solution plan as a Markdown file to guide fixes or improvements.

Core Features & Use Cases

  • Parse and interpret issues: fetch titles, bodies, labels, and comments to understand the scope.
  • Follow linked resources: resolve referenced issues/PRs and extract context from external links or code references.
  • Produce an actionable plan: generate a structured "issue-solution.md" with root cause, proposed approach, concrete steps, testing guidance, and open questions.
  • Use cases: when you need a formal plan to address a bug, a feature request, or a migration task described in an issue.

Quick Start

Provide a GitHub issue URL or plain description and the skill will create issue-solution.md with a complete plan.

Frequently Asked Questions about issue-solver

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a solution plan from a GitHub issue?

Analyze a GitHub issue by fetching its title, body, labels, and comments to understand the scope and context. The skill parses this data to build a targeted solution strategy.

Can I create a root-cause analysis directly from an issue URL?

Yes, provide an issue URL to generate a root-cause analysis. The skill fetches the issue details, resolves referenced issues, and produces a structured markdown file with the analysis.

Do I need the GitHub CLI installed to fetch issue details?

Yes, the GitHub CLI is required to fetch issue data. The skill uses the gh tool to retrieve issue details and read linked resources for generating the solution plan.

What format does the generated issue solution plan use?

The solution plan is output as a Markdown file. It generates an issue-solution.md document containing the root cause, recommended steps, and testing notes.

How do I document testing guidance for a bug fix plan?

The skill automatically generates testing guidance within the solution plan. It analyzes the issue context and adds testing notes to the issue-solution.md file.