issue-triage — Claude Code command: what it does, how to install
Triages incoming GitHub and Linear tasks, computes priority scores, and routes issues to matching teams.
npx claude-code-templates@latest --command team/issue-triageWhat issue-triage does
The command runs a structured six-step workflow directly inside Claude Code. It reads issue metadata, categorizes requests into bugs or features, and scores priority based on severity. It also defines label taxonomies and response expectations.
Context discovery relies on the Bash tool to inspect local repository details. The prompt invokes gh repo view and pipes gh issue list into jq to inspect open tickets.
If gh or jq is missing from the environment, repository detection fails and outputs fallback placeholders. You can direct the scope with command flags: restrict processing to GitHub issues or Linear tasks.
What it helps with
- Classify incoming bugs and feature requests
- Score issue priority using severity and effort metrics
- Route backlog tickets to teams based on expertise
- Assign consistent labels and define SLA response targets
Example prompts for the agent
- /issue-triage --github-issues
- /issue-triage --linear-tasks
- /issue-triage --team-assignment
How to install issue-triage
1claude-code-templates
npx claude-code-templates@latest --command team/issue-triage2Manually: put the files in place
.claude/commands/issue-triage.mdCall it with /issue-triage. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/issue-triage.mdCall it with /prompts:issue-triage. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/issue-triage.prompt.mdManually: put the files in place
.gemini/commands/issue-triage.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about issue-triage
How to install issue-triage in Claude Code?
Run npx claude-code-templates@latest --command team/issue-triage in your project terminal. Alternatively, save the file manually to .claude/commands/issue-triage.md.
What does the issue-triage command do?
It inspects untriaged tickets, determines severity, assigns priority ratings, and recommends team routing alongside SLA targets.
What CLI dependencies are required?
The prompt needs Read, Write, and Bash tools enabled. Reading repository context requires gh and jq installed in your path.
Source text
issue-triage.md · MIT
--- allowed-tools: Read, Write, Bash argument-hint: "[scope] | --github-issues | --linear-tasks | --priority-analysis | --team-assignment" description: Intelligent issue triage with automatic categorization, prioritization, and team assignment --- # Issue Triage Intelligently triage and prioritize issues with automated routing and team assignment: **$ARGUMENTS** ## Current Triage Context - Repository: !`gh repo view --json nameWithOwner -q .nameWithOwner 2>/dev/null || echo "No repo context"` - Open issues: !`gh issue list --state open --limit 1 --json number | jq length 2>/dev/null || echo "Check manually"` - Linear teams: Available Linear teams and project assignments for routing - Triage backlog: Current volume and age of untriaged issues ## Task Execute intelligent issue analysis with automated triage and priority assignment: **Triage Scope**: Use $ARGUMENTS to focus on GitHub issues, Linear tasks, priority analysis, or team assignment optimization **Triage Framework**: 1. **Issue Analysis** - Extract issue metadata, analyze content patterns, assess severity indicators, evaluate impact scope 2. **Category Classification** - Identify issue type (bug, feature, documentation), assess complexity level, determine urgency factors 3. **Priority Assessment** - Calculate priority score using severity, impact, effort, and business value metrics 4. **Team Routing** - Match issue skills to team expertise, balance workload distribution, consider current sprint capacity 5. **Label Management** - Apply consistent labeling scheme, maintain taxonomy standards, enable filtering and reporting 6. **SLA Assignment** - Set response time expectations, establish resolution targets, track performance metrics **Advanced Features**: Automated severity detection, intelligent team matching, workload balancing, SLA monitoring, escalation workflows. **Quality Assurance**: Consistency validation, triage accuracy tracking, team satisfaction monitoring, process optimization feedback. **Output**: Complete issue triage with priority assignments, team routing recommendations, SLA targets, and process improvement insights.
© davila7 · MIT · davila7/claude-code-templates
