gh-issue

GitHub issue management for AI coding agents — find, view, create, update, close, assign, and auto-fix via gh CLI.

Works on Claude Code, Cursor, Gemini CLI, Windsurf, and more (full list).

Install

# Claude Code (recommended)
npx skills add ravvdevv/gh-issue -g -y

# Cursor
cp compat/cursor/gh-issue.mdc .cursor/rules/gh-issue.mdc

# Gemini CLI
cp compat/gemini/gh-issue/SKILL.md .gemini/skills/gh-issue/

# Manual (any agent)
git clone https://github.com/ravvdevv/gh-issue.git ~/.claude/skills/gh-issue

See compat/ for Windsurf, OpenCode, Kilo Code, Aider, and Augment setup.

Commands

Command	Description
find	Search issues by keyword, label, state, assignee
view <N>	Inspect issue + comments
create --title <t>	New issue with markdown body
update <N>	Edit title, body, labels
close <N>	Close with optional reason
assign <N> <login>	Add/remove assignees
fix <N>	Auto-fix: read → scope/trace/diagnose → implement → PR → merge
audit	Scan codebase for bugs/security gaps, file issues
changelog	Generate release notes from merged PRs
sprint	Milestone management (create, status, close)
debt	Scan for tech debt, file prioritized issues

Examples

/gh-issue find --label bug
/gh-issue fix 42
/gh-issue audit
/gh-issue changelog
/gh-issue debt

All commands run on current repo by default. Use --repo owner/repo for cross-repo.

Project

SKILL.md   ops/       11 operation refs
compat/    README.md  cross-agent adapters
llms.txt   install.sh

PRs welcome. MIT license.