К основному содержанию
скилл CX Codex

github-triage · sammcj — скилл для Claude Code: что делает и установка

Скилл github-triage для Claude Code разбирает GitHub issues по меткам и состояниям и ведёт maintainer к решению. Разбирает баги и feature requests, готовит задачи агенту.

Apache-2.0 ★ 173 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add sammcj/agentic-coding --skill github-triage -a claude-code
Открыть на GitHub

Что делает github-triage

github-triage работает с issues текущего репозитория: определяет репозиторий через git remote, а операции с GitHub выполняет через gh. Скилл группирует задачи, показывает требующие внимания issues и помогает разобрать конкретную задачу после чтения её тела, комментариев, меток и связанного кода.

В основе лежит state machine с категориями bug и enhancement и состояниями вроде needs-triage, needs-info, ready-for-agent, ready-for-human и wontfix. Во время grilling session maintainer получает рекомендации по категории и переходу, а затем может подтвердить метки, изменить состояние или продолжить обсуждение. Для багов скилл пытается воспроизвести проблему. Каждый комментарий или issue, созданный при triage, должен начинаться с AI-дисклеймера, поэтому это нужно учитывать в рабочем процессе команды.

Какие задачи решает

  • разобрать новые GitHub issues по приоритету внимания
  • назначить issue категорию и состояние через метки
  • подготовить задачу для AFK-агента
  • проверить воспроизводимость бага перед triage
  • вернуть maintainer к issues с новыми ответами

Примеры запросов агенту

  • Запусти /github-triage и покажи issues, которые требуют моего внимания.
  • Запусти /github-triage и разберись с issue #42, предложив категорию и состояние.
  • Запусти /github-triage и подготовь #42 к передаче AFK-агенту после проверки бага.

Как установить github-triage

1Через Skills CLI (Vercel)

npx skills add sammcj/agentic-coding --skill github-triage -a claude-code

2Вручную: положить файлы

~/.claude/skills/github-triage/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/github-triage/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о github-triage

Как установить github-triage в Claude Code?

Выполни npx skills add sammcj/agentic-coding --skill github-triage -a claude-code, затем открой ~/.claude/skills/github-triage/SKILL.md.

Что делает github-triage?

Скилл проводит triage GitHub issues через метки и допустимые переходы состояний. Он собирает контекст, даёт maintainer рекомендацию и помогает довести issue до нужного состояния.

Что произойдёт с конфликтующими метками состояния?

Если у issue одновременно стоят конфликтующие состояния, например needs-triage и ready-for-agent, скилл должен остановиться, показать конфликт и запросить у maintainer правильное состояние.

Исходный текст

SKILL.md · Apache-2.0
---
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.                 |
| `unlabeled`    | `ready-for-human` | Maintainer (via skill) | Issue requires human implementation. Skill writes a brief comment summarizing the task, applies label.               |
| `unlabeled`    | `wontfix`         | Maintainer (via skill) | Issue is spam, duplicate, or out of scope. Skill closes with comment (and writes `.out-of-scope/` for enhancements). |
| `needs-triage` | `needs-info`      | Maintainer (via skill) | Issue is underspecified. Skill posts triage notes capturing progress so far + questions for reporter.                |
| `needs-triage` | `ready-for-agent` | Maintainer (via skill) | Grilling session complete, agent-suitable. Skill writes agent brief comment, applies label.                          |
| `needs-triage` | `ready-for-human` | Maintainer (via skill) | Grilling session complete, needs human. Skill writes a brief comment summarizing the task, applies label.            |
| `needs-triage` | `wontfix`         | Maintainer (via skill) | Maintainer decides not to action. Skill closes with comment (and writes `.out-of-scope/` for enhancements).          |
| `needs-info`   | `needs-triage`    | Skill (detects reply)  | Reporter has replied. Skill surfaces to maintainer for re-evaluation.                                                |

An issue can only move along these transitions. The maintainer can override any state directly (see Quick State Override below), but the skill should flag if the transition is unusual.

## Invocation

The maintainer invokes `/github-triage` then describes what they want in natural language. The skill interprets the request and takes the appropriate action.

Example requests:

- "Show me anything that needs my attention"
- "Let's look at #42"
- "Move #42 to ready-for-agent"
- "What's ready for agents to pick up?"
- "Are there any unlabeled issues?"

## Workflow: Show What Needs Attention

When the maintainer asks for an overview, query GitHub and present a summary grouped into three buckets:

