gh-issues (GitHub Issues Orchestrator)

What it does

gh-issues is an orchestrator skill that fetches GitHub issues, runs pre-flight checks, and spawns focused sub-agents to implement fixes and open pull requests. It automates the full lifecycle: argument parsing, issue selection, branch/PR creation (using curl + GitHub REST API), and review-handling via review-fix sub-agents. It supports cron and watch modes, fork-mode workflows, and claim-based in-progress tracking.

When to use it

Use this skill when you want to: fetch and triage issues programmatically; have automated agents attempt targeted code fixes and open PRs; monitor PR review comments and spawn follow-up fix agents; or run on a schedule (cron) to process issues incrementally. It's designed for repos where automated fixes are plausible and safe to attempt.

What's included

• Scripts: none bundled in the skill directory (has_scripts=false)
• References: none listed (has_references=false)
• Instructions: Detailed 6-phase procedure covering argument parsing, fetching issues via the GitHub API, pre-flight git checks, spawning parallel sub-agents with sessions_spawn, and monitoring/handling PR reviews. Includes cron/watch modes, token resolution, and claim & cursor file patterns.

Compatible agents

This skill is intended for OpenClaw-style agents capable of running shell exec, sessions_spawn, and using environment-injected GH_TOKEN. It expects curl and git available in the runtime and spawns sub-agents that can run code-fix workflows (models like glm-5, codex-family, or other code-capable LLMs).