issue-triage-tool

name	issue-triage-tool
description	Run the GitHub issue triage tool for Redux repos. This skill should be used when triaging GitHub issues, generating triage reports, or understanding triage output for redux-toolkit, react-redux, reselect, redux, or immer repositories.

Issue Triage Tool

Automates fetching, categorizing, and reporting on open GitHub issues/PRs for Redux ecosystem repos.

Prerequisites

• GitHub CLI (gh) — must be installed and authenticated (gh auth login)
• Bun — TypeScript runtime

Tool Location

The tool path is configured in ~/.config/opencode/scripts/config.json under toolPaths.issue-triage-tool.

Running the Tool

Basic Usage

# Triage RTK (most common)
bun src/index.ts --repo reduxjs/redux-toolkit

# Use cached data (skip API calls)
bun src/index.ts --repo reduxjs/redux-toolkit --use-cache

# Triage all repos
bun src/index.ts

Available Repos

Repo	Flag Value
Redux Toolkit	--repo reduxjs/redux-toolkit
React Redux	--repo reduxjs/react-redux
Reselect	--repo reduxjs/reselect
Redux	--repo reduxjs/redux
Immer	--repo immerjs/immer

CLI Flags

• --repo <owner/name> — Process only this repository (default: all repos)
• --use-cache — Use cached data instead of fetching from GitHub API

Output

All output goes to cache/ directory within the tool folder.

Path	Content
cache/json/{owner}-{name}.json	Raw issues + PRs JSON
cache/issues-md/{owner}-{name}/*.md	Individual issue markdown files
cache/reports/{owner}-{name}/triage-report-full.md	Full report: all categories, duplicates, clusters
cache/reports/{owner}-{name}/triage-report-priority.md	Shorter priority-focused report

For RTK specifically:

• cache/json/reduxjs-redux-toolkit.json
• cache/issues-md/reduxjs-redux-toolkit/
• cache/reports/reduxjs-redux-toolkit/triage-report-full.md
• cache/reports/reduxjs-redux-toolkit/triage-report-priority.md

Report Contents

The priority report includes:

• Overview stats (issue/PR counts, categorization rate)
• Category breakdown table
• Top priority issues (by score)
• Top bugs
• Quick wins (easy fixes)
• Urgent bugs
• Work clusters (related issues)

The full report adds:

• All categories with full issue lists
• Duplicate detection groups
• More detailed clustering

Categorization

Issues are categorized by matching labels, title keywords, and body content against category configs. RTK categories include:

• rtk-query (queries, cache, polling, mutations, SSR, error-handling, etc.)
• codegen (OpenAPI code generation)
• core (createSlice, configureStore, createAsyncThunk, middleware)
• typescript (type errors, inference)
• documentation
• build-tooling
• publishing
• architecture
• migration
• future-planning
• uncategorized

See references/rtk-categories.ts for full category definitions with keywords and patterns.

Troubleshooting

"GitHub CLI (gh) not found" Install from https://cli.github.com/

"Not authenticated" Run gh auth login

"Rate limit exceeded" Wait ~1 hour or use --use-cache with existing data

Empty/corrupted cache Delete cache/json/{repo}.json and re-run without --use-cache

References

• references/repos.ts — Configured repositories
• references/rtk-categories.ts — RTK category definitions (keywords, patterns, weights)