Files
architecture/skills/groom/SKILL.md
Hugo Nijhuis 7406517cd9 refactor: migrate commands to user-invocable skills
Claude Code has unified commands into skills with the user-invocable
frontmatter field. This migration:

- Converts 20 commands to skills with user-invocable: true
- Consolidates docs into single writing-capabilities.md
- Rewrites capability-writing skill for unified model
- Updates CLAUDE.md, Makefile, and other references
- Removes commands/ directory

Skills now have two types:
- user-invocable: true - workflows users trigger with /name
- user-invocable: false - background knowledge auto-loaded

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-11 16:39:55 +01:00

1.4 KiB

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)