Issue Triage Skill
Automate GitHub issue triage using the Omi Issue Triage Guide.
When to Use
Use this skill when:
- •Analyzing GitHub issues
- •When user requests issue triage
- •When reviewing new issues
- •When prioritizing issues
- •When assigning issues to lanes
Capabilities
1. Score Issues
Calculate priority score using the triage formula from ISSUE_TRIAGE_GUIDE.MD:
Priority Score = (Core Layer Weight × Failure Severity) + Trust Impact + Frequency + Maintenance Leverage - Cost & Risk
2. Map to Omi Layers
Identify which primary layer the issue affects:
- •Capture (Weight: 5): Audio recording, device pairing, permissions, battery
- •Understand (Weight: 4): Speech-to-text, language detection, diarization
- •Memory (Weight: 4): Memory creation, syncing, storage, metadata
- •Intelligence (Weight: 3): Summaries, insights, action items
- •Retrieval / Action (Weight: 3): Search, asking Omi, tasks, exports
- •UX / Polish (Weight: 1): UI layout, animations, wording
- •Docs / Tooling (Weight: 1): Documentation, examples, tooling
3. Evaluate Scoring Factors
Assess each factor (1-5 scale):
Failure Severity:
- •5: Completely broken
- •4: Frequently fails
- •3: Partially degraded
- •2: Minor annoyance
- •1: Cosmetic
Trust Impact:
- •5: Data loss or missing memories
- •4: Incorrect or corrupted memories
- •3: Inconsistent behavior
- •2: Confusing but recoverable
- •1: No trust impact
Frequency:
- •5: Happens daily
- •4: Weekly
- •3: Regular but situational
- •2: Rare
- •1: Edge case
Maintenance Leverage:
- •5: Eliminates a class of bugs
- •4: Improves observability or stability
- •3: Neutral
- •2: Adds complexity
- •1: Increases long-term maintenance burden
Cost & Risk (subtracted):
- •5: Cross-device + backend + firmware
- •4: Core pipeline change
- •3: Moderate
- •2: Small
- •1: Trivial
4. Assign Priority Levels
Based on score:
- •>= 30: P0 - Existential / must fix immediately
- •22-29: P1 - Critical
- •14-21: P2 - Important
- •< 14: P3 - Backlog
5. Suggest Lane Assignment
Assign to appropriate lane:
- •Maintainer Now: High-risk, cross-system, or architectural changes
- •Community Ready: Clear scope, safe changes, suitable for contributors
- •Needs Info: Missing repro steps, logs, versions, or clarity
- •Park: Out of scope or low leverage
Triage Rules
Follow these principles:
- •Issues are signals, not commands
- •Popularity does not determine urgency
- •Data loss outranks feature requests
- •Capture failures outrank intelligence improvements
- •Memory-first principle: If Omi fails to capture or preserve memory, nothing else matters
Workflow
- •Read Issue: Analyze issue description, labels, comments
- •Map to Layer: Identify primary Omi layer affected
- •Evaluate Factors: Score each factor (1-5)
- •Calculate Score: Apply triage formula
- •Assign Priority: Map score to priority level (P0-P3)
- •Suggest Lane: Recommend lane assignment
- •Report: Provide triage summary with reasoning
Example Triage
Issue: Recording stops unexpectedly
Analysis:
- •Layer: Capture (5)
- •Severity: 5 (Completely broken)
- •Trust Impact: 5 (Data loss - missing recordings)
- •Frequency: 4 (Weekly)
- •Leverage: 4 (Improves stability)
- •Cost: 3 (Moderate)
Score: (5 × 5) + 5 + 4 + 4 - 3 = 35 → P0
Lane: Maintainer Now (high-risk, affects core functionality)
Related Resources
Documentation
- •
ISSUE_TRIAGE_GUIDE.MD- Complete triage guide and formula
Rules
- •
.cursor/rules/omi-specific-patterns.mdc- Omi architecture and priorities
Commands
- •
/auto-triage- Automatically triage an issue