skills.rest
OpalBolt
OpalBoltCOMMUNITY
Explore all skills by this author →
GitHub

refine-issue

Guide users through structured interviews to refine GitHub issue descriptions.

1|1|Updated Apr 18, 2026
Search Tags:#project management#code review#GitHub#specification writing#issue refinement
One-click install
npx skills add https://github.com/OpalBolt/Personal-AI-Marketplace --skill refine-issue-opalbolt
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: refine-issue
Source: https://github.com/OpalBolt/Personal-AI-Marketplace/tree/main/plugins/productivity/skills/refine-issue
Command: npx skills add https://github.com/OpalBolt/Personal-AI-Marketplace --skill refine-issue-opalbolt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps users refine their GitHub issues into detailed, implementation-ready specifications, improving clarity and actionability.

Core Features & Use Cases

  • Structured Interview: Guides users through a focused interview to clarify problem statements, technical details, and acceptance criteria.
  • Issue Retrieval: Fetches GitHub issues from specified numbers or URLs.
  • Refinement: Enhances issue descriptions with specific sections like problem/user story, requirements, acceptance criteria, and out-of-scope items.
  • Output Options: Saves refined specifications locally or updates GitHub issues directly.

Quick Start

Run the refine-issue skill with the issue number or URL, e.g., refine-issue #123 or refine-issue https://github.com/owner/repo/issues/123.

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 issues into clear specifications?▼

You can refine GitHub issues by fetching them via issue number or URL, then completing a structured interview that clarifies problem statements, technical details, and acceptance criteria to enhance the description.

What is the best way to add acceptance criteria to a GitHub issue?▼

Adding acceptance criteria to a GitHub issue is done through a structured interview that helps define requirements, user stories, and out-of-scope items, producing an implementation-ready specification.

Do I need the gh CLI to fetch GitHub issues for refinement?▼

Yes, you need the gh CLI installed to fetch GitHub issues for refinement. The Skill requires it for issue retrieval, while optional GitHub API access is needed if you want to update issues directly.

Can I update GitHub issues directly after refining the specification?▼

Yes, you can update GitHub issues directly after refining the specification if you have optional GitHub API access. Alternatively, you can save the refined specification locally to your machine.

What sections are included when transforming an issue into an actionable specification?▼

Transforming an issue into an actionable specification adds specific sections to the description, including problem or user story, requirements, acceptance criteria, and out-of-scope items for clear implementation readiness.

Related Skills

Explore More Software Engineering Skills→
theZMCtheZMC
2

read-github-issue

Read GitHub issue status, metadata, and comments via gh CLI.

Community
Intermediate
hyperlane-xyzhyperlane-xyz
97

inline-pr-comments

Post line-specific inline comments to GitHub pull request diffs.

Official
Intermediate
GamezarGamezar

git-analyze-issue

Analyze GitHub issues to generate structured technical specification documents.

Community
Intermediate
lepahclepahc
1

kspec-writing-specs

Create and manage specification items with the kspec CLI.

Official
Intermediate