groom-issue

Groom GitHub issues by eliciting acceptance criteria through interactive questioning.

138|6|Updated Jan 25, 2025
One-click install
npx skills add https://github.com/yamcodes/arkenv --skill groom-issue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: groom-issue
Source: https://github.com/yamcodes/arkenv/tree/main/skills/groom-issue
Command: npx skills add https://github.com/yamcodes/arkenv --skill groom-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Grooming ambiguous or incomplete issues by eliciting clear requirements through an interactive grilling session and updating the GitHub issue via the gh CLI.

Core Features & Use Cases

  • Interactive grilling to extract explicit acceptance criteria.
  • Update issues on GitHub using gh and align with existing triage workflows.
  • Provide a durable agent brief as needed to support triage decisions.

Quick Start

Grill the user to clarify requirements one question at a time, then update the GitHub issue with the refined specification using the gh CLI.

Frequently Asked Questions about groom-issue

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

FAQPage Schema
How do I clarify ambiguous GitHub issues before starting development?

Clarify ambiguous GitHub issues by running an interactive grilling session that elicits explicit acceptance criteria one question at a time, then updates the issue with the refined specification using the gh CLI.

What is issue grooming and how does it help with requirements triage?

Issue grooming refines incomplete requirements by guiding users through targeted questions to gather project context, apply canonical labels, and generate durable agent briefs for consistent triage decisions.

How do I update GitHub issues with refined acceptance criteria using gh CLI?

Update GitHub issues with refined acceptance criteria by running an interactive grilling workflow that extracts explicit requirements and pushes the clarified specification directly to the issue via the gh CLI.

Can I use this issue triage workflow across multiple project repositories?

Yes, the issue triage workflow applies across projects to gather acceptance criteria, align with existing project context, and trigger consistent triage workflows to apply canonical labels on any GitHub repository.

Do I need the gh CLI installed to groom and update issues?

Yes, the gh CLI is required because the grooming workflow uses it to update GitHub issues with the refined specification and apply canonical triage labels after the interactive grilling session completes.

What's the best way to extract acceptance criteria from incomplete issue reports?

The best way to extract acceptance criteria from incomplete issue reports is an interactive grilling session that asks clarifying questions sequentially, ensuring requirements are explicit before generating a durable agent brief.