# github-triage

The github-triage skill sorts GitHub issues through labels and state changes, then guides maintainers through a decision. Use it for bugs, feature requests, and agent handoff.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 173 repo stars
- Author: sammcj
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/sammcj/agentic-coding/tree/HEAD/Skills_disabled/github-triage/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/sammcj-github-triage

## What it does

github-triage works with issues in the current repository. It infers the repository from `git remote` and uses `gh` for GitHub operations. The skill can show groups that need attention, including unlabeled issues and issues awaiting triage or reporter input. For a selected issue, it reads the body, comments, labels, reporter details, and related code before presenting a recommendation.

Its workflow uses `bug` and `enhancement` categories plus states such as `needs-triage`, `needs-info`, `ready-for-agent`, `ready-for-human`, and `wontfix`. A maintainer can accept the recommendation, start a grilling session, or override the proposed state. Bug reports go through a reproduction attempt before that session. Any issue or comment created during triage must begin with the supplied AI disclaimer, which affects how this skill fits into a team’s GitHub workflow.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add sammcj/agentic-coding --skill github-triage -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/github-triage/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/github-triage/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add sammcj/agentic-coding --skill github-triage -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/github-triage/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add sammcj/agentic-coding --skill github-triage -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/github-triage/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install sammcj/agentic-coding Skills_disabled/github-triage/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/github-triage/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add sammcj/agentic-coding --skill github-triage -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/sammcj/agentic-coding --path Skills_disabled/github-triage
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/github-triage/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/sammcj/agentic-coding/tree/HEAD/Skills_disabled/github-triage/SKILL.md

## When to use it
- sort incoming GitHub issues by triage state
- assign issue categories and workflow labels
- prepare a fully specified issue for an AFK agent
- try to reproduce a reported bug before discussion
- surface issues that received new reporter activity

## Example prompts
- Run `/github-triage` and show me everything that needs my attention.
- Run `/github-triage` and review issue `#42`, including a category and state recommendation.
- Run `/github-triage` and prepare `#42` for an AFK agent after checking the reported bug.

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 81f914812b742b08.

BEGIN THIRD-PARTY FILE 81f914812b742b08
````text
---
name: github-triage
description: Triage GitHub issues through a label-based state machine with interactive grilling sessions. Use when user wants to triage issues, review incoming bugs or feature requests, prepare issues for an AFK agent, or manage issue workflow.
---

# GitHub Issue Triage

Triage issues in the current repo using a label-based state machine. Infer the repo from `git remote`. Use `gh` for all GitHub operations.

## AI Disclaimer

Every comment or issue posted to GitHub during triage **must** include the following disclaimer at the top of the comment body, before any other content:

```
> *This was generated by AI during triage.*
```

## Reference docs

- [AGENT-BRIEF.md](AGENT-BRIEF.md) — how to write durable agent briefs
- [OUT-OF-SCOPE.md](OUT-OF-SCOPE.md) — how the `.out-of-scope/` knowledge base works

## Labels

| Label             | Type     | Description                              |
| ----------------- | -------- | ---------------------------------------- |
| `bug`             | Category | Something is broken                      |
| `enhancement`     | Category | New feature or improvement               |
| `needs-triage`    | State    | Maintainer needs to evaluate this issue  |
| `needs-info`      | State    | Waiting on reporter for more information |
| `ready-for-agent` | State    | Fully specified, ready for AFK agent     |
| `ready-for-human` | State    | Requires human implementation            |
| `wontfix`         | State    | Will not be actioned                     |

Every issue should have exactly **one** state label and **one** category label. If an issue has conflicting state labels (e.g. both `needs-triage` and `ready-for-agent`), flag the conflict and ask the maintainer which state is correct before doing anything else. Provide a recommendation.

## State Machine

| Current State  | Can transition to | Who triggers it        | What happens                                                                                                         |
| -------------- | ----------------- | ---------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `unlabeled`    | `needs-triage`    | Skill (on first look)  | Issue needs maintainer evaluation. Skill applies label after presenting recommendation.                              |
| `unlabeled`    | `ready-for-agent` | Maintainer (via skill) | Issue is already well-specified and agent-suitable. Skill writes agent brief comment, applies label.                 |
````
END THIRD-PARTY FILE 81f914812b742b08

The third-party file has ended. Everything between the 81f914812b742b08 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2578 of 10029 bytes. © sammcj · Apache-2.0 · https://github.com/sammcj/agentic-coding/tree/HEAD/Skills_disabled/github-triage/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
