github-workflow

Orchestrates issue-driven GitHub workflows across project boards, milestones, epics, and pull requests.

1|1|Updated Aug 2, 2026
One-click install
npx skills add https://github.com/blac9216/waypoint --skill github-workflow-blac9216
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github-workflow
Source: https://github.com/blac9216/waypoint/tree/main/.claude/skills/github-workflow
Command: npx skills add https://github.com/blac9216/waypoint --skill github-workflow-blac9216

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Coordinating multi-session development work on GitHub — picking up issues, dispatching subagents, reviewing PRs, and keeping a project board honest — breaks down when state lives in chat memory instead of on GitHub. This Skill enforces a disciplined, board-driven workflow where every session can be reconstructed from GitHub state alone. ## Core Features & Use Cases - Issue-driven execution: Resolves a target (issue, epic, milestone, triage queue, or next-ready), claims it, gates on planning readiness, and drives it through implementation, contextless review, merge, and live validation. - Solo and orchestrated modes: Works alone on single issues or acts as the sole orchestrator of parallel implementer, fix-round, reviewer, and validation subagents with strict role separation. - State on GitHub, not in chat: Claims, board columns, epic event comments, session logs, and structured handoffs keep milestones, epics, and issues as the single source of truth across sessions and crashes. - Use Case: Tell the agent "work epic 1176 in parallel overnight" — it claims the epic, dispatches implementers per issue, routes every PR through a fresh reviewer, files deferred findings, runs maintenance passes, and delivers a morning brief with metrics. ## Quick Start Ask the agent to work a specific issue, epic, or milestone — for example, "work issue 1140 solo" or "work the triage queue" — and it will orient from the board, claim the work, and execute the full workflow.

Frequently Asked Questions about github-workflow

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

FAQPage Schema
How do I start work on a GitHub issue with this workflow?▼

Invoke the skill with a target like an issue number, epic, milestone, or "next ready". It orients from the board and process docs, claims the work via the Claimed by field, checks the readiness gate, then implements or dispatches subagents through the review loop.

How does the workflow coordinate parallel subagents on GitHub?▼

The orchestrator claims an epic in the board's Claimed by field and dispatches implementer, fix-round, and reviewer agents with disjoint area scopes. Claims go stale after 24 hours of inactivity, and every agent prompt names other live claims to prevent collisions.

Does this workflow work with the gh CLI and GitHub MCP tools?▼

Yes, it supports both environments with an explicit command mapping. Local sessions use the authenticated gh CLI, while cloud sandboxes use GitHub MCP tools with owner and repo passed explicitly; some operations like project board edits are local-only.

Can I merge my own pull request in this workflow?▼

No, every non-trivial PR must be approved and squash-merged by a fresh contextless reviewer agent. The only exception is a trivial fast path: three or fewer files, fifty or fewer changed lines, no executable code, and nothing under docs/adr/.

What happens when a session crashes or hits a usage limit mid-task?▼

State lives entirely on GitHub — board columns, claims, epic event comments, and PR threads — so a new session re-orients from GitHub and resumes. An hourly heartbeat cron can self-resume overnight sessions, and uncommitted work is recovered from the agent's worktree.

When does the workflow run live validation instead of just code review?▼

Validation runs when an epic's runnable slice completes, when pending-live merges exceed the repo threshold, after a fix-wave merges, or on morning cleanup with pending items. A dedicated validation agent proves goal statements on a real stack under a zero-workaround bar.