# Issue triage

Labels each new GitHub issue, links likely duplicates and asks the author for what's missing.

Requires GitHub, through Composio.

## Install

No one has run this against real GitHub accounts through Composio yet. Its eval cases use stand-ins.

```sh
npx @parcha/agentrun template install github:Parcha-ai/agentrun-templates/templates/issue-triage@242f29da8317fbe51d0cce4628bdb5ab61d7ccc9 --trust
```

Or open `<your AgentRun address>/#/templates/install?src=github%3AParcha-ai%2Fagentrun-templates%2Ftemplates%2Fissue-triage%40242f29da8317fbe51d0cce4628bdb5ab61d7ccc9`. Pinned to commit 242f29da8317fbe51d0cce4628bdb5ab61d7ccc9.

## What it does

Triages each new issue on your GitHub repository the moment it is opened. It labels the issue from the labels your repo already has, checks your open and closed issues for likely duplicates and links them, and asks the author in one comment for whatever a maintainer would need first (steps to reproduce, the version, the error). It can't close, edit or mark an issue a duplicate, and never creates a label. Connects through Composio's GitHub toolkit. Each label and comment waits for your OK unless you pick Never for approvals at install; it stays held to your repository either way.

- Skill `triage`: Triage one new GitHub issue through Composio's GitHub tools. Read it, pick labels from the repository's own label set, go through its open and closed issues for likely duplicates, work out what a maintainer would need that the author left out, then add the labels and post at most one comment. Never mark a duplicate, never create a label. Use for the issue-created trigger and for "triage issue #N".

## What starts it

- A GitHub event through Composio: issue created. At most 3 at once.
- By hand, any time: from the console, the API or the CLI.

## Inputs

| Name | Type | Required | What it is |
| --- | --- | --- | --- |
| `issue_number` | integer, at least 1 | no | Triage one issue by hand. Leave it out on the trigger's runs: the event names the issue. Example: `482`. |

### Setup, filled in once at install

| Name | Type | Required | What it is |
| --- | --- | --- | --- |
| `owner` | string | yes | The GitHub account or organization that owns the repository, like Parcha-ai. |
| `repo` | string | yes | The repository's name without the owner, like agentrun. |
| `max_labels` | integer | no | The most labels the agent adds to one issue; 3 unless you set it. Default: `3`. |
| `protected_labels` | list of string | no | Optional: labels only a person applies, one per entry ("release-blocker", "good first issue"). The agent never adds these. |

## What it needs

- Harness: pi, claude-agent, codex
- Model: balanced tier, medium effort
- Tools: read
- Composio GitHub tools: GITHUB_GET_AN_ISSUE, GITHUB_LIST_ISSUE_COMMENTS, GITHUB_LIST_LABELS_FOR_A_REPOSITORY, GITHUB_LIST_REPOSITORY_ISSUES, GITHUB_ADD_LABELS_TO_AN_ISSUE, GITHUB_CREATE_AN_ISSUE_COMMENT. Reads the new issue, its comments, and your repo's labels and issues; labels the issue and posts one comment on it. Every call is held to the repository you set. Labels can't be limited to a set: GitHub creates a label that doesn't exist yet.
- Computer: Wherever your AgentRun puts a new agent
- Keys: A model key
- Learning: on

## Sample output

Input:

```json
{
  "content": "Triage this issue.",
  "issue_number": 483
}
```

Output:

Illustrative output, written by hand to show the shape. A measured eval run replaces it.

The agent triaged issue #483 on acme/tidewater. It added `bug` and `area:sync` from the repo's own labels, found that
closed issue #301 is the same failure (fixed in 2.4.0) and open #377 is very likely the same, and posted one comment
linking both. It did not close the issue or mark it a duplicate.

## Tested

Passes 4 of 5 eval cases on pi, 5 of 5 on Claude Code and 5 of 5 on Codex.

5 eval cases: bug-missing-info, finds-duplicate, injection-in-issue, nothing-to-ask, thin-report.

## Source

- Package: https://github.com/Parcha-ai/agentrun-templates/tree/242f29da8317fbe51d0cce4628bdb5ab61d7ccc9/templates/issue-triage
- Publisher: Parcha-ai
- Author: Parcha Labs
- Version: 0.1.0
- License: Apache-2.0
- Category: Engineering
- Page: https://marketplace.agentrun.ai/templates/issue-triage/
