# issue-tracker

The issue-tracker Claude Code skill defines terms and conventions for GitHub issues. It activates for issue and board work in clhbid repositories.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 795 installs
- Author: clhbid
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/clhbid/agent-context/tree/HEAD/skills/issue-tracker/SKILL.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/issue-tracker

## What it does

The skill establishes a vocabulary for GitHub work, distinguishing cycles, issue categories, epics, committed issues, and slipped commitments. It also sets conventions for creating, reading, commenting on, linking, and closing issues.

GitHub operations use the `gh` CLI. Issue state belongs to the CLHbid Delivery project rather than an issue label. The skill also defines issue reference formats and how to resolve a number that might belong to a pull request.

Its conventions target clhbid repositories and use GitHub through `gh`.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add clhbid/agent-context --skill issue-tracker -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/issue-tracker/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/issue-tracker/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add clhbid/agent-context --skill issue-tracker -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/issue-tracker/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add clhbid/agent-context --skill issue-tracker -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/issue-tracker/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install clhbid/agent-context skills/issue-tracker
```

2. **Manually: put the files in place**
- File: `.github/skills/issue-tracker/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add clhbid/agent-context --skill issue-tracker -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/clhbid/agent-context --path skills/issue-tracker
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/issue-tracker/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add clhbid/agent-context --skill issue-tracker -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/clhbid/agent-context/tree/HEAD/skills/issue-tracker/SKILL.md

## When to use it
- distinguish an epic from an issue committed to a cycle
- link a child issue to its parent
- record a reason when closing an issue
- reference an issue from the correct repository

## Example prompts
- Sort the issues in this repository using the issue-tracker conventions.
- Create a child issue and attach it to its epic.
- Close this issue as deferred and explain why in a comment.

## Similar
- [issue-triage](https://affpapa.org/en/nevibecode/skills/issue-triage.md) — skill · ★ 92149 repo stars
- [gh-issue-sync](https://affpapa.org/en/nevibecode/skills/gh-issue-sync.md) — skill · 28500 installs
- [oss-issue-triage](https://affpapa.org/en/nevibecode/skills/oss-issue-triage.md) — skill · 13400 installs
- [om-followup-issue-from-pr](https://affpapa.org/en/nevibecode/skills/om-followup-issue-from-pr.md) — skill · 3700 installs
- [resolve-issue](https://affpapa.org/en/nevibecode/skills/resolve-issue.md) — skill · 1200 installs
- [issue-create](https://affpapa.org/en/nevibecode/skills/terrylica-issue-create.md) — skill · 129 installs

From the same set: [clhbid/agent-context](https://affpapa.org/en/nevibecode/by/clhbid/agent-context.md) — 8 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
