Fix Issues Skill

Automated workflow: GitHub bug issues → analyze → fix → PR.

Announce at start: "I'm using fix-issues skill to find and fix a GitHub bug issue."

Operating Modes

Batch Mode (default)

Invocation: /fix-issues

• Fetches open bug issues, finds the best candidate, fixes it
• Runs full Phase 1 → Phase 2 → Phase 3
• Fixes 1 issue per invocation

Daemon Mode

Invocation: /fix-issues limit=1 (from daemon script)

• Phase 1 uses priority descent: high-signal issues first, then progressively lower
• Fixes only 1 issue (controlled by limit parameter), then exits
• If no fixable issue exists → outputs [NO_FIXABLE_ISSUES] and exits

Prerequisites

• gh CLI must be authenticated
• Working directory will be auto-cleaned (stash + checkout main) at startup

Workflow

Phase 1: Collect & Filter Issues

Step 1.1: Verify Environment

git status --porcelain
git branch --show-current

If working directory has staged or modified tracked files, stash them and proceed:

git stash -m "fix-issues: auto-stash before starting"

Do NOT use --include-untracked - untracked files (like skill files not yet merged to main) must remain in the working directory.

Then switch to main:

git checkout main
git pull origin main

Step 1.1b: Load Skip List (Daemon Mode Only)

In daemon mode (limit > 0), load the skip list to avoid re-analyzing issues that were already triaged in previous sessions. The skip list is stored at:

~/.wayland-fix-issues/skip-list.json

Format: