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.
Security Assessment
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 filesInstall github-issue-workflow
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
giuseppe-trisciuoglio/developer-kit