Agent skill · software engineering · steipete
gh-issues
Fetch GitHub issues, select candidates, spawn background fix agents, open PRs, and optionally process PR review comments.
Why this skill is useful
Adds executable scripts for automating GitHub issue management and PR creation that are not covered in public documentation.
What it needs
Requires gh, git installed locally. Requires github account access. About 3k tokens when loaded. Last updated 2026-08-07. 385,400 stars on the source repository.
What this skill does
gh-issues Use for issue-to-PR automation. Prefer gh CLI; fall back to gh api only when a high-level command lacks the needed field. Arguments positional owner/repo: optional; else infer from git remote get-url origin. --label <label>: filter. --limit <n>: default 10. --milestone <title>: filter. --assignee <login @me>: filter. --state open closed all: default open. --fork <owner/repo>: push branches to fork, PR to source. --watch: poll issues + reviews. --interval <minutes>: default 5. --dry-run: list only. --yes: no confirmation. --reviews-only: skip issue fixing; handle PR reviews. --cron: spawn and exit; implies --yes. --model <id>: pass to workers when supported. --notify-channel <id>: optional final notification target. Phase 1: resolve repo If gh auth status fails and GHTOKEN is missing, stop and ask for GitHub auth/config. Derived: SOURCEREPO: issue repo. PUSHREPO: fork if set, else source. BASEBRANCH: source default branch unless user says otherwise. PUSHREMOTE: fork in fork mode, else origin. Stop on dirty worktree unless user confirms that workers should ignore uncommitted changes. In fork mode, do not mutate remotes before confirmation or during --dry-run. Verify auth/read access only: Phase 2: fetch issues Build filters and fetch: Add --label, --milestone, --assignee, --state, --limit as requested. gh issue list already excludes PRs. If none found: report no matches. If --dry-run: show compact list and stop. Phase 3: avoid duplicate work For each candidate: Skip candidates with an open PR, existing branch, or active local claim. Claim file: Expire claims older than 2 hours. Create the parent directory before writing. Phase 4: confirm Unless --yes or --cron, ask user to choose: all comma-separated issue numbers cancel After confirmation, in fork mode, configure the push remote before handing work to agents: Phase 5: spawn workers Launch up to 8 background workers. Do not block on each worker when --cron. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills steipete/gh-issues