gh-context

An agent skill to triage GitHub Issues, providing high-confidence recommendations for actionable work.

Prerequisites

1. Install GitHub CLI and authenticate:

brew install gh
gh auth login

2. Install the gh-context binary:

cargo install gh-context

Installation

Install the agent skill with npx:

npx skills add hdcodedev/gh-context

Update it:

npx skills update gh-context

Quick start

Just run this inside any GitHub repository and it will find you the best actionable issue:

/gh-context

Automatically detects the repository from git origin and picks the top open issue candidate.

Example output:

Example output

# Recommended issue: #123 Fix crash on startup

Issue URL: https://github.com/owner/repo/issues/123

## Why pick this now
High impact crash affecting 20% of users, clear repro steps provided.

## Problem
Application crashes immediately on launch when offline. Root cause is unhandled network error in initialization.

## Fix direction
Add error handling around the network call in `src/init.ts:42`, fall back to cached config.

Confidence: 🟩 Obvious
Status: unowned
Blockers: None

Examples

Use slash command form for the skill. <input> can be:

• An issue number in the current repo: 123
• A full issue URL: https://github.com/hdcodedev/gh-context/issues/123
• Owner/repo#number shorthand: hdcodedev/gh-context#123

/gh-context <input>

/gh-context hdcodedev/gh-context#123

/gh-context 123
Explain the best next step and why it is important.

Quick notes

• Direct CLI usage is not recommended for most users. See docs/cli.md only if you need the standalone binary.