GitHub Issue Triage

Triage open GitHub issues against design_docs and implementation status.

33|5|Updated Sep 26, 2025
One-click install
npx skills add https://github.com/sunholo-data/ailang --skill github-issue-triage-sunholo-data
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: GitHub Issue Triage
Source: https://github.com/sunholo-data/ailang/tree/main/.claude/skills/github-issue-triage
Command: npx skills add https://github.com/sunholo-data/ailang --skill github-issue-triage-sunholo-data

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires GitHub CLI (gh), jq, and includes scripts (resource) components.

What problem does it solve?

Keeps open GitHub issues aligned with design docs and implementation status, identifies closable issues, and synchronizes the tracker with actual development progress.

Core Features & Use Cases

  • Triage reports: triage_report.sh to generate comprehensive triage reports.
  • Open issues view: list_open_issues.sh to see status, labels, and age.
  • Design doc matching: match_design_docs.sh to connect issues to planning docs.
  • Close candidates: find_closable.sh to identify issues that are implemented and ready to close.

Quick Start

  • Full triage report: .claude/skills/github-issue-triage/scripts/triage_report.sh
  • List open issues: .claude/skills/github-issue-triage/scripts/list_open_issues.sh
  • Find closable issues: .claude/skills/github-issue-triage/scripts/find_closable.sh
  • Close closable issues: .claude/skills/github-issue-triage/scripts/find_closable.sh --close
  • Match issues to design docs: .claude/skills/github-issue-triage/scripts/match_design_docs.sh

Frequently Asked Questions about GitHub Issue Triage

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

FAQPage Schema
How do I identify GitHub issues that are ready to close?

Use find_closable.sh to identify issues marked as implemented or resolved against your codebase and design docs. The script surfaces candidates by matching issue metadata against CHANGELOG references and repository config, letting you review or auto-close them in bulk.

How do I keep GitHub issues aligned with my design documentation?

Run match_design_docs.sh to connect open issues to your design_docs metadata. The script cross-references issue descriptions and labels with your planning documents, surfacing gaps where issues lack corresponding design coverage or vice versa.

What's the best way to audit open GitHub issues during sprint planning?

Generate a triage report using triage_report.sh to get a comprehensive view of all open issues, their age, labels, and implementation status. Use this output during backlog planning and release readiness to prioritize work and surface stale or duplicate issues.

Can I automate closing GitHub issues based on implementation status?

Yes. Run find_closable.sh with the --close flag to automatically close issues the script identifies as implemented. The tool relies on GitHub CLI (gh) and jq to match issues against CHANGELOG entries and local design_docs, then execute closures.

Do I need design documentation files to triage GitHub issues?

Design docs enhance matching but aren't strictly required. The Skill can list and age-sort open issues with list_open_issues.sh using only GitHub CLI. Design doc matching is optional and surfaces alignment gaps; skip it if your workflow doesn't track design separately.

How do I view the status and age of all open GitHub issues?

Use list_open_issues.sh to get a sorted view of every open issue with labels, age, and status metadata. This is a lightweight first step before running full triage or closure workflows.