gh-issues

Automates GitHub issue triage, background fix agents, and PR creation via gh CLI.

Updated Jun 19, 2026
One-click install
npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill gh-issues-amirulandalib
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-issues
Source: https://github.com/AmirulAndalib/Vilvona-AI/tree/main/skills/gh-issues
Command: npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill gh-issues-amirulandalib

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually triaging GitHub issues, writing fixes, opening pull requests, and responding to review comments is repetitive and slow. This Skill automates the entire issue-to-PR pipeline so fixes are produced by background agents without constant supervision. ## Core Features & Use Cases - Issue Fetching and Filtering: List open issues by label, milestone, assignee, state, and limit using the GitHub CLI, with duplicate-work detection against existing branches and PRs. - Background Fix Workers: Spawn up to 8 parallel agents that create fix branches, implement minimal changes, run tests, and open PRs with conventional commit messages. - Review Comment Processing: Discover actionable PR review comments on fix branches and dispatch workers to patch, test, and reply with commit references. - Watch and Cron Modes: Continuously poll issues and reviews on an interval, or run one-shot in cron mode with claim files preventing overlapping work. - Use Case: Point the Skill at a repository with a backlog of labeled bugs; it claims issues, spawns fix agents, opens PRs, and later addresses reviewer feedback automatically. ## Quick Start Ask the assistant to fetch open issues from the current repository, pick candidates, and spawn background agents to open fix PRs.

Frequently Asked Questions about gh-issues

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically fix GitHub issues and open pull requests?

Use the gh CLI to list open issues with filters like label or assignee, then spawn background workers that create fix/issue-<n> branches, implement minimal fixes, run tests, and open PRs against the base branch with a Fixes reference in the body.

How to process GitHub PR review comments automatically?

Fetch review threads with gh pr view and the pulls/comments API, group actionable comments per PR, then spawn a worker that checks out the PR branch, patches the changes, runs tests, pushes normally, and replies to each addressed comment with the commit reference.

Does this workflow support forks instead of pushing to the source repo?

Yes, fork mode pushes fix branches to a specified fork while opening PRs against the source repository. It configures a fork remote after confirmation and never mutates remotes during dry runs.

What happens if a fix branch or PR already exists for an issue?

The workflow skips candidates that already have an open PR, an existing fix/issue-<n> branch, or an active local claim. Claim files expire after two hours to prevent stale locks from blocking new work.

Why does the GitHub issue automation stop at the auth step?

It stops when gh auth status fails and no GH_TOKEN is available, since all issue and PR operations require GitHub authentication. Provide a GH_TOKEN in the environment or skill config, or authenticate the gh CLI, then rerun.