1. **Unlabeled issues** — new, no labels at all. These have never been triaged.
2. **`needs-triage` issues** — maintainer needs to evaluate or continue evaluating.
3. **`needs-info` issues with new activity** — the reporter has commented since the last triage notes comment. Check comment timestamps to determine this.

Display counts per group. Within each group, show issues oldest first (longest-waiting gets attention first). For each issue, show: number, title, age, and a one-line summary of the issue body.

Let the maintainer pick which issue to dive into.

## Workflow: Triage a Specific Issue

### Step 1: Gather context

Before presenting anything to the maintainer:

- Read the full issue: body, all comments, all labels, who reported it, when
- If there are prior triage notes comments (from previous sessions), parse them to understand what has already been established
- Explore the codebase to build context — understand the domain, relevant interfaces, and existing behavior related to the issue
- Read `.out-of-scope/*.md` files and check if this issue matches or is similar to a previously rejected concept

### Step 2: Present a recommendation

Tell the maintainer:

- **Category recommendation:** bug or enhancement, with reasoning
- **State recommendation:** where this issue should go, with reasoning
- If it matches a prior out-of-scope rejection, surface that: "This is similar to `.out-of-scope/concept-name.md` — we rejected this before because X. Do you still feel the same way?"
- A brief summary of what you found in the codebase that's relevant

Then wait for the maintainer's direction. They may:

- Agree and ask you to apply labels → do it
- Want to flesh it out → start a grilling session
- Override with a different state → apply their choice
- Want to discuss → have a conversation

### Step 3: Bug reproduction (bugs only)

If the issue is categorized as a bug, attempt to reproduce it before starting a grilling session. This will vary by codebase, but do your best:

- Read the reporter's reproduction steps (if provided)
- Explore the codebase to understand the relevant code paths
- Try to reproduce the bug: run tests, execute commands, or trace the logic to confirm the reported behavior
- If reproduction succeeds, report what you found to the maintainer — include the specific behavior you observed and where in the code it originates
- If reproduction fails, report that too — the bug may be environment-specific, already fixed, or the report may be inaccurate
- If the report lacks enough detail to attempt reproduction, note that — this is a strong signal the issue should move to `needs-info`

The reproduction attempt informs the grilling session and the agent brief. A confirmed reproduction with a known code path makes for a much stronger brief.

### Step 4: Grilling session (if needed)

If the issue needs to be fleshed out before it's ready for an agent, interview the maintainer to build a complete specification.

### Step 5: Apply the outcome

Depending on the outcome:

- **ready-for-agent** — post an agent brief comment (see [AGENT-BRIEF.md](AGENT-BRIEF.md))
- **ready-for-human** — post a comment summarizing the task, what was established during triage, and why it needs human implementation. Use the same structure as an agent brief but note the reason it can't be delegated to an agent (e.g. requires judgment calls, external system access, design decisions, or manual testing).
- **needs-info** — post triage notes with progress so far and questions for the reporter (see Needs Info Output below)
- **wontfix (bug)** — post a polite comment explaining why, then close the issue
- **wontfix (enhancement)** — write to `.out-of-scope/`, post a comment linking to it, then close the issue (see [OUT-OF-SCOPE.md](OUT-OF-SCOPE.md))
- **needs-triage** — apply the label. Optionally leave a comment if there's partial progress to capture.

## Workflow: Quick State Override

When the maintainer explicitly tells you to move an issue to a specific state (e.g. "move #42 to ready-for-agent"), trust their judgment and apply the label directly.

Still show a confirmation of what you're about to do: which labels will be added/removed, and whether you'll post a comment or close the issue. But skip the grilling session entirely.

If moving to `ready-for-agent` without a grilling session, ask the maintainer if they want to write a brief agent brief comment or skip it.

## Needs Info Output

When moving an issue to `needs-info`, post a comment that captures the grilling progress and tells the reporter what's needed:

```markdown
## Triage Notes

**What we've established so far:**

- point 1
- point 2

**What we still need from you (@reporter):**

- question 1
- question 2
```

Include everything resolved during the grilling session in "established so far" — this work should not be lost. The questions for the reporter should be specific and actionable, not vague ("please provide more info").

## Resuming Previous Sessions

When triaging an issue that already has triage notes from a previous session:

