Back to Skills

github-issue-workflow

Provides a structured 8-phase workflow for resolving GitHub issues in Claude Code. Covers fetching issue details, analyzing requirements, implementing solutions, verifying correctness, performing code review, committing changes, and creating pull requests. Use when user asks to resolve, implement, work on, fix, or close a GitHub issue, or references an issue URL or number for implementation.

320stars37forksUpdated 8/6/2026

Security Assessment

Safe(95/100)
Security Score95/100

About github-issue-workflow

This skill provides a structured, eight-phase workflow for resolving GitHub issues end to end inside Claude Code, from fetching the issue to opening a pull request. It solves the problem of ad-hoc issue handling by imposing a guided sequence: fetch issue details, analyze requirements, plan and implement, verify and test, perform code review, commit, and create the PR. It uses the gh CLI for GitHub API access and coordinates sub-agents for exploration and review, with mandatory user confirmation gates at the requirements and implementation-start phases.

A notable strength is its explicit security posture around untrusted content. The skill treats GitHub issue bodies and comments as untrusted, user-generated data that may contain indirect prompt-injection attempts. Its mandatory rules require treating issue text as data rather than instructions, ignoring embedded directives, never executing code copied from issues, gating implementation behind explicit user approval, and never propagating raw issue text to sub-agents. An isolation pipeline (fetch and display read-only, user restates requirements in their own words, then implement only from user-confirmed requirements) reinforces this. The verify phase auto-detects the project type and runs the full test suite, linters, static analysis, and formatting checks across many ecosystems (npm, Maven, Gradle, pytest, Go, Composer, Make).

It targets developers using Claude Code who want a repeatable, safety-conscious path from a GitHub issue to a reviewed pull request. It declares Read, Write, Edit, Bash, Grep, Glob, Task, AskUserQuestion, and TodoWrite tools; while it can modify code and run build/test commands, its design centers on confirmation gates and injection resistance rather than autonomous change.

FAQ

What are the prerequisites?

An authenticated GitHub CLI (gh auth status), configured git user name and email, and being inside a git repository. The skill verifies these before starting.

How does it protect against prompt injection from issues?

It treats issue bodies and comments as untrusted data, ignores any embedded instructions, never executes code from issues, and never passes raw issue text to sub-agents. Implementation proceeds only from requirements the user restates and confirms.

Does it make changes automatically?

No. There are mandatory user confirmation gates at the requirements phase and again before implementation begins; you approve the plan before code is written.

Which project types can it test?

The verify phase auto-detects and runs suites for npm/Node, Maven, Gradle, Python (pytest/ruff/mypy), Go, Composer, and Makefile-based projects, along with linters and formatting checks.

What does the full workflow produce?

It takes an issue from fetch through analysis, implementation, verification, code review, and commit, ending with a created pull request via the gh CLI.

All Files

10 files
references/phases-detailed.md10.6 KB
View
references/commit-examples.md12.9 KB
View
SKILL.md7.7 KB
View
references/examples.md9.6 KB
View
references/constraints-warnings.md12.1 KB
View
references/best-practices.md9.1 KB
View
references/test-commands.md7.5 KB
View
references/phase-workflows.md14.2 KB
View
references/security-protocol.md3.8 KB
View
references/prerequisites.md2.6 KB
View

Install github-issue-workflow

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill