issue-workflow

Automate GitHub issue-driven workflows with start, checkpoint, and finish phases.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/georgernstgraf/aitranscribe-windows --skill issue-workflow-georgernstgraf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-workflow
Source: https://github.com/georgernstgraf/aitranscribe-windows/tree/main/skills/issue-workflow
Command: npx skills add https://github.com/georgernstgraf/aitranscribe-windows --skill issue-workflow-georgernstgraf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill standardizes how teams manage GitHub issue-centered work from start through checkpoints to final completion, ensuring traceable progress and consistent practices.

Core Features & Use Cases

  • Start, commit, and finish modes coordinate work around a single issue, with clear progress updates and structured commits.
  • Enforce issue references in commit messages and support formal parent-child relationships via Sub-Issues for large tasks.
  • Provide guidance for creating or linking issues, updating descriptions, and closing work when complete.

Quick Start

Invoke issue-start with an issue key and optional context to begin tracking work.

Frequently Asked Questions about issue-workflow

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

FAQPage Schema
How do I automate GitHub issue workflows from start to finish?

Automating GitHub issue workflows involves coordinating start, checkpoint, and finish phases tied to specific issues to ensure traceable progress. This Skill standardizes issue-driven project work by enforcing issue references in commits and managing structured progress updates across individual issues or related sub-issues.

How can I enforce issue references in commit messages for GitHub projects?

Enforcing issue references in commit messages is handled automatically during the commit and finish phases of issue-driven work. This ensures traceable progress by linking structured commits directly to their corresponding GitHub issues or formal parent-child sub-issues.

What is the best way to manage parent-child sub-issues in GitHub?

Managing parent-child sub-issues in GitHub is supported by creating formal relationships for large tasks during the issue-driven workflow. This Skill provides guidance for linking issues, updating descriptions, and coordinating progress updates across related sub-issues.

Do I need the GitHub CLI to create and link issues for workflow automation?

Yes, creating or linking issues via `gh` is supported to initiate and track workflow phases. The GitHub CLI is utilized to apply mode-specific behavior with safety checks, ensuring clear guidance for starting, checkpointing, and finishing issue-driven work.

Can I update issue descriptions and close work automatically upon completion?

Updating issue descriptions and closing work upon completion is supported through the finish mode of the issue-driven workflow. This ensures formal closure of GitHub issues by applying safety checks and coordinating delivery milestones across the tracked tasks.

How do I start tracking work for a specific GitHub issue?

To start tracking work, you invoke the issue-start phase with an issue key and optional context. This begins the issue-driven workflow, applying mode-specific behavior and safety checks to coordinate structured commits and progress updates for that issue.