Agent skill

triage

Triage and prioritize Linear backlog. Analyzes issues for staleness, blockers, and suggests priorities based on dependencies and capacity.

Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/alienfast/claude/tree/main/skills/triage

SKILL.md

Triage Skill - Backlog Analysis

You are an expert at analyzing and prioritizing software backlogs.

When to Use

Use this skill when:

  • The backlog needs cleanup
  • Prioritization decisions need to be made
  • Looking for stale or blocked issues

Process

  1. Fetch the Backlog

    bash
    linear issues list --team ENG
    
  2. Analyze Dependencies

    bash
    linear deps --team ENG
    
  3. Identify Issues Look for:

    • Stale issues: No updates in 30+ days
    • Blocked issues: Dependencies not resolved
    • Priority mismatches: High priority but blocked
    • Orphaned issues: No assignee, no activity
  4. Generate Recommendations

Analysis Framework

Staleness Check

  • Last updated > 30 days ago = Stale
  • Last updated > 60 days ago = Very stale (consider closing)
  • No activity + no assignee = Orphaned

Dependency Health

  • Blocked by completed issues = Unblock
  • Circular dependencies = Flag for resolution
  • Long blocking chains = Risk

Priority Assessment

  • P1/P2 but blocked = Escalate blocker
  • P3/P4 with no activity = Consider closing
  • No priority set = Needs triage

Output Format

BACKLOG TRIAGE: Team ENG
════════════════════════════════════════

URGENT ATTENTION (3)
────────────────────────────────────────
ENG-101 [Stale 45d] Login bug - P1 but no activity
ENG-102 [Blocked] Payment flow - blocked by ENG-99
ENG-103 [Orphaned] API refactor - no owner

RECOMMENDED ACTIONS
────────────────────────────────────────
1. Unblock ENG-102: Complete ENG-99 or remove dependency
2. Assign ENG-103: Needs owner or close if abandoned
3. Update ENG-101: Stale P1 needs attention

HEALTH SUMMARY
────────────────────────────────────────
Total issues: 45
Blocked: 8 (17%)
Stale: 12 (26%)
Healthy: 25 (55%)

Commands Used

bash
# List all issues for a team
linear issues list --team ENG

# Check dependencies
linear deps --team ENG

# Update priority
linear issues update ENG-123 --priority 2

# Add a comment about triage
linear issues comment ENG-123 --body "Triaged: Needs unblocking before sprint"

Discovery Commands (NEW)

Use search to discover triage-worthy issues:

bash
# Find all blocked issues that need attention
linear search --has-blockers --state "In Progress" --team ENG

# Find high priority work that's blocked
linear search --priority 1 --has-blockers --team ENG

# Find issues in circular dependencies (always needs fixing)
linear search --has-circular-deps --team ENG

# Find work blocked by a specific bottleneck
linear search --blocked-by ENG-100 --team ENG

# Search for stale work by keyword
linear search "authentication" --state "Backlog" --team ENG

Pro tip: Run linear search --has-blockers --team ENG weekly to identify and unblock stuck work.

Best Practices

  1. Regular cadence - Triage weekly or bi-weekly
  2. Be decisive - Close issues that won't be done
  3. Document reasoning - Add comments explaining priority changes
  4. Involve stakeholders - Flag issues needing product input

Expand your agent's capabilities with these related and highly-rated skills.

alienfast/claude

link-deps

Discover and link related issues as dependencies. Searches for issues that should be connected and recommends dependency relationships to establish proper work order.

0 0
Explore
alienfast/claude

Deprecation Handler

Handles deprecated APIs, types, and modules by applying safe migration patterns. Use when encountering deprecation warnings, migrating from deprecated code, updating dependencies with breaking changes, or modernizing legacy code to use current APIs.

0 0
Explore
alienfast/claude

cycle-plan

Plan Linear cycles using velocity analytics. Suggests scope based on historical capacity, identifies dependency risks, balances workload.

0 0
Explore
alienfast/claude

Dependency Updater

Orchestrates comprehensive dependency updates by delegating research, impact analysis, code changes, and validation to specialized agents. Invoked when users request package updates, dependency updates, version bumps, or mention 'ncu' or npm-check-updates.

0 0
Explore
alienfast/claude

linear

Linear issue tracking - MUST READ before using Linear commands

0 0
Explore
alienfast/claude

PR Title and Description Generator

Generate or update GitHub Pull Request titles and descriptions based on actual code changes in the final state. Use when the user mentions updating, generating, or writing PR descriptions, PR titles, pull request summaries, or says 'update the PR'. Analyzes git diff to determine what's actually in the code (not just commit history) and creates comprehensive, accurate PR documentation.

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results