Files
architecture/commands/groom.md
Hugo Nijhuis b8ca2386fa Use @ file references to include skills in commands
Skills have only ~20% auto-activation rate when referenced by name.
Using @~/.claude/skills/*/SKILL.md guarantees skill content is loaded.

Updated all commands to use file references instead of "Use the X skill".
Updated docs/writing-commands.md with new pattern and examples.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

928 B

description, argument-hint
description argument-hint
Groom and improve issues. Without argument, reviews all open issues. With argument, grooms specific issue.
issue-number

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
  2. Evaluate against grooming checklist
  3. Suggest improvements for:
    • Title clarity
    • Description completeness
    • Acceptance criteria quality
    • Scope definition
  4. Ask user if they want to apply changes
  5. Update issue if approved

If no argument (groom all):

  1. List open issues
  2. Review each against grooming checklist
  3. Categorize:
    • Ready: Well-defined, can start work
    • Needs work: Missing info or unclear
    • Stale: No longer relevant
  4. Present summary table
  5. Offer to improve issues that need work