issue-triage
This skill should be used when the user asks to "triage an issue", "evaluate a feature request", "should I accept this issue", "analyze GitHub issue", "review this pull request scope", "is this in scope", "how should I respond to this issue", "decline this request", "accept this contribution", or discusses whether to accept, reject, adapt, defer, or redirect an external contribution to a project.
When & Why to Use This Skill
This Claude skill provides a professional framework for triaging GitHub issues and reviewing pull requests. It streamlines the evaluation of external contributions by aligning them with project philosophy, assessing technical feasibility, and providing standardized feedback categories to ensure high-quality code and efficient repository maintenance.
Use Cases
- Automated Issue Triage: Evaluate incoming bug reports and feature requests against a project's core philosophy to decide whether to accept, defer, or redirect.
- Structured Pull Request Review: Conduct deep-dive code reviews with severity-based classifications (Blocker, Major, Minor, Nitpick) to maintain high code quality.
- Security Assessment: Perform specialized security reviews on contributions to detect vulnerabilities and enforce 'security-first' merge policies.
- Contributor Communication: Generate professional and empathetic responses for declining or requesting changes, maintaining a positive community relationship.
- Pattern Detection: Analyze multiple issues or PRs to identify recurring bugs, root causes, or architectural gaps within the codebase.
| name | Issue & PR Triage |
|---|---|
| description | This skill should be used when the user asks to "triage an issue", "evaluate a feature request", "should I accept this issue", "analyze GitHub issue", "review this pull request", "review this PR", "should I merge this PR", "is this PR ready", "code review this", "review this contribution", "is this in scope", "how should I respond to this issue", "decline this request", "accept this contribution", "find similar bugs", "detect patterns", "root cause analysis", "fix this bug comprehensively", "give feedback on this PR", "is this secure", "security review", or discusses whether to accept, reject, adapt, defer, merge, or redirect an external contribution (issue or PR) to a project. |
Issue & PR Triage Framework
A framework for evaluating external Issues/PRs against project philosophy.
Core Philosophy
"Every issue is an opportunity" - Even declines can improve documentation or reveal API gaps.
"Think 10 from 1" - Extract ten insights from one request.
"Every contribution is a gift" - Honor the contributor's time investment.
"Mentor, not gatekeeper" - Help them succeed.
Issue Decision Matrix
| Philosophy HIGH | Philosophy LOW |
-----------------|-----------------|-----------------|
Feasibility HIGH | ACCEPT | REDIRECT |
Feasibility MED | ADAPT | DEFER/REDIRECT |
Feasibility LOW | DEFER | DECLINE |
PR Decision Matrix
| Quality HIGH | Quality LOW |
-----------------|----------------------|----------------------|
Philosophy HIGH | APPROVE | MERGE_WITH_FIXES |
Philosophy MED | APPROVE_WITH_NOTES | REQUEST_CHANGES |
Philosophy LOW | REDIRECT | DECLINE |
Quick Reference
Issue Verdicts
- ACCEPT: Implement as requested
- ADAPT: Implement differently
- DEFER: Not now, provide roadmap
- REDIRECT: Out of scope, provide alternatives
- DECLINE: Philosophy mismatch, explain respectfully
PR Verdicts
- APPROVE: Ready to merge
- MERGE_WITH_FIXES: Merge, maintainer fixes
- REQUEST_CHANGES: Specific fixes needed
- REDIRECT: Different approach needed
- DECLINE: Philosophy mismatch
Severity Levels (PR)
| 🔴 Blocker | 🟠 Major | 🟡 Minor | 🟢 Nitpick | ✨ Praise |
Bug Risk Levels
| 🔴 Critical | 🟠 High | 🟡 Medium | 🟢 Low |
Commands
For full workflow:
# Issue triage
/iyu:issue <url | file | "text">
/iyu:issue <input> --quick
# PR review
/iyu:pr <pr-url | #number>
/iyu:pr <input> --quick
/iyu:pr <input> --security-focus
Integration
This framework leverages Claude's capabilities:
- Code review: Claude performs, iyu provides severity classification framework
- Security review: Claude detects, iyu applies "security issues are always Blocker" policy
- Communication: Claude writes, iyu provides response structure per Decision