Agent skill

Fix Gh Issue

by beatlabs in beatlabs/harvester

Fix a single GitHub issue end-to-end using wt. An agent skill from beatlabs/harvester.

Apache-2.0Auto-check passedDevelopment

Install Fix Gh Issue

skills CLI
$ npx skills add beatlabs/harvester --skill fix-gh-issue -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install beatlabs/harvester fix-gh-issue --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/beatlabs/harvester.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.opencode/skills/fix-gh-issue .claude/skills/fix-gh-issue && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
fix-gh-issue
GitHub stars
135
Token cost
~783 tokens
SKILL.md length
283 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
Apache-2.0

At a glance

Fix a single GitHub issue end-to-end using wt. An agent skill from beatlabs/harvester.

  • Works in 6 steps: Create worktree → Implement the fix → Wait for PR → …
  • Phrases: fix issue
  • SKILL.md covers Inputs, Derived values, Phase 1 — Create worktree and Phase 2 — Implement the fix, plus 5 more sections
  • Calls gh, git and go

What it does

Fix Gh Issue is an agent skill from beatlabs/harvester. Fix a single GitHub issue end-to-end using wt. Creates a worktree, implements the fix, waits for CI, squash-merges, and removes the worktree. Trigger phrases: 'fix issue', 'fix gh issue', 'work on issue', 'start issue', 'launch issue'.

Its SKILL.md is about 780 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Git worktrees. It works with GitHub and Go. The repository describes itself as: Harvest configuration, watch and notify subscriber. The licence is Apache-2.0.

When your agent uses it

  • Phrases: fix issue
  • Tasks that involve Git worktrees

Example prompts

  • “fix issue”
  • “fix gh issue”
  • “work on issue”
  • “/fix-gh-issue”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Create worktree
  2. Implement the fix
  3. Wait for PR
  4. Wait for CI
  5. Squash-merge
  6. Remove worktree

What it can do on your machine

Read from SKILL.md and the folder at commit ccfeaee. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh
    • git
    • go

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gh and git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Fix Gh Issue loads about 783 tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 283 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~62
When it runs · the whole SKILL.md, loaded when a task matches
~783

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from beatlabs/harvester at commit ccfeaee, republished under its Apache-2.0 licence (© beatlabs). 283 words, ~783 tokens.

