SuperAPI AI Directory

github-issue-prioritizer

Coding & development

View repository

Updated 10-16 08:00

About this skill

GitHub Issue Prioritizer Skill

Operational Context & Routing

Use this skill when you need to calculate issue priority ranks (P0-P3), update priority labels (priority:P0..P3), or generate payload updates for GitHub Projects v2 custom fields.

  • Intra-session ephemeral scratchpad: Use task-agent.
  • Logging friction / bugs: Use github-issue-agent.
  • Promoting task to issue: Use github-issue-backlog-agent.
  • Priority ranking & Projects v2 sync: Use github-issue-prioritizer.

Priority Ranking Rules

Priority is determined from three signals:

  1. Friction Tier (tier:0 .. tier:3): Systemic failures (Tier 3) immediately yield P0.
  2. Blockage (blocking, type:blocker): Active work blockages increase priority level.
  3. Occurrence Frequency: Repeated friction events escalate priority.

Priority Matrix

  • P0 (Critical / Systemic): Tier 3 friction OR (Blocking AND frequency >= 3)
  • P1 (High Priority): Tier 2 friction OR Blocking OR frequency >= 4
  • P2 (Medium Priority): Tier 1 friction OR frequency >= 2
  • P3 (Low Priority): Default / backlog items

Core CLI Usage

from plugins.dev_utils.skills.github_issue_prioritizer.scripts.gh_issue_prioritize import (
    prioritize_issue,
    generate_projects_v2_payload
)

# Calculate issue priority
issue = {
    "number": 42,
    "title": "Build runner sandbox crash",
    "labels": [{"name": "tier:3"}, {"name": "blocking"}],
    "occurrence_count": 5
}
result = prioritize_issue(issue)
# result["priority"] -> "P0"
# result["priority_label"] -> "priority:P0"

# Generate GitHub Projects v2 GraphQL mutation payload
payload = generate_projects_v2_payload(
    project_id="PVT_kwDOA12345",
    item_id="PVTI_lADOA12345",
    field_id="PVTF_priority123",
    single_select_option_id="opt_p0_123"
)