---
name: groom
description: >
  Groom and improve issues. Without argument, reviews all open issues. With argument,
  grooms specific issue. Use when grooming backlog, improving issues, or when user
  says /groom.
model: sonnet
argument-hint: [issue-number]
user-invocable: true
---

# Groom Issues

@~/.claude/skills/gitea/SKILL.md
@~/.claude/skills/backlog-grooming/SKILL.md
@~/.claude/skills/issue-writing/SKILL.md

## If issue number provided ($1):

1. **Fetch the issue** details with `tea issues <number> --comments`
2. **Check dependencies** with `tea issues deps list <number>`
3. **Evaluate** against grooming checklist
4. **Suggest improvements** for:
   - Title clarity
   - Description completeness
   - Acceptance criteria quality
   - Scope definition
   - Missing or incorrect dependencies
5. **Ask user** if they want to apply changes
6. **Update issue** if approved
7. **Link/unlink dependencies** if needed: `tea issues deps add/remove <issue> <dep>`

## If no argument (groom all):

1. **List open issues**
2. **Review each** against grooming checklist (including dependencies)
3. **Categorize**:
   - Ready: Well-defined, dependencies linked, can start work
   - Blocked: Has unresolved dependencies
   - Needs work: Missing info, unclear, or missing dependency links
   - Stale: No longer relevant
4. **Present summary** table with dependency status
5. **Offer to improve** issues that need work (including linking dependencies)