fix-bug

Diagnose software bugs through structured reproduction and falsifiable assertions.

1|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/n0rvyn/indie-toolkit --skill fix-bug-n0rvyn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-bug
Source: https://github.com/n0rvyn/indie-toolkit/tree/main/dev-workflow/skills/fix-bug
Command: npx skills add https://github.com/n0rvyn/indie-toolkit --skill fix-bug-n0rvyn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides engineers and maintainers through a structured, evidence-driven bug investigation when users report errors, stack traces, screenshots, or build/test failures, ensuring the root cause is found before code changes are made.

Core Features & Use Cases

  • Structured Reproduction: Confirms whether an issue can be reproduced and records exact steps to trigger the bug.
  • Falsifiable Assertions & Verification: Generates 3-5 specific, testable hypotheses with file:line evidence and verifies them one at a time.
  • Value-Domain & Parallel-Path Analysis: Performs mandatory value-domain tracing for data-related bugs and inspects parallel processing paths to avoid partial fixes.
  • Planned, User-Approved Fixes: Produces consumer-impact lists and classifies fixes as simple or complex, gating implementation on user approval to avoid accidental regressions.

Quick Start

Use the fix-bug skill to investigate the provided error or stack trace, reproduce the issue, generate falsifiable hypotheses with evidence, and produce a user-approved fix plan.

Frequently Asked Questions about fix-bug

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

FAQPage Schema
How do I systematically diagnose a software bug from a stack trace?

To diagnose a software bug from a stack trace, perform structured reproduction to confirm the issue, generate falsifiable hypotheses with file:line evidence, and verify each assertion systematically before planning code changes.

What's the best way to reproduce a failing CI build locally?

The best way to reproduce a failing CI build locally is to record exact steps that trigger the bug, apply hypothesis-driven assertions, and perform value-domain tracing to pinpoint the root cause before attempting any fixes.

Why should I use hypothesis testing for bug fixing instead of patching the error directly?

Hypothesis testing for bug fixing prevents accidental regressions by generating 3-5 specific falsifiable assertions with file:line evidence, verifying issues systematically, and gating implementation on explicit approval rather than patching blindly.

How do I trace data-related bugs using value-domain analysis?

Tracing data-related bugs using value-domain analysis involves mapping how data flows through parallel processing paths, ensuring you inspect all related branches to avoid partial fixes and confirm the full scope of the issue.

Can I use this structured approach for GitHub-linked issues and incident reports?

Yes, you can use this approach for GitHub-linked issues and incident reports where reproduction, hypothesis-driven assertions, and value-domain tracing are required to generate consumer-impact aware repair plans for reliable fixes.

What are the limitations of hypothesis-driven bug diagnosis?

Hypothesis-driven bug diagnosis requires verifiable file:line evidence and structured reproduction, meaning it is limited when issues cannot be consistently reproduced or lack sufficient error context like stack traces and failing build logs.