Download SKILL.mdSave it as .claude/skills/fix-gh-issue/SKILL.md (or your agent's skills folder).
name
fix-gh-issue
description
Fix a single GitHub issue end-to-end using wt. Creates a worktree, implements the fix, waits for CI, squash-merges, and removes the worktree. Trigger phrases: 'fix issue', 'fix gh issue', 'work on issue', 'start issue', 'launch issue'.
argument-hint
<issue-number> [branch-name] [prompt]

fix-gh-issue Skill

Orchestrate a single GitHub issue through the full lifecycle: worktree → implement → PR → CI → squash-merge → cleanup.

Works in any git repository with a GitHub remote.

Inputs

Extract from the user message:

  • ISSUE — GitHub issue number (required, e.g. 42)
  • BRANCH — branch name (optional — auto-derived if omitted)
  • PROMPT — custom prompt describing the fix (optional — default below)

If ISSUE is missing, ask before proceeding.

Derived values

Resolve at runtime — do not hardcode paths or repo names:

bash
REPO_PATH=$(git rev-parse --show-toplevel)
REPO_NAME=$(basename "$REPO_PATH")

If BRANCH was not provided, derive it from the issue title:

bash
BRANCH=$(gh issue view "$ISSUE" --json number,title \
  --jq '"fix/\(.number)-\(.title | gsub("^[a-z]+: "; "") | ascii_downcase | gsub("[^a-z0-9]+"; "-") | gsub("(^-|-$)"; "") | split("-")[0:6] | join("-"))"')

Then:

bash
BRANCH_SAFE="${BRANCH//\//-}"
WORKTREE_PATH="${REPO_PATH}/../${REPO_NAME}.${BRANCH_SAFE}"

Default prompt (if none supplied):

Fix GitHub issue #<ISSUE> on branch <BRANCH>.
Run all tests before pushing.
Create a PR that closes #<ISSUE>.

Phase 1 — Create worktree

bash
wt -C "$REPO_PATH" switch --create "$BRANCH" --no-cd

Skip if $WORKTREE_PATH already exists.

Phase 2 — Implement the fix

Work directly in $WORKTREE_PATH. Follow the prompt to implement, test, commit, and push. Create the PR:

bash
gh pr create --title "..." --body "Closes #<ISSUE>" --head "$BRANCH"

Phase 3 — Wait for PR

If the PR was created by a separate agent or process, poll every 60 seconds (up to 2 hours):

bash
gh pr list --head "$BRANCH" --json number --jq '.[0].number'

gh auto-detects the repo from the git remote. Log progress every 10 minutes. If no PR after 2 hours, stop and report.

Phase 4 — Wait for CI

bash
gh pr checks "$PR_NUMBER" --watch --fail-fast

If CI fails: fix the issue in $WORKTREE_PATH, push, then re-run this phase.

Phase 5 — Squash-merge

bash
gh pr merge "$PR_NUMBER" --squash --delete-branch

Phase 6 — Remove worktree

bash
wt -C "$REPO_PATH" remove -D "$BRANCH"

Parallel execution

Each issue runs in its own isolated worktree — no filesystem conflicts. Run multiple issues in parallel freely. If two branches modify the same file, GitHub will flag the merge conflict on the PR when it's time to merge; deal with it then.

Integration test limitation: Integration tests share a single Consul and Redis instance with hardcoded keys. Running go test -tags=integration from two worktrees simultaneously will cause key collisions and flaky failures. Only one worktree should run integration tests at a time — coordinate manually or stagger the test runs.

© beatlabs, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .opencode/skills/fix-gh-issue of beatlabs/harvester.

Open the folder on GitHubat commit ccfeaee

Compare with similar skills

Fix Gh Issue next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Fix Gh Issue compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fix Gh Issue this skillbeatlabs/harvester135—~783Automated safety check: PassApache-2.0
Run Dozzle Dev Instanceamir20/dozzle15k—~747Automated safety check: PassMIT
Fixexercism/website549—~1.2kAutomated safety check: NotesAGPL-3.0
Verify PRvfarcic/dot-agent-deck109—~7.3kAutomated safety check: PassMIT
Go-Redis Release Preparationredis/go-redis22k—~1.1kAutomated safety check: PassBSD-2-Clause
Pre-Release PR Triagejamiepine/voicebox57k—~3.1kAutomated safety check: PassMIT

Similar skills

  • Starts a Dozzle dev server on a port derived from the current worktree so you can test by hand in a browser, without disturbing instances started elsewhere.

    15k GitHub stars~747 tokensUpdated today
    DevelopmentAuto-check passed
  • Fix

    exercism/website

    Fix a GitHub issue end-to-end — fetches issue, creates worktree, plans and implements fix, runs validation, opens PR, cleans up.

    549 GitHub stars~1.2k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Verify PR

    vfarcic/dot-agent-deck

    Deeply verify a pull request written by someone else and end with an explicit merge recommendation.

    109 GitHub stars~7.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Official

    Prepares a go-redis release locally: picks the next semver, gathers merged PRs, writes the RELEASE-NOTES entry and bumps versions, without publishing.

    22k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Pre-Release PR Triage

    jamiepine/voicebox

    Sorts a backlog of open pull requests into must-merge, candidate, superseded and deferred, writes a triage doc and works the merge loop before a release.

    57k GitHub stars~3.1k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Machinist

    owainlewis/machinist

    Use Machinist to create, assign, and monitor software tasks.

    495 GitHub starsUsed in 1 repo~761 tokens
    DevelopmentAuto-check passed

Works with

Questions about Fix Gh Issue

What does Fix Gh Issue do?

Fix a single GitHub issue end-to-end using wt. An agent skill from beatlabs/harvester. Fix Gh Issue is an agent skill from beatlabs/harvester. Fix a single GitHub issue end-to-end using wt.

When should I use Fix Gh Issue?

Fix Gh Issue fits situations like: phrases: fix issue; tasks that involve Git worktrees.

How do I install Fix Gh Issue in Claude Code?

Run `npx skills add beatlabs/harvester --skill fix-gh-issue -a claude-code`. Or copy the skill folder (.opencode/skills/fix-gh-issue in beatlabs/harvester) into .claude/skills/fix-gh-issue in your project. Claude Code loads it when a task matches its description.

How do I install Fix Gh Issue in Codex?

Run `npx skills add beatlabs/harvester --skill fix-gh-issue -a codex`. Or copy the skill folder (.opencode/skills/fix-gh-issue in beatlabs/harvester) into .agents/skills/fix-gh-issue in your project. Codex loads it when a task matches its description.

Can I use Fix Gh Issue in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add beatlabs/harvester --skill fix-gh-issue -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fix-gh-issue, .gemini/skills/fix-gh-issue, .github/skills/fix-gh-issue and .opencode/skills/fix-gh-issue in your project.

What does Fix Gh Issue need to run?

Going by SKILL.md and its folder, Fix Gh Issue needs the command-line tools its instructions call (gh, git and go).

Does Fix Gh Issue access the network?

SKILL.md contains no URLs. Its commands use gh and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Fix Gh Issue safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Fix Gh Issue use?

Fix Gh Issue is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Fix Gh Issue use?

About 783 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Fix Gh Issue?

Skills that share tags, products or a category with Fix Gh Issue: Run Dozzle Dev Instance (amir20/dozzle, 15k stars), Fix (exercism/website, 549 stars), Verify PR (vfarcic/dot-agent-deck, 109 stars) and Go-Redis Release Preparation (redis/go-redis, 22k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fix Gh Issue?

beatlabs (a GitHub organization) maintains it in beatlabs/harvester, which has 135 GitHub stars. The repository was last updated on October 9, 2026.

Source: beatlabs/harvester on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.