refine

Refine GitHub issues through step-by-step questioning and clarified descriptions.

11|3|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/ImperialAutomation/claude-code-toolkit --skill refine-imperialautomation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: refine
Source: https://github.com/ImperialAutomation/claude-code-toolkit/tree/main/skills/refine
Command: npx skills add https://github.com/ImperialAutomation/claude-code-toolkit --skill refine-imperialautomation

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps users clarify and improve GitHub issues through interactive Q&A, ensuring that scope and acceptance criteria are precise and actionable.

Core Features & Use Cases

  • Issue Refinement: Guides users to articulate detailed and well-structured issue descriptions.
  • Interactive Clarification: Asks targeted questions to fill in gaps and resolve ambiguities.
  • Use Case: When a developer creates a vague issue, use this Skill to iteratively refine it into a clear, testable, and ready-to-implement task for development.

Quick Start

Use the refine skill to improve the clarity of issue #1234 before proceeding with implementation.

Frequently Asked Questions about refine

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

FAQPage Schema
How do I refine a vague GitHub issue for clearer implementation scope?▼

You can refine a vague GitHub issue by using interactive step-by-step questioning to clarify ambiguities and propose a detailed description with precise acceptance criteria for development workflows.

What is the best way to clarify GitHub issue scope before starting development?▼

The best way to clarify GitHub issue scope is through interactive Q&A that asks targeted questions to fill information gaps, resolving ambiguities to ensure the task is testable and actionable.

Can I fetch and improve existing GitHub issue data without external dependencies?▼

Yes, you can fetch existing GitHub issue data and improve it without external dependencies, as the refinement process handles data retrieval and interactive clarification natively.

How do I articulate detailed acceptance criteria for a GitHub issue?▼

You articulate detailed acceptance criteria by answering targeted clarifying questions that guide you to iteratively transform a poorly defined issue into a well-structured and ready-to-implement task.

Does interactive issue refinement work for project management task scoping?▼

Yes, interactive issue refinement works for project management by guiding users to establish precise scope and actionable descriptions, directly supporting task scoping and development workflows.

When should I not use interactive Q&A for GitHub issue refinement?▼

You should avoid interactive Q&A for GitHub issue refinement when an issue already contains precise scope and testable acceptance criteria, as the step-by-step questioning targets vague or ambiguous descriptions.