Does this skill require the GitHub CLI?

Yes, it leverages the 'gh' CLI to perform authenticated actions like reading issues, posting comments, and creating pull requests.

How does this skill track work across different sessions?

It maintains a local file at .claude/issue-state.json that tracks the current phase, branch name, and comment IDs. This allows Claude to resume work exactly where it left off.

Will this clutter my GitHub issue with many comments?

No, the skill is designed to update existing 'Design' or 'Plan' comments using the GitHub API (PATCH) rather than posting new ones every time a revision occurs.

Is the state file committed to my repository?

No, the skill automatically attempts to add the state file to your .gitignore to ensure session-specific data remains local to your environment.

Can I use this as a standalone skill?

While it contains useful patterns, it is optimized as a dependency for higher-level workflow skills like do-issue-guided or do-issue-solo to provide consistent behavior.

GitHub Issue Workflow

Name: GitHub Issue Workflow
Author: thermiteau

bythermiteau

0•

Herramientas de Colaboración

Standardizes GitHub issue management through automated state tracking, structured commenting, and seamless PR creation.

The GitHub Issue Workflow skill provides a robust framework for managing the entire lifecycle of a GitHub issue within Claude Code. By implementing a local state management system, it ensures that Claude can track its progress through distinct phases—from design and planning to implementation and completion—even across multiple sessions or subagents. This skill automates the retrieval of issue data, handles the posting and updating of structured status comments, and bridges the gap between issue tracking and git operations like branching and pull request creation. It is an essential foundational skill for teams looking to maintain high visibility and consistent documentation during AI-assisted development.

Características Principales

01Automated branch naming and tracking linked to issue state

02Automated posting and updating of Design and Implementation plan comments

030 GitHub stars

04Streamlined Pull Request creation with automatic issue closing references

05Structured data retrieval of GitHub issue metadata and comments

06Persistent local state tracking via .claude/issue-state.json

Casos de Uso

01Maintaining progress continuity during long-running coding tasks

02Automating the administrative overhead of linking issues to git branches and PRs

03Standardizing team communication by auto-updating issue threads with plans

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add thermiteau/maverick-private mav-github-issue-workflow

For use in Claude.ai and ChatGPT

Características Principales

01Automated branch naming and tracking linked to issue state

02Automated posting and updating of Design and Implementation plan comments

030 GitHub stars

04Streamlined Pull Request creation with automatic issue closing references

05Structured data retrieval of GitHub issue metadata and comments

06Persistent local state tracking via .claude/issue-state.json

Casos de Uso

01Maintaining progress continuity during long-running coding tasks

02Automating the administrative overhead of linking issues to git branches and PRs

03Standardizing team communication by auto-updating issue threads with plans