# Github Issue Triage

> Use when you have a backlog of unorganized GitHub Issues — bulk-reads, labels, prioritizes, and assigns issues at scale using Copilot's built-in GitHub MCP tools.

- Skill: `drvoss/github-issue-triage` (Agent Skill)
- Install (CLI): `npx skillmds@latest add drvoss/github-issue-triage`
- Raw SKILL.md: https://api.skillmd.com/api/skills/drvoss/github-issue-triage/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: drvoss (https://skillmd.com/u/drvoss)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/drvoss/github-issue-triage

---


# GitHub Issue Triage & Management

## Why This is Copilot-Exclusive

Copilot CLI has **native GitHub Issue tools** baked into its MCP server — `list_issues`,
`search_issues`, `issue_read` with sub-methods for comments, labels, and sub-issues. These
structured tool calls return rich, typed data that Copilot can reason over directly. Claude Code
has no built-in GitHub integration and must rely on `gh issue list` with fragile text parsing.

## When to Use

- Triaging a backlog of open issues across one or more repositories
- Auto-categorizing issues by content (bug, feature, docs, etc.)
- Finding duplicate or related issues before filing new ones
- Building one queue from both issues and external-contributor PRs
- Linking issues to pull requests for traceability
- Generating weekly issue reports or burndown summaries

## Workflow

### 1. List Open Issues with Filters

```text
Tool: github-mcp-server-list_issues
  owner: "my-org"
  repo: "my-app"
  state: "OPEN"
  labels: ["bug"]
  orderBy: "UPDATED_AT"
  direction: "DESC"
  perPage: 25
```

### 2. Search Across Repositories

Find issues matching a keyword across your entire org:

```text
Tool: github-mcp-server-search_issues
  query: "memory leak is:open"
  owner: "my-org"
```

### 3. Read Issue Details and Comments

```text
Tool: github-mcp-server-issue_read
  method: "get"
  owner: "my-org"
  repo: "my-app"
  issue_number: 87

Tool: github-mcp-server-issue_read
  method: "get_comments"
  owner: "my-org"
  repo: "my-app"
  issue_number: 87
```

### 4. Check Sub-Issues

For tracking epics and parent/child relationships:

```text
Tool: github-mcp-server-issue_read
  method: "get_sub_issues"
  owner: "my-org"
  repo: "my-app"
  issue_number: 42
```

### 5. Get Labels for Classification

```text
Tool: github-mcp-server-issue_read
  method: "get_labels"
  owner: "my-org"
  repo: "my-app"
  issue_number: 87
```

### 6. Pull External-Contributor PRs into the Queue

If the inbox includes PRs as well as issues, filter for outside contributors first and then route
those PRs through the same triage state model you use for issues.

```powershell
gh pr list --limit 100 --json number,title,authorAssociation,isDraft,url |
  ConvertFrom-Json |
  Where-Object {
    $_.authorAssociation -in @('CONTRIBUTOR', 'FIRST_TIME_CONTRIBUTOR', 'NONE') -and
    -not $_.isDraft
  }
```

Treat `OWNER`, `MEMBER`, and `COLLABORATOR` PRs as normal maintainer review unless your project has
a stronger triage requirement. If a bare reference such as `#42` could point to either a PR or an
issue, check the PR first and fall back to the issue only if no PR exists.

When an external PR duplicates existing work, close the loop explicitly: mark it `wontfix`, link
the authoritative issue or PR, and avoid creating a second parallel thread for the same request.

## Examples

### Weekly Issue Triage Session

> "Show me all open issues in my-org/api-service created in the last 7 days,
> grouped by label. For unlabeled issues, suggest a category based on the title
> and body."

Copilot calls `list_issues` with a `since` filter, reads each issue's labels,
groups them, and uses the issue body to suggest labels for uncategorized ones.

### Duplicate Detection

> "Before I file a bug about 'WebSocket disconnects on idle timeout', check
> if there's already an issue about this."

```text
Tool: github-mcp-server-search_issues
  query: "WebSocket disconnect idle timeout"
  owner: "my-org"
  repo: "my-app"
```

Copilot searches, reads the top matches, and tells you whether to file new or
comment on an existing issue.

### Sprint Planning Report

> "List all issues labeled 'sprint-12' in my-org/frontend, show their status,
> assignee, and whether they have linked PRs."

Copilot lists the issues, checks each for linked PRs via comments and cross-references,
and produces a sprint board summary right in the terminal.

### Shared Issue + PR Intake

> "Show me new outside-contributor PRs and new unlabeled issues from the last week, then tell me
> which ones need triage first."

Copilot lists issues with the MCP issue tools, pulls in external PRs with `gh pr list`, then routes
the highest-signal items into the same triage queue instead of treating PRs as a separate inbox.

### Batch Categorization with SQL Tracking

```sql
-- Track triage progress in session database
CREATE TABLE IF NOT EXISTS triage_items (
  issue_number INTEGER, repo TEXT, title TEXT,
  suggested_label TEXT, status TEXT DEFAULT 'pending'
);
```

Load issues into the session database, then work through them systematically.

## Tips

- **Parallel issue reads**: Call `issue_read` on multiple issues simultaneously
  to build a triage report fast.
- **Use `search_issues` for cross-repo queries**: The search syntax supports
  `org:`, `repo:`, `label:`, `assignee:`, `milestone:`, and date ranges.
- **Combine with session SQL**: Store triage results in the session database
  to track which issues you've reviewed and what actions you took.
- **Sub-issues for epic tracking**: Use `get_sub_issues` to check progress on
  large features broken into subtasks.
- **Link to PRs**: After identifying an issue, ask Copilot to search for PRs
  that reference it — closing the loop between issues and code changes.
- **Pair with `triage` for per-item state**: Use
  [`workflow/triage`](../../workflow/triage/SKILL.md) when one issue or one external PR needs a
  durable `needs-info` / `ready-for-agent` / `wontfix` decision.