skills.rest
rnwolfe
rnwolfeCOMMUNITY
Explore all skills by this author →
Website𝕏@somewolfeGitHub

refine-issue

Refine GitHub issues into detailed, actionable tickets with user approval.

2|Updated Mar 1, 2026
Search Tags:#github#backlog#triage#gh-cli#quality-checklist#issue-refinement
One-click install
npx skills add https://github.com/rnwolfe/forge --skill refine-issue
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: refine-issue
Source: https://github.com/rnwolfe/forge/tree/main/.claude/skills/refine-issue
Command: npx skills add https://github.com/rnwolfe/forge --skill refine-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill transforms vague, incomplete, or poorly scoped GitHub issues into clear, testable, and implementation-ready tickets so engineering teams can move from backlog to development with confidence.

Core Features & Use Cases

  • Quality assessment: Compare an issue against a maintained issue-quality checklist and produce a concise, itemized assessment of strengths and gaps.
  • Targeted refinement: Ask focused, conversational questions to fill missing details and resolve weak sections without overwriting content that already meets the bar.
  • Issue update and labeling: Prepare a revised issue body for review and suggest label changes, then update the issue after explicit user approval.

Quick Start

Use the refine-issue skill to iteratively improve issue #35 until it meets the project's issue-quality checklist and is ready for implementation.

Frequently Asked Questions about refine-issue

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

FAQPage Schema
How do I refine GitHub backlog issues into implementation-ready tickets?▼

To refine GitHub backlog issues, the skill assesses issue quality against a maintained checklist, asks clarifying questions to fill gaps, and prepares an updated issue body requiring explicit approval before editing.

What is the best way to triage and improve vague GitHub issues?▼

Triage and improve vague GitHub issues by comparing issue content against a quality checklist, exploring relevant source files for context, and suggesting label changes and body updates for user review.

Can I use gh-cli to assess and update issue quality automatically?▼

Yes, you can assess and update issue quality by applying the skill to open issues labeled needs-refinement or a specified issue number, producing a suggested update after explicit user approval.

How does issue refinement handle missing details in GitHub tickets?▼

Issue refinement handles missing details by asking focused, conversational questions to resolve weak sections without overwriting content that already meets the project's quality bar.

Do I need to approve changes before this skill updates a GitHub issue?▼

Yes, explicit user approval is required before the skill updates a GitHub issue, ensuring you review the revised issue body and suggested label changes before any edits are made.

What limitations exist when refining issues with a quality checklist?▼

A limitation is that the skill requires explicit user approval before making edits, meaning it cannot automatically overwrite issue content and operates as an interactive, iterative refinement process.

Related Skills

Explore More Product & Management Skills→
Abhilash-003Abhilash-003
3

triage

Categorize GitHub issues, assign priority, and recommend maintainer-approved actions.

Community
Advanced
oxieoxie

task-breakdown-phase

Break down implementation plans into 20-30 testable tasks with acceptance criteria.

Community
Basic
kamp-uskamp-us
25

triage

Classify, enrich, prioritize, and manage GitHub issues labeled status:needs-triage.

Official
Advanced
atlassianatlassian
949

triage-issue

Triages bug reports by searching Jira for duplicates and generating structured issues.

Official
Intermediate