refine-git-issue

Refine GitHub issues by identifying missing reproduction steps and affected files.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/rdfitted/Claude-Code-Setup --skill refine-git-issue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refine-git-issue
Source: https://github.com/rdfitted/Claude-Code-Setup/tree/main/.codex/skills/refine-git-issue
Command: npx skills add https://github.com/rdfitted/Claude-Code-Setup --skill refine-git-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses unclear or incomplete GitHub issue descriptions, making them actionable for developers.

Core Features & Use Cases

  • Issue Refinement: Enhances issue text for better understanding and completeness.
  • Gap Identification: Pinpoints missing information like reproduction steps, expected vs. actual behavior, and affected files.
  • Use Case: When a user submits a vague bug report, this skill can be used to automatically ask clarifying questions and suggest improvements to the issue description before it's assigned.

Quick Start

Use the refine-git-issue skill to improve the clarity of the provided GitHub issue draft.

Frequently Asked Questions about refine-git-issue

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

FAQPage Schema
How do I improve GitHub issue clarity for vague bug reports?

To improve GitHub issue clarity, you can refine bug reports by identifying missing reproduction steps, expected versus actual behavior, scope, and affected files. This ensures incomplete issue descriptions become actionable for development by adding necessary clarifying questions and assumptions.

What is the best way to identify missing reproduction steps in a GitHub issue?

The best way to identify missing reproduction steps in a GitHub issue is to analyze the bug report for gaps in expected versus actual behavior and scope. The refinement process pinpoints missing information and verifies code paths using ripgrep when possible.

How do I rewrite incomplete GitHub bug reports to make them actionable?

You can rewrite incomplete GitHub bug reports by enhancing the issue text for better understanding and completeness. The process adds necessary questions or assumptions and verifies affected file paths using ripgrep to ensure the bug report is actionable.

Can I use ripgrep to verify affected files mentioned in a GitHub bug report?

Yes, you can use ripgrep to verify affected files mentioned in a GitHub bug report. The issue refinement process verifies code paths with ripgrep when possible to ensure the scope and affected files described in the bug report are accurate.

When do I need to add clarifying questions to a GitHub issue?

You need to add clarifying questions to a GitHub issue when a user submits a vague bug report. This happens during issue refinement if the tool identifies missing information like reproduction steps, expected behavior, or affected files before the issue is assigned.

Why are my GitHub issues not actionable for developers?

Your GitHub issues may not be actionable for developers due to unclear or incomplete descriptions lacking reproduction steps, expected versus actual behavior, scope, or affected files. Refining the issue text and adding necessary questions or assumptions resolves this lack of clarity.