Skip to content
Get packs

Guide · Agent skill

How to use the Triage Issue agent skill for GitHub issues

Updated · written with AI from the project's own documentation and checked against our catalogue data

The triage-issue skill is an agent skill for Claude that takes a GitHub issue, checks the reporter's claim against the hive codebase, and drafts a technical reply. It is built for maintainers and contributors of the hive repository who want a first-pass analysis before deciding how to respond. After this guide you will know what the skill does, how to install it, how to trigger it, and what it needs to run safely.

Triage Issueaden-hive/hive · Apache-2.0

Quick start

  1. 1Download the ZIP. Get the triage-issue ZIP from the directory page.
  2. 2Install the skill. Unzip it into ~/.claude/skills/ for personal use or into .claude/skills/ in a project, or upload it under Settings → Capabilities → Skills.
  3. 3Authenticate the GitHub CLI. Make sure gh is installed and logged in with an account that can comment on and close issues in adenhq/hive.
  4. 4Start with an issue. Give the agent an issue number or URL, for example /triage-issue 1970.
  5. 5Read the analysis. Check the claim, finding and cited code the skill reports before deciding anything.
  6. 6Approve, edit or skip. Choose Post and close, Edit response, or Skip. The skill takes no public action without your choice.

What is an agent skill and what does triage-issue do?

An agent skill is a folder containing a SKILL.md file with instructions that an AI agent follows for a specific task. This one is named triage-issue and its only file in the source is SKILL.md.

Given a GitHub issue number or URL, the skill fetches the issue with the GitHub CLI, identifies the core claim and any file paths or function names in it, and searches the codebase with Grep, Glob and Read to see whether the claim is accurate.

  • Sorts the issue into a category such as valid bug, valid feature request, misunderstanding, fundamentally flawed, duplicate, or incomplete
  • Drafts a markdown response with analysis, technical details, rationale and a recommendation
  • Posts a comment and closes the issue only if you approve the draft

Install the triage-issue skill

Download the ZIP for the skill from the directory page. You can install it in one of two ways.

For a personal install, unzip it into ~/.claude/skills/. For a single project, unzip it into that project's .claude/skills/ folder. You can also upload the ZIP in the Claude apps under Settings → Capabilities → Skills.

  • Personal: unzip into ~/.claude/skills/
  • Project only: unzip into the project's .claude/skills/ folder
  • Claude apps: Settings → Capabilities → Skills, then upload the ZIP

Set up the GitHub CLI and access before you run it

The skill depends on the GitHub CLI (gh). It must be installed and authenticated with an account that has permission to comment on and close issues in adenhq/hive. The skill also needs access to the hive repository source code so that its Grep, Glob and Read searches have something to search.

The commands in the skill hardcode the adenhq/hive repository, as shown below. If you are working from a different repository, the commands would need editing before the skill is useful.

  • GitHub CLI (gh) installed and authenticated
  • Permission to comment on and close issues in adenhq/hive
  • Local access to the hive repository source code
gh issue view <number> --repo adenhq/hive --json title,body,state,labels,author

How do you trigger the skill with a request?

The source documents the trigger as a user providing a GitHub issue URL or number. The examples given use the slash form, with either the issue number or the full URL.

If the issue is already closed, the skill tells you and stops, so there is no analysis to run.

  • /triage-issue 1970
  • /triage-issue https://github.com/adenhq/hive/issues/1970

Review the draft and approve or reject the action

Before any change is made, the skill shows you the issue title, the claim, its finding, and the draft response. It then asks whether to post the comment and close the issue, using three options: Post and close, Edit response, or Skip.

If you approve, the skill posts the comment and closes the issue as not planned. It then reports success with a link to the issue. Nothing is posted or closed without your choice.

  • Post and close: posts the comment, then closes the issue
  • Edit response: lets you change the draft first
  • Skip: takes no action
gh issue close <number> --repo adenhq/hive --reason "not planned"

Safety notes: scripts and network access

The skill runs scripts and uses the network. Its workflow calls the GitHub CLI to read issues and, after approval, to post comments and close them. Review the SKILL.md file before installing so you know exactly which commands it will run.

The skill's guidelines say never to close valid issues, and to check the code twice before calling anything invalid. Treat the draft as a starting point and read the cited code yourself before you approve.

  • It reads issue data through gh and writes only after you approve
  • Review SKILL.md to see the exact commands before installing
  • Keep your gh account permissions limited to what triage needs

What people use it for

  • Working through a backlog of incoming issues by getting a first-pass finding on each one
  • Checking whether a reported bug is a real problem or a misreading of intended behavior before replying
  • Spotting duplicate issues by locating the original issue the skill finds
  • Asking for more information when an issue report is missing details needed to reproduce it

Frequently asked questions

Is the triage-issue skill free to use?

The source does not state pricing or licence terms for the skill beyond the item's listed licence, which is Apache-2.0. Check the repository licence for terms that apply to your use.

What do I need to install the triage-issue skill?

You need the skill ZIP, a Claude setup that supports skills, and the GitHub CLI (gh) installed and authenticated. The account must be able to comment on and close issues in adenhq/hive, and you need access to the hive source code.

Where do I put the skill folder?

Unzip it into ~/.claude/skills/ for personal use or into a project's .claude/skills/ folder for one project. You can also upload the ZIP under Settings → Capabilities → Skills in the Claude apps.

Can the skill close issues without asking me?

No. The skill is written to show a draft and ask whether to post and close. It only runs the comment and close commands if you choose Post and close.

Can I use triage-issue on a repository other than hive?

Not as written. The commands hardcode adenhq/hive, so you would need to edit the SKILL.md commands to point at another repository.

Why does the skill say an issue was not planned?

When you approve closing, the skill runs gh issue close with the reason not planned. That is the reason it is designed to use for invalid or misunderstood reports.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

This skill suits maintainers and contributors of adenhq/hive who want a checked first-pass analysis of incoming issues, with a human approving every comment and close. It is a poor fit for other repositories without editing, or for anyone who wants issues closed automatically without review.

Download the skill