issue-runner

Automate a GitHub issue through branch, plan, implement, test, review, and merge phases.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/paulyokota/FeedForward --skill issue-runner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-runner
Source: https://github.com/paulyokota/FeedForward/tree/main/.claude/skills/agenterminal-issue-runner
Command: npx skills add https://github.com/paulyokota/FeedForward --skill issue-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maintainers and teams frequently manage a single GitHub issue through multiple phases (branching, planning, implementing, testing, reviewing, and merging). This Skill orchestrates that lifecycle automatically, reducing context switching and manual coordination.

Core Features & Use Cases

  • End-to-end issue workflow: branch, plan, implement, test, review, and merge.
  • Orchestrator-driven session management: one issue per fresh session.
  • Environment-aware progress tracking: updates issue-progress.json at every phase.
  • Real-world use case: automatically fix an issue by spawning a feature branch, generating a plan, and merging upon successful tests.

Quick Start

Submit an issue to be processed by the orchestrator, which will drive branching, planning, implementing, testing, review, and merge.

Frequently Asked Questions about issue-runner

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

FAQPage Schema
How do I automate a GitHub issue lifecycle from branch creation to merge?

You can automate the full GitHub issue lifecycle by running each issue through a fresh orchestrator session that drives branch creation, planning, implementation, testing, review, and merge sequentially without manual coordination.

What does end-to-end issue workflow automation include?

End-to-end issue workflow automation includes branching, planning, implementing, testing, reviewing, and merging a single GitHub issue. It manages each phase sequentially within an orchestrator-driven session to minimize context switching.

How do I track GitHub issue progress through implementation phases?

Track GitHub issue progress by maintaining an issue-progress.json file with a strict schema and top-level phase field. The automation updates this file at every phase to provide environment-aware progress tracking throughout the lifecycle.

Do I need an orchestrator to run single-issue workflows?

Yes, single-issue workflows require an orchestrator to drive the session. The orchestrator processes issues one-by-one, enforcing per-phase orchestration with mandatory environment handling and agent interactions across the dev-lifecycle.

Can I automate feature branch creation and pull requests for a single issue?

Yes, automating feature branch creation and pull requests for a single issue is the core function. The workflow spawns a feature branch, generates a plan, implements changes, runs tests, and merges the pull request upon successful completion.

What are the limitations of automated single-issue lifecycle management?

Automated single-issue lifecycle management processes one issue per fresh session and enforces a strict issue-progress.json schema. It is designed for sequential per-phase orchestration rather than parallel multi-issue batch processing.