1. Read all comments to find prior triage notes
2. Parse what was already established
3. Check if the reporter has answered any outstanding questions
4. Present the maintainer with an updated picture: "Here's where we left off, and here's what the reporter has said since"
5. Continue the grilling from where it stopped — do not re-ask resolved questions

© sammcj · Apache-2.0 · sammcj/agentic-coding

Похожие скиллы

Все скиллы по теме «Git и GitHub» →

Сначала — github-triage от других авторов.

github-triage code-yeongyu Скилл github-triage читает все открытые issues и PR в репозитории и пишет отчёты с доказательствами. Ничего не комментирует и не закрывает. CX Codex +1 2 800установок github-triage trailofbits Скилл github-triage разбирает открытые issues и pull requests в GitHub: связывает задачи с исправлениями, отмечает уже решённые и готовит локальные оценки приоритета и размера. CX Codex +1 1 900установок github-issue-manager rohitg00 Плагин github-issue-manager для Claude Code помогает разбирать, создавать и вести GitHub issues. ★ 2 858звёзд репо Issue Triage Agent microsoft Субагент Issue Triage Agent разбирает одиночные issue на GitHub: назначает типы, зоны проекта и приоритеты по строгим правилам. Помогает поддерживать порядок в репозитории без ручной рутины. CX Codex +1 ★ 1 627звёзд репо issue-triage modelcontextprotocol Скилл issue-triage сортирует входящие issues и пуллреквесты в репозитории MCP-серверов. Отправляет валидные задачи на доску проекта, а спам и дубликаты закрывает шаблонными ответами. CX Codex +1 ★ 92 149звёзд репо triage-issue официальный anthropics Команда triage-issue для Claude Code сортирует GitHub issues и назначает им метки. Запускается для нового issue или после комментария, чтобы обновить метки жизненного цикла. CX Codex +1 ★ 156 584звёзд репо oh-my-issues thedotmack Скилл oh-my-issues для Claude Code и Codex группирует открытые GitHub Issues по первопричинам в мастер-планы. Запускается при разборе запущенного бэклога тикетов. CX Codex +1 4 500установок om-verify-in-repo open-mercato Скилл om-verify-in-repo для Claude Code проверяет задачи трекера перед запуском цепочки автоисправления. Оценивает репорт в режиме чтения и останавливает процесс токеном NO_ACTION_NEEDED при отсутствии бага. CX Codex +1 3 500установок

Из того же набора73

Весь набор →
guided-demo Скилл guided-demo добавляет в веб-приложения и HTML-страницы интерактивные демо с пошаговой подсветкой элементов и печатью текста. CX Codex +1 ★ 173звёзд репо diagnose-hard-problem Скилл diagnose-hard-problem для Claude Code ведёт агента через диагностику сложных багов: строит проверяемый цикл воспроизведения, сужает сценарий и проверяет гипотезы. Разбирает регрессии и нестабильные ошибки. CX Codex +1 ★ 173звёзд репо yue2-music Скилл yue2-music для Claude, который ведёт генерацию песни в YuE2 от запроса до готового аудио: режимы full, melody и off, каверы с расшифровкой через SheetSage2 и локальный плеер для сравнения дублей. CX Codex +1 ★ 173звёзд репо swift-development Скилл swift-development внедряет правила многопоточности Swift 6, проверку изоляции акторов и шаблоны чистого API для проектов под iOS и macOS. CX Codex +1 ★ 173звёзд репо authoring-claude-md Скилл authoring-claude-md помогает создавать и поддерживать CLAUDE.md и файлы правил в .claude/rules/, которые хранят контекст проекта — архитектурные решения, нестандартные соглашения и решения проблем, с которыми ИИ встречается регулярно. CX Codex +1 ★ 173звёзд репо bento-slides Скилл bento-slides для Claude Code создаёт и редактирует презентации Bento в одном HTML-файле. Превращает данные, этапы процесса или код в слайды. CX Codex +1 ★ 173звёзд репо code-review-recent-changes Скилл code-review-recent-changes проверяет изменения в ветке по трём осям: стандарты репозитория, соответствие спеке и поддерживаемость кода. Каждая ось идёт отдельным субагентом, в конце — отчёт с вердиктом. CX Codex +1 ★ 173звёзд репо aws-strands-agents-agentcore Скилл aws-strands-agents-agentcore помогает проектировать ИИ-агентов на AWS Strands Agents SDK и Bedrock AgentCore: паттерны оркестрации, запуск в облаке и интеграция MCP. CX Codex +1 ★ 173звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой