fix-bug

Diagnose silent integration failures with missing side effects across hooks, callbacks, and webhooks.

22|3|Updated Jul 28, 2024
One-click install
npx skills add https://github.com/webdevcody/go-mailing-list --skill fix-bug-webdevcody
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-bug
Source: https://github.com/webdevcody/go-mailing-list/tree/main/.claude/skills/fix-bug
Command: npx skills add https://github.com/webdevcody/go-mailing-list --skill fix-bug-webdevcody

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It diagnoses “it ran but nothing happened” integration failures, where the expected side effect (hook, status update, callback, job, webhook, or outward call) is missing and there’s little or no error evidence.

Core Features & Use Cases

  • Runtime-contract first tracing: Maps the concrete trigger → dispatch → receiver → observed outcome using file-and-line references so you can verify the seams are actually connected.
  • Silent-failure pattern detection: Greps for swallowed errors and fail-soft constructs (like || true, empty catches, and output redirection) to surface the most likely “ran but got dropped” locations.
  • Single fastest diagnostic request: Asks for one decisive piece of runtime evidence (or, if needed, the exact dashboard/log field) to disambiguate quickly, then ranks hypotheses with honest confidence.

Quick Start

Run fix-bug with mode=balanced and describe what action you took (and what side effect you expected but didn’t see), then paste the single most relevant runtime evidence you can provide (like the receiver log output while you reproduce).

Frequently Asked Questions about fix-bug

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

FAQPage Schema
Why does my webhook execute successfully but the expected side effect never occurs?

Silent integration failures occur when systems execute without errors but expected side effects drop due to swallowed exceptions or fail-soft constructs. This Skill extracts endpoints, auth, and payload shape to map the runtime contract and identify where the event gets lost.

How do I debug a missing callback or job trigger with no stack trace?

Debug a missing callback by mapping the concrete trigger, dispatch, and receiver sequence using file-and-line references. This verifies the runtime contract seams are connected and surfaces swallowed errors or empty catches that silently drop the expected trigger.

What is the fastest way to diagnose silent error handling in an integration?

The fastest way to diagnose silent error handling is requesting one decisive piece of runtime evidence, such as receiver log output during reproduction. This disambiguates hypotheses quickly and ranks likely swallow-sites with honest confidence levels.

Can I trace a webhook integration failure if I only have the expected payload shape?

Yes, you can trace a webhook integration failure using the expected payload shape. The workflow extracts endpoints, auth, required env vars, and log locations to satisfy contract-first requirements, then identifies swallow-sites even without a failing test.

What are common patterns that cause a system to run but drop the expected side effect?

Common patterns that cause a system to run but drop the expected side effect include swallowed errors, empty catches, fail-soft constructs like OR-true operators, and output redirection. These patterns mask integration failures by preventing error propagation.

How do I fix a config write or env injection that ran but didn't change state?

To fix a config write or env injection that didn't change state, grep for swallowed errors and fail-soft constructs to surface likely drop locations. Then verify the runtime contract by checking on-disk artifacts and requesting one disambiguating diagnostic log.