issue-fixer

Guide teams through a repeatable process for identifying and fixing codebase bugs.

1|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/cyberelf/agent_skills --skill issue-fixer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-fixer
Source: https://github.com/cyberelf/agent_skills/tree/main/skills/issue-fixer
Command: npx skills add https://github.com/cyberelf/agent_skills --skill issue-fixer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides a repeatable, low-risk approach to diagnosing and fixing software issues. It helps teams register issues, perform root-cause analysis, assess impact, implement minimal changes, and validate fixes with unit and end-to-end tests.

Core Features & Use Cases

  • Issue registration and tracking in .issues/opening.md
  • Structured root-cause analysis and impact assessment
  • Minimal, surgical code changes with safeguards
  • Quality validation via unit tests and E2E tests
  • Documentation of decisions and traceability

Quick Start

Register a new issue in .issues/opening.md for the reported bug and start the Investigation phase.

Frequently Asked Questions about issue-fixer

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

FAQPage Schema
How do I fix bugs with minimal risk to the codebase?

Structured bug fixing minimizes risk by enforcing root-cause analysis, impact assessment, surgical code changes, and validation through unit and end-to-end tests before deployment. Register issues in .issues/opening.md, document decisions, and validate fixes systematically to ensure quality.

What's the best way to track and document bug fixes across a team?

Track issues in .issues/opening.md with decision records and traceability. This disciplined approach ensures all team members follow a repeatable process for registration, analysis, implementation, and validation, reducing duplicate efforts and maintaining a shared issue history.

How do I perform root-cause analysis on a reported issue?

Root-cause analysis follows a structured investigation phase where you register the issue, assess its impact on backend and frontend systems, identify the minimal changes needed, and validate with unit tests and end-to-end tests before implementation.

Can I use this approach for both backend and frontend bugs?

Yes. The skill covers end-to-end testing across both backend and frontend environments, providing a unified process for diagnosing and fixing issues regardless of where they occur in your stack.

When should I use unit tests versus end-to-end tests to validate a fix?

Use unit tests for isolated code changes and end-to-end tests for fixes affecting system workflows or user-facing behavior. The skill enforces validation with both, ensuring quality across different scopes of change and impact.

What happens if a code change has a wider impact than expected?

Impact assessment before implementation identifies dependencies and side effects. If impact is wider than anticipated, the structured process allows you to adjust scope, document decisions in .issues/opening.md, and extend validation across affected components before deployment.