observer-effect-debugging

Diagnose bugs and performance anomalies altered by observation or instrumentation.

2|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/NlightNFotis/skills --skill observer-effect-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: observer-effect-debugging
Source: https://github.com/NlightNFotis/skills/tree/main/observer-effect-debugging
Command: npx skills add https://github.com/NlightNFotis/skills --skill observer-effect-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you investigate bugs and performance issues that appear, disappear, or change when you observe them. It is designed for Heisenbugs, race conditions, instrumentation-sensitive failures, and misleading measurements caused by logging, debugging, profiling, or tracing.

Core Features & Use Cases

  • Probe-aware debugging: Distinguishes between bugs caused by observation and bugs hidden by observation, so you do not mistake instrumentation side effects for real system behavior.
  • Low-disturbance measurement strategy: Guides you to compare continuous, sampled, out-of-band, and post-hoc observation modes to find evidence you can trust.
  • Practical diagnosis workflow: Helps classify timing, scheduling, cache, GC, JIT, and sampling effects, then reduce probe size and capture failure evidence with minimal steady-state impact.
  • Use cases: Ideal when a bug only fails in production, disappears under a debugger, changes with log level, or produces unreliable performance numbers under profiling.

Quick Start

Ask the observer-effect-debugging skill to analyze a bug that disappears when logging or a debugger is enabled and propose a lower-disturbance instrumentation plan.

Frequently Asked Questions about observer-effect-debugging

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

FAQPage Schema
Why does my bug disappear when I enable logging or attach a debugger?

Race conditions and flaky tests often change behavior when observation alters execution timing. This Skill helps diagnose these probe-sensitive failures by classifying perturbation sources and distinguishing real system bugs from instrumentation side effects.

How do I debug race conditions that only fail in production?

Debugging production-only race conditions requires comparing continuous, sampled, out-of-band, and post-hoc observation modes. This Skill guides you to capture failure evidence with minimal steady-state impact by reducing probe size and validating evidence.

What is the best way to profile performance without affecting latency?

To profile performance without affecting latency, you must reduce probe size and validate evidence with out-of-band corroboration. This Skill helps classify timing, cache, GC, and JIT effects to find trustworthy measurements during probe-sensitive latency investigations.

How do I fix flaky tests that change behavior under continuous monitoring?

Fixing flaky tests that change under continuous monitoring involves comparing sampled versus continuous observation modes. This Skill helps classify timing and scheduling effects, enabling you to reduce probe impact and validate evidence through post-hoc corroboration.

When should I use sampled monitoring instead of continuous profiling?

Sampled monitoring is preferable over continuous profiling when continuous instrumentation alters system behavior. This Skill helps evaluate sampled-versus-continuous monitoring decisions by comparing observation modes to ensure you collect trustworthy evidence without inducing Heisenbugs.