{"enrichment":{"faq":[{"a":"root-cause-tracing teaches you to work systematically upward from where an error appears, examining each function that called the one before it. Start by capturing the full stack trace, then follow the chain backward to identify what values were passed at each level and which function introduced the bad data. This backward tracing reveals the original trigger rather than just the symptom location.","q":"How do I trace bugs backward through the call stack?"},{"a":"root-cause-tracing emphasizes identifying the original source of a bug rather than patching where it manifests. A symptom is where an error appears\u2014often far down the call chain. The root cause is where invalid data originated or logic first went wrong. By tracing backward through the execution chain, you fix the actual problem once, preventing it everywhere, instead of applying band-aids at symptom sites.","q":"What's the difference between finding root cause vs. fixing symptoms?"},{"a":"root-cause-tracing provides instrumentation and stack trace analysis techniques for errors buried in complex execution chains. Add logging at key points to capture function arguments and return values, then analyze the full trace to see where data became corrupted or logic failed. This systematic approach to analyzing the execution chain makes it possible to locate bug sources even in deeply nested or asynchronous code.","q":"How can root-cause-tracing help debug deep errors in code?"},{"a":"root-cause-tracing includes methods for tracing test pollution by instrumenting your test suite to track state changes and side effects. Capture stack traces when unexpected state modifications occur, then trace backward through the test execution chain to identify which test introduced the pollution. This reveals whether a test is leaking state, modifying shared resources, or leaving behind artifacts that affect other tests.","q":"How do I find which test is causing pollution or side effects?"},{"a":"root-cause-tracing teaches you to add strategic logging and stack trace capture points throughout your code. Record function entry/exit, argument values, and return values at critical junctures. Use this instrumentation to build a complete picture of the execution chain, making it easier to spot where data went wrong or where control flow deviated from expectations.","q":"What instrumentation techniques does root-cause-tracing cover?"}],"shadow_tags":["call-stack-analysis","bug-investigation","error-source-finding","test-pollution-detection","instrumentation-logging","execution-tracing","symptom-vs-cause","stack-trace-analysis","debugging-methodology","defensive-programming"],"summary_rewrite":"This skill teaches you to trace bugs backward through the call chain rather than fixing where errors appear. By working systematically up the stack\u2014identifying what called each function and what values were passed\u2014you locate the original trigger and fix the root cause. Includes instrumentation techniques, stack trace analysis, and real examples of finding pollution across test suites."},"files":[{"bytes":4108,"path":"plugins/root-cause-tracing/skills/root-cause-tracing/SKILL.md","sha256":"4518351dc5a548a125cf2f0c215756c0fc43588d86f0090fe19ea55050d5788a","url":"https://skillfed.io/files/secondsky/claude-skills/root-cause-tracing/377bbc1f/SKILL.md"}],"id":"secondsky/claude-skills/root-cause-tracing","links":{"html":"https://skillfed.io/secondsky/claude-skills/root-cause-tracing","md":"https://skillfed.io/secondsky/claude-skills/root-cause-tracing.md","repo":"https://github.com/secondsky/claude-skills"},"meta":{"agents_supported":[],"first_seen":"2026-07-28","forks":29,"language":"TypeScript","last_updated":"2026-07-25","license":"MIT","name":"root-cause-tracing","publisher":"secondsky","stars":196},"relations":{"categories":["debugging","software-engineering","testing"],"similar":[{"id":"NickCrew/Claude-Cortex/root-cause-tracing"},{"id":"NeoLabHQ/context-engineering-kit/root-cause-tracing"},{"id":"PracticalSwan/agent-skills/root-cause-tracing"},{"id":"obra/superpowers-skills/root-cause-tracing"},{"id":"mrgoonie/claudekit-skills/root-cause-tracing"},{"id":"bobmatnyc/claude-mpm-skills/root-cause-tracing"},{"id":"obra/superpowers-skills/defense-in-depth"},{"id":"NickCrew/Claude-Cortex/defense-in-depth"},{"id":"mrgoonie/claudekit-skills/defense-in-depth"},{"id":"secondsky/claude-skills/defense-in-depth-validation"}]},"slug":{"owner":"secondsky","repo":"claude-skills","skill":"root-cause-tracing"},"version":"377bbc1f"}