architecture/old/skills/groom/SKILL.md

name, description, model, argument-hint, user-invocable

name	description	model	argument-hint	user-invocable
groom	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.	sonnet	issue-number	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)