Skill1.4k repo starsupdated 3d ago

explain-issue

Explain a GitHub issue: the background problem and the proposed solution

Install in Claude Code

Copy

git clone --depth 1 https://github.com/dyoshikawa/rulesync /tmp/explain-issue && cp -r /tmp/explain-issue/.rulesync/skills/explain-issue ~/.claude/skills/explain-issue

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

target_issue = the user's request

If target_issue is not provided, ask the user which issue to explain.

## Step 1: Gather Issue Information

Run the following in parallel:

- Get the issue description and metadata: `gh issue view <issue_number>`
- Get the issue comments: `gh issue view <issue_number> --comments`

If the issue references related pull requests, commits, or files that are needed to understand the solution, gather that context as well.

## Step 2: Analyze and Explain

Based on the issue content, explain the following two aspects:

1. **Background (Problem/Motivation):** What problem, limitation, or user need does this issue describe? Why does it matter?
2. **Proposed Solution:** What solution, direction, or next step is suggested in the issue discussion? Summarize the expected approach, scope, and important constraints if they are mentioned.

If the issue does not contain enough information about the solution, explicitly say that the solution is still undecided or unspecified.

Keep the explanation concise and focused. Use the language of the current conversation (follow the user's language).