github-triage

Triage GitHub notifications and issue backlogs using the gh CLI.

1.6k|168|Updated Dec 16, 2024
One-click install
npx skills add https://github.com/amd/gaia --skill github-triage-amd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-triage
Source: https://github.com/amd/gaia/tree/main/hub/skills/github-triage
Command: npx skills add https://github.com/amd/gaia --skill github-triage-amd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Sorting through GitHub notifications and issue backlogs manually is slow and easy to get wrong. This Skill reads your unread notification inbox or a repository's open issues, groups related reports, ranks them by severity and reach, and posts comments or labels only after you approve each write. ## Core Features & Use Cases - Inbox Triage: Fetches your unread GitHub notifications via gh api, ranks them by reason (review requests and assignments first), and turns them into concrete action items. - Backlog Triage: Pulls a repository's issues with gh issue list, reads the ones that matter, clusters duplicates, and ranks clusters by severity and reach. - Permission-Gated Writes: Read commands run without prompts; writes like gh issue comment and gh issue edit require your per-command approval; dangerous commands like gh issue close and gh pr merge are refused outright. - Use Case: Ask what needs your attention on GitHub, and get a ranked list of who is blocked on you, which issues are duplicates, and what information is missing — then approve the exact comment or label command to post. ## Quick Start Ask the agent to triage your GitHub notifications and tell you what needs your attention first.

Frequently Asked Questions about github-triage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I triage GitHub notifications with the gh CLI?

Run gh api with the notifications endpoint to fetch unread items, then rank them by reason field. Review requests and assignments come first since someone is blocked on you, followed by mentions, while subscribed and author notifications can usually be batched or skipped.

How do I prioritize a GitHub issue backlog?

List issues with gh issue list, read the important ones with gh issue view, then cluster issues describing the same underlying problem. Rank each cluster on severity (data loss down to annoyance) and reach (everyone down to one reporter).

Does this skill work without the GitHub CLI installed?

No, the GitHub CLI must be installed and authenticated. Check with gh --version and gh auth status; if missing, install it via winget, brew, or cli.github.com, and run gh auth login yourself since it is interactive.

Can the agent close issues or merge pull requests automatically?

No. GAIA refuses gh issue close, gh pr merge, gh repo delete, and similar irreversible commands outright with no approval path. The skill recommends the action and hands you the command to run yourself.

Why does my gh command fail with a quoting error on Windows?

Windows passes the raw string to cmd.exe, so single quotes and backslash continuations fail. Use double quotes only, no single quotes, no line continuations, and no spaces inside --jq expressions for cross-platform commands.

Which gh commands require my approval before running?

Write commands like gh issue create, gh issue comment, gh issue edit, gh pr comment, and gh label create require per-command approval. Read commands like gh issue list and gh pr view run without prompting once the skill is loaded.