Agent skill · operations · yonatangross
fix-issue
Fixes a GitHub issue: parallel root-cause analysis, a fix with tests, a PR linked back to the issue, and prevention notes. Use when fixing a bug, regression or reported issue.
Why this skill is useful
Adds executable scripts for root cause analysis and automated issue resolution that enhance debugging capabilities.
What it needs
Requires gh installed locally. Requires github account access. About 11k tokens when loaded. Last updated 2026-08-06. 215 stars on the source repository.
What this skill does
Fix Issue Host-neutral workflow. Invoke by skill name (fix-issue). Claude Code slash routing, YAML hook loaders, and .claude/chain live in references/claude-code.md. Systematic issue resolution with hypothesis-based root cause analysis, similar issue detection, and prevention recommendations. Quick Start Opus 5.5: Root cause analysis uses native adaptive thinking. Dynamic token budgets scale with context window for thorough investigation. CC ≥ 2.1.119 multi-host note (M122): Issue fetching works against GitHub, GitLab, Bitbucket, and GitHub Enterprise. The argument is either a numeric ID (use the configured default remote's host) or a full URL (parsed via parsePrUrl/parseIssueUrl from src/hooks/src/lib/pr-host-parser.ts). Branch on the detected host family for the right CLI: gh issue view (GitHub/GHE), glab issue view (GitLab), bb issue view (Bitbucket). Reference: src/skills/chain-patterns/references/pr-from-platform.md. Argument Resolution Check the target first, before any other step. This skill forks and cannot see the conversation. Load Read("../../shared/rules/target-resolution.md"): if the target, flags stripped, is a bare pronoun or deictic (this, them, that one) or empty, return exactly TARGETUNRESOLVED: <word> and stop. The caller resolves it and re-invokes. STEP -1: MCP Probe + Resume Check Run BEFORE any other step. Detect available MCP servers and check for resumable state. Load the issue the target names first. A fork skill never runs frontmatter hooks (#4683), so fetch ISSUENUMBER (the flags-stripped target, never $ARGUMENTS[0]) yourself and keep the result in mind. Do not call skill/issue-context-loader for this: it takes its number from the branch name, not from the argument, so on a branch like fix/ork10-... it loads a different issue. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills yonatangross/fix-issue