fix-issue

Resolve GitHub issues end-to-end with TDD and Codex audit loop.

27|10|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/lllyys/vreader --skill fix-issue-lllyys
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-issue
Source: https://github.com/lllyys/vreader/tree/main/.claude/skills/fix-issue
Command: npx skills add https://github.com/lllyys/vreader --skill fix-issue-lllyys

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, xcodebuild, git, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides an end-to-end solution for resolving GitHub issues, including fetching, classifying, branching, fixing with Test-Driven Development (TDD), Codex audit loop, test gate, documentation synchronization, version bumping, PR creation, and post-merge finalization.

Core Features & Use Cases

  • End-to-End Issue Resolution: Handles all stages of issue resolution, from fetching the issue to closing the issue post-merge.
  • Test-Driven Development (TDD): Ensures that the fix is implemented with TDD practices.
  • Codex Audit Loop: Provides a Codex audit loop to ensure code quality and security.
  • Automated Testing: Performs automated testing to validate the fix.
  • Documentation Synchronization: Updates documentation as needed.
  • Version Bumping: Bumps the version number after successful resolution.
  • PR Creation: Creates a pull request for the fix.
  • Post-Merge Finalization: Closes the issue post-merge and performs final verification.
  • Use Case: A developer can use this Skill to quickly and efficiently resolve a GitHub issue, ensuring high code quality and proper documentation.

Quick Start

Use the fix-issue skill to resolve GitHub issue #123.

Frequently Asked Questions about fix-issue

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate GitHub issue resolution end-to-end from fetching to post-merge?

You can automate GitHub issue resolution by using a workflow that fetches issues, creates branches, applies TDD fixes, runs tests, bumps versions, and creates PRs. This handles the complete lifecycle from triage to post-merge closure.

Does TDD issue resolution integrate with GitHub CLI and git for branch and PR management?

Yes, TDD issue resolution integrates with gh and git to handle branch creation, PR submission, and post-merge finalization. These dependencies are required for repository access, issue management, and version control operations throughout the workflow.

What is a Codex audit loop and how does it ensure code quality during issue fixing?

A Codex audit loop validates code quality and security during issue resolution by iteratively reviewing fixes before test gates. It ensures TDD-implemented changes meet quality standards before proceeding to documentation sync and PR creation.

How do I resolve GitHub issues using Test-Driven Development and automated testing?

Resolve GitHub issues with TDD by fetching the issue, creating a branch, writing failing tests first, implementing the fix, running automated test gates, then bumping versions and creating a PR. This ensures fixes are test-validated before merge.

Can I automate version bumping and documentation sync when fixing GitHub issues?

Yes, automated issue resolution workflows can bump version numbers and synchronize documentation after successful test validation. These steps execute before PR creation to ensure the repository state reflects the completed fix.

What prerequisites do I need for automated GitHub issue resolution with TDD?

Automated GitHub issue resolution requires gh, xcodebuild, and git installed with appropriate GitHub permissions for issue and repository management. You need access to the target repository and valid authentication configured for all dependencies.