issue-workflow

Coordinate project work using GitHub issues as the single source of truth.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Issue-driven workflow using GitHub issues as the source of truth. Use when asking "what's next?", checking project status, updating progress, or managing work priorities.

Core Features & Use Cases

  • Pull active epic context and recent learnings to guide the conversation.
  • Identify next task from build order with blockers and dependencies.
  • Score tasks for complexity and route to appropriate action (direct implement vs. plan mode).
  • Best practice: close completed sub-issues to keep progress transparent.

Quick Start

Pull the active epic, read its status, identify the next task, score it, and present routing options.

Frequently Asked Questions about issue-workflow

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

FAQPage Schema
How do I use GitHub issues to track project progress and manage work priorities?

GitHub issue-driven workflow uses issues as your single source of truth for planning, progress tracking, and task selection. Pull active epic context to identify next tasks, score them for complexity, and route work to appropriate action based on blockers and dependencies.

What's the best way to organize epics and sprints using GitHub issues?

Structure work by pulling active epic context and recent learnings, then identify next tasks from your build order. Close completed sub-issues to keep progress transparent and update epic checklists as work advances through planning and implementation phases.

How do I identify blockers and dependencies when selecting the next task from GitHub issues?

Score tasks for complexity while examining issue context for blockers and dependencies. This routing determines whether work needs plan mode for high-impact decisions or direct implementation, ensuring disciplined task selection and progress updates.

Can I use GitHub issues as a single source of truth for coordinating team work across epics and sprints?

Yes. GitHub issue-driven workflow consolidates coordination and status-tracking by enforcing a single source of truth. Use it for managing work priorities, checking project status, updating progress, and maintaining transparency through closed sub-issues and updated epic checklists.

When should I move work to plan mode versus implementing directly from GitHub issues?

Score task complexity and examine blockers identified in issue context. High-impact work or tasks with significant dependencies route to plan mode for upfront design; straightforward tasks with no blockers move to direct implementation.

Why close completed sub-issues in GitHub instead of just marking them done?

Closing completed sub-issues maintains transparency and enforces discipline around work completion. It keeps epic checklists accurate and ensures your GitHub issues remain a reliable single source of truth for current project state and progress tracking.