What happens if I don't have a GitHub issue yet?

The skill will pause the workflow and offer to create one for you by asking a series of questions regarding the title, description, and acceptance criteria.

Does this skill require external tools?

Yes, it requires the GitHub CLI (gh) to be installed and authenticated to interact with your repository and project boards.

Will it automatically add issues to my GitHub Project?

Yes, it includes commands to add the issue to a specified GitHub Project and set the initial status to 'Ready' or your preferred starting state.

Can I skip this gate for minor changes like typo fixes?

No, this skill follows an opinionated 'no exceptions' rule. Even small fixes require a recorded issue to ensure a complete audit trail of repository changes.

How does it verify the quality of an issue?

It checks for a clear title, a descriptive body, and at least one verifiable acceptance criterion. If these are missing, it will prompt you to update the issue.

GitHub Issue Prerequisite

Name: GitHub Issue Prerequisite
Author: troykelly

bytroykelly

0•

Productivity & Workflow

Enforces a strict documentation policy by requiring a verified GitHub issue before any development work can proceed.

The Issue Prerequisite skill serves as a mandatory validation gate for Claude Code, ensuring that every task is properly documented and tracked within GitHub's ecosystem. It implements an opinionated 'no work without an issue' workflow, preventing undocumented changes by either verifying an existing issue number or guiding the user through the creation of a new, high-quality issue. By integrating directly with the GitHub CLI, it automates the transition from a verbal request to a structured project item with clear acceptance criteria and project board placement.

Key Features

01Automated lookups using the GitHub CLI (gh)

02Direct integration with GitHub Projects and status fields

03Mandatory gate verification for all development requests

04Automated issue creation with standardized templates

050 GitHub stars

06Verification of acceptance criteria and technical context

Use Cases

01Enforcing project management standards in autonomous development

02Standardizing issue quality across a distributed development team

03Preventing 'shadow' work by requiring traceability for every code change

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add troykelly/claude-skills issue-prerequisite

For use in Claude.ai and ChatGPT

Download Skill