How does it prevent coding errors in complex issues?

It mandates a 'Verification Plan' before any code is written, ensuring that success criteria are defined and testable before implementation begins.

Does this skill require the GitHub CLI?

While it can work with pasted content, it is optimized to use the GitHub CLI (gh) to automatically fetch issue details and context.

Where does it store implementation plans?

Plans are typically saved to the docs/plans/ directory, providing a persistent record of the technical approach for team review.

Does this skill support Test-Driven Development?

Yes, if a TDD.rules.md file is found in the repository, the skill will prioritize TDD practices during the implementation phase.

What happens if the requirements are unclear?

The skill follows an 'Absolute Rule' of making no assumptions. If a requirement is ambiguous, it will stop and ask the developer for clarification.

GitHub Issue Workflow

Name: GitHub Issue Workflow
Author: britt

bybritt

•

Collaboration Tools

Standardizes the end-to-end process of implementing GitHub issues through structured planning and verification.

The Working on an Issue skill provides a rigorous framework for Claude to handle software tasks from inception to completion. It moves beyond simple coding by enforcing a structured lifecycle: reading issue data via the GitHub CLI, drafting formal implementation and verification plans, and executing changes with a focus on Test-Driven Development (TDD). By requiring explicit developer approval on plans and forbidding assumptions, this skill minimizes scope creep and ensures that every change is verified against the original acceptance criteria.

Key Features

01Automated issue retrieval using GitHub CLI or MCP tools

02Structured 'Understand-Plan-Verify-Implement' workflow

03Mandatory implementation planning with file-based documentation

041 GitHub stars

05Integrated verification logging for final task validation

06Strict anti-scope-creep logic to maintain project focus

Use Cases

01Implementing new features directly from a GitHub issue URL

02Resolving bug reports with a mandatory verification and testing phase

03Standardizing team workflows for issue-based development

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add britt/claude-code-skills working-on-an-issue

For use in Claude.ai and ChatGPT

Download Skill