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.