Skip to main content
skill CX Codex

issue-tracer · zaxbyhub — Claude Code skill: what it does, how to install

issue-tracer walks a bug from reproduction to a PR-ready fix: locate the cause, plan the patch, get it reviewed.

MIT ★ 539 updated 2026-10-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ZaxbyHub/opencode-swarm --skill issue-tracer -a claude-code
Open on GitHub

What issue-tracer does

Reach for it when you hand over a bug report, a regression, a failing test or runtime behaviour you can't explain. The skill file is a thin adapter for Codex: the real procedure sits in .opencode/skills/issue-tracer/SKILL.md, and this one points there and maps the tooling.

Edits go through apply_patch, the task list through update_plan, web lookups through web with cited URLs. Shell work uses rg, git, gh, plus your tests and builds. Three gates (a plan critic in phase 3, implementation review in 4.5, a final critic in 4.6) expect a subagent. When none is available the skill logs the failure, runs a labelled fallback and discloses it in the report; gate artefacts come from .opencode/skills/issue-tracer/references/critic-gate.md.

trace-init.sh <issue-slug> creates the trace directory from the repo root, scan-deferred.sh is the deferred-work gate. Commits, pushes and PRs happen only when you ask, via .agents/skills/commit-pr/SKILL.md.

What it helps with

  • reproduce a failing test and pin down its cause
  • trace a regression back through a bug report
  • draft a fix plan with no gaps left open
  • wipe out a whole class of repeat failures
  • carry an issue to a PR with the diff reviewed

Example prompts for the agent

  • Trace this bug report: reproduce the crash, find the cause, then draft a fix plan.
  • Run trace-init.sh <issue-slug> and drop the repro steps and test output in there.
  • Run scan-deferred.sh and list what got left for later.

How to install issue-tracer

1Skills CLI (Vercel)

npx skills add ZaxbyHub/opencode-swarm --skill issue-tracer -a claude-code

2Manually: put the files in place

~/.claude/skills/issue-tracer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/issue-tracer/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about issue-tracer

How do I install issue-tracer in Claude Code?

Run npx skills add ZaxbyHub/opencode-swarm --skill issue-tracer -a claude-code. The skill lands at ~/.claude/skills/issue-tracer/SKILL.md.

What does issue-tracer do?

It takes an issue through reproduction, cause localization and fix planning, then sends the result to a critic. What comes out is a closure ready for a PR.

Do the review gates need a subagent?

The plan critic, the implementation review and the final critic all require delegation. With no subagent around, the skill records the failure and runs a labelled fallback it discloses.

Source text

SKILL.md · MIT
---
name: issue-tracer
description: >
  Use when asked to trace, investigate, root-cause, reproduce, plan, fix,
  resolve, close, or prepare a PR for an issue, bug report, defect, regression,
  failing test, or confusing runtime behavior. This Codex adapter delegates to
  the canonical protocol at .opencode, which owns the Full-Resolution Contract,
  reproduction, reasoning-guided localization, no-gap fix planning,
  recurrence-class eradication, independent critic and implementation review,
  and PR-ready closure.
metadata:
  version: 3.0.0
  audience: swarm-plugin
---

# Issue Tracer

Follow the canonical workflow at `../../../.opencode/skills/issue-tracer/SKILL.md`.

## Codex Tools

- File-edit: `apply_patch`. Tasklist: `update_plan`. Web: `web` (cite URLs).
- Shell: `rg`, `git`, `gh`, tests, builds. Subagent dispatch: per your runner config.

## Gates and Delegation

Plan critic (Phase 3), implementation review (Phase 4.5), and final critic (Phase 4.6) require subagent delegation when available. Receive only diff and artifacts from the canonical protocol's `.opencode/skills/issue-tracer/references/critic-gate.md`. When unavailable, record the failure, run the labeled fallback, and disclose it.

## Scripts and Publication

Trace directory created by `.opencode/skills/issue-tracer/scripts/trace-init.sh <issue-slug>` (from repo root). Deferred-work gate: `.opencode/skills/issue-tracer/scripts/scan-deferred.sh`. Publication via `.agents/skills/commit-pr/SKILL.md` only when user asks to commit/push/open PR.

© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm

Similar skills

All skills for Agent setup: memory, context, orchestration →

issue-tracer by other authors comes first.

issue-tracer ZaxbyHub issue-tracer takes a bug from reproduction to a PR-ready fix: locates the cause, plans the change, and puts it through critic review. CX Codex +1 ★ 539repo stars issue-tracer ZaxbyHub issue-tracer drives bug reports from reproduction and root-cause analysis to verified PRs under a strict full-resolution contract. CX Codex +1 ★ 539repo stars debug-issue tirth8205 The debug-issue Claude Code skill traces bugs through a code graph. It kicks in to locate a fault, follow its execution path, and assess the reach of a fix. CX Codex +1 1,100installs pr-issue-resolve safayavatsal The pr-issue-resolve plugin examines pull requests and implements the changes reviewers request. Use it to quickly work through code review feedback and apply corrections. ★ 1,013repo stars triage-issue-local dominikmartn triage-issue-local is a Claude Code skill for Warp issue triage. It applies repository-specific guidance on top of the core triage-issue skill. CX Codex +1 ★ 720repo stars issue-triage Cobus Greyling issue-triage is a Claude Code skill that sorts open issues and discussions, spots possible duplicates, and suggests priorities and labels. It writes results to issue-triage-state.md. CX Codex +1 ★ 11,819repo stars Issue Triage Agent microsoft Issue Triage Agent — a subagent for triaging individual GitHub issues. It categorizes tickets, assigns component labels, and sets priority levels based on repository guidelines. CX Codex +1 ★ 1,627repo stars agent-2-issue-analyst happycapy-ai agent-2-issue-analyst is a Claude Code subagent that turns a chosen GitHub issue into a spec with complexity, files to touch and an ordered fix plan. CX Codex ★ 138repo stars

From the same set121

The whole set →
run-test-suite-after-registration-changes The run-test-suite-after-registration-changes skill calls for running the test suite after registration edits and checking that each registration point stays in sync. Use it when changing skill files and their manifests. CX Codex +1 ★ 539repo stars grep-for-mock-module-across-the-entire-test-file-and-confirm-eve grep-for-mock-module-across-the-entire-test-file-and-confirm-eve is a Claude Code skill that checks every mock.module call in a test file for real-export spreads during a Vitest-to-Bun migration. CX Codex +1 ★ 539repo stars codebase-review-swarm codebase-review-swarm runs quote-grounded code reviews and security or QA audits without editing project files. Built for deep inspections across entire codebases or large subsystems. CX Codex +1 ★ 539repo stars run-relevant-tests-after-adding-error-handling-wrappers run-relevant-tests-after-adding-error-handling-wrappers is a Claude Code skill that prompts an agent to run relevant tests after adding error handling and check the success path's original return type and value. CX Codex +1 ★ 539repo stars swarm-ci-monitor swarm-ci-monitor monitors CI runs on approved pull requests, repairs broken checks within five cycles, and merges the branch once tests pass. CX Codex +1 ★ 539repo stars restore-internals-seams-in-finally-blocks-after-each-test restore-internals-seams-in-finally-blocks-after-each-test is a Claude Code skill that directs agents to restore original _internals in finally after each test of error paths through DI seams. CX Codex +1 ★ 539repo stars check-skill-provenance-stamps-before-archiving-knowledge-entries check-skill-provenance-stamps-before-archiving-knowledge-entries is a Claude Code skill that checks source_refs and UUIDs before archiving knowledge entries, stopping removal if an active skill depends on one. CX Codex +1 ★ 539repo stars consult consult enforces an advisory protocol with strict read-before-cite checks and explicit uncertainty levels. CX Codex +1 ★ 539repo stars

Project sponsors

Companies that keep this analytics open