{"id":"5bc9de3c-7606-4137-b95b-7700e4933443","shortId":"EhcfLq","kind":"skill","title":"debugging-toolkit-smart-debug","tagline":"Use when working with debugging toolkit smart debug","description":"## Use this skill when\n\n- Working on debugging toolkit smart debug tasks or workflows\n- Needing guidance, best practices, or checklists for debugging toolkit smart debug\n\n## Do not use this skill when\n\n- The task is unrelated to debugging toolkit smart debug\n- You need a different domain or tool outside this scope\n\n## Instructions\n\n- Clarify goals, constraints, and required inputs.\n- Apply relevant best practices and validate outcomes.\n- Provide actionable steps and verification.\n- If detailed examples are required, open `resources/implementation-playbook.md`.\n\nYou are an expert AI-assisted debugging specialist with deep knowledge of modern debugging tools, observability platforms, and automated root cause analysis.\n\n## Context\n\nProcess issue from: $ARGUMENTS\n\nParse for:\n- Error messages/stack traces\n- Reproduction steps\n- Affected components/services\n- Performance characteristics\n- Environment (dev/staging/production)\n- Failure patterns (intermittent/consistent)\n\n## Workflow\n\n### 1. Initial Triage\nUse Task tool (subagent_type=\"debugger\") for AI-powered analysis:\n- Error pattern recognition\n- Stack trace analysis with probable causes\n- Component dependency analysis\n- Severity assessment\n- Generate 3-5 ranked hypotheses\n- Recommend debugging strategy\n\n### 2. Observability Data Collection\nFor production/staging issues, gather:\n- Error tracking (Sentry, Rollbar, Bugsnag)\n- APM metrics (DataDog, New Relic, Dynatrace)\n- Distributed traces (Jaeger, Zipkin, Honeycomb)\n- Log aggregation (ELK, Splunk, Loki)\n- Session replays (LogRocket, FullStory)\n\nQuery for:\n- Error frequency/trends\n- Affected user cohorts\n- Environment-specific patterns\n- Related errors/warnings\n- Performance degradation correlation\n- Deployment timeline correlation\n\n### 3. Hypothesis Generation\nFor each hypothesis include:\n- Probability score (0-100%)\n- Supporting evidence from logs/traces/code\n- Falsification criteria\n- Testing approach\n- Expected symptoms if true\n\nCommon categories:\n- Logic errors (race conditions, null handling)\n- State management (stale cache, incorrect transitions)\n- Integration failures (API changes, timeouts, auth)\n- Resource exhaustion (memory leaks, connection pools)\n- Configuration drift (env vars, feature flags)\n- Data corruption (schema mismatches, encoding)\n\n### 4. Strategy Selection\nSelect based on issue characteristics:\n\n**Interactive Debugging**: Reproducible locally → VS Code/Chrome DevTools, step-through\n**Observability-Driven**: Production issues → Sentry/DataDog/Honeycomb, trace analysis\n**Time-Travel**: Complex state issues → rr/Redux DevTools, record & replay\n**Chaos Engineering**: Intermittent under load → Chaos Monkey/Gremlin, inject failures\n**Statistical**: Small % of cases → Delta debugging, compare success vs failure\n\n### 5. Intelligent Instrumentation\nAI suggests optimal breakpoint/logpoint locations:\n- Entry points to affected functionality\n- Decision nodes where behavior diverges\n- State mutation points\n- External integration boundaries\n- Error handling paths\n\nUse conditional breakpoints and logpoints for production-like environments.\n\n### 6. Production-Safe Techniques\n**Dynamic Instrumentation**: OpenTelemetry spans, non-invasive attributes\n**Feature-Flagged Debug Logging**: Conditional logging for specific users\n**Sampling-Based Profiling**: Continuous profiling with minimal overhead (Pyroscope)\n**Read-Only Debug Endpoints**: Protected by auth, rate-limited state inspection\n**Gradual Traffic Shifting**: Canary deploy debug version to 10% traffic\n\n### 7. Root Cause Analysis\nAI-powered code flow analysis:\n- Full execution path reconstruction\n- Variable state tracking at decision points\n- External dependency interaction analysis\n- Timing/sequence diagram generation\n- Code smell detection\n- Similar bug pattern identification\n- Fix complexity estimation\n\n### 8. Fix Implementation\nAI generates fix with:\n- Code changes required\n- Impact assessment\n- Risk level\n- Test coverage needs\n- Rollback strategy\n\n### 9. Validation\nPost-fix verification:\n- Run test suite\n- Performance comparison (baseline vs fix)\n- Canary deployment (monitor error rate)\n- AI code review of fix\n\nSuccess criteria:\n- Tests pass\n- No performance regression\n- Error rate unchanged or decreased\n- No new edge cases introduced\n\n### 10. Prevention\n- Generate regression tests using AI\n- Update knowledge base with root cause\n- Add monitoring/alerts for similar issues\n- Document troubleshooting steps in runbook\n\n## Example: Minimal Debug Session\n\n```typescript\n// Issue: \"Checkout timeout errors (intermittent)\"\n\n// 1. Initial analysis\nconst analysis = await aiAnalyze({\n  error: \"Payment processing timeout\",\n  frequency: \"5% of checkouts\",\n  environment: \"production\"\n});\n// AI suggests: \"Likely N+1 query or external API timeout\"\n\n// 2. Gather observability data\nconst sentryData = await getSentryIssue(\"CHECKOUT_TIMEOUT\");\nconst ddTraces = await getDataDogTraces({\n  service: \"checkout\",\n  operation: \"process_payment\",\n  duration: \">5000ms\"\n});\n\n// 3. Analyze traces\n// AI identifies: 15+ sequential DB queries per checkout\n// Hypothesis: N+1 query in payment method loading\n\n// 4. Add instrumentation\nspan.setAttribute('debug.queryCount', queryCount);\nspan.setAttribute('debug.paymentMethodId', methodId);\n\n// 5. Deploy to 10% traffic, monitor\n// Confirmed: N+1 pattern in payment verification\n\n// 6. AI generates fix\n// Replace sequential queries with batch query\n\n// 7. Validate\n// - Tests pass\n// - Latency reduced 70%\n// - Query count: 15 → 1\n```\n\n## Output Format\n\nProvide structured report:\n1. **Issue Summary**: Error, frequency, impact\n2. **Root Cause**: Detailed diagnosis with evidence\n3. **Fix Proposal**: Code changes, risk, impact\n4. **Validation Plan**: Steps to verify fix\n5. **Prevention**: Tests, monitoring, documentation\n\nFocus on actionable insights. Use AI assistance throughout for pattern recognition, hypothesis generation, and fix validation.\n\n---\n\nIssue to debug: $ARGUMENTS\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["debugging","toolkit","smart","debug","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents"],"capabilities":["skill","source-sickn33","skill-debugging-toolkit-smart-debug","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/debugging-toolkit-smart-debug","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34831 github stars · SKILL.md body (6,270 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-24T06:51:02.512Z","embedding":null,"createdAt":"2026-04-18T21:35:52.174Z","updatedAt":"2026-04-24T06:51:02.512Z","lastSeenAt":"2026-04-24T06:51:02.512Z","tsv":"'+1':581,621,644 '-100':232 '-5':164 '0':231 '1':134,560,669,675 '10':428,527,639 '15':613,668 '2':170,587,681 '3':163,222,608,688 '4':282,627,695 '5':337,572,636,702 '5000ms':607 '6':374,649 '7':430,659 '70':665 '8':467 '9':486 'action':78,709 'add':540,628 'affect':124,207,348 'aggreg':195 'ai':94,145,340,435,470,505,533,577,611,650,712 'ai-assist':93 'ai-pow':144,434 'aianalyz':566 'analysi':111,147,153,159,307,433,439,453,562,564 'analyz':609 'api':261,585 'apm':183 'appli':70 'approach':240 'argument':116,726 'ask':760 'assess':161,478 'assist':95,713 'attribut':386 'auth':264,414 'autom':108 'await':565,593,599 'base':286,399,536 'baselin':497 'batch':657 'behavior':353 'best':29,72 'boundari':360,768 'breakpoint':366 'breakpoint/logpoint':343 'bug':461 'bugsnag':182 'cach':256 'canari':423,500 'case':330,525 'categori':246 'caus':110,156,432,539,683 'chang':262,475,692 'chao':318,323 'characterist':127,289 'checklist':32 'checkout':556,574,595,602,618 'clarif':762 'clarifi':64 'clear':735 'code':437,457,474,506,691 'code/chrome':295 'cohort':209 'collect':173 'common':245 'compar':333 'comparison':496 'complex':311,465 'compon':157 'components/services':125 'condit':250,365,392 'configur':271 'confirm':642 'connect':269 'const':563,591,597 'constraint':66 'context':112 'continu':401 'correl':218,221 'corrupt':278 'count':667 'coverag':482 'criteria':238,511,771 'data':172,277,590 'datadog':185 'db':615 'ddtrace':598 'debug':2,5,10,13,20,23,34,37,49,52,96,103,168,291,332,390,410,425,552,725 'debug.paymentmethodid':634 'debug.querycount':631 'debugg':142 'debugging-toolkit-smart-debug':1 'decis':350,448 'decreas':521 'deep':99 'degrad':217 'delta':331 'depend':158,451 'deploy':219,424,501,637 'describ':739 'detail':83,684 'detect':459 'dev/staging/production':129 'devtool':296,315 'diagnosi':685 'diagram':455 'differ':56 'distribut':189 'diverg':354 'document':545,706 'domain':57 'drift':272 'driven':302 'durat':606 'dynam':379 'dynatrac':188 'edg':524 'elk':196 'encod':281 'endpoint':411 'engin':319 'entri':345 'env':273 'environ':128,211,373,575,751 'environment-specif':210,750 'error':119,148,178,205,248,361,503,517,558,567,678 'errors/warnings':215 'estim':466 'evid':234,687 'exampl':84,550 'execut':441 'exhaust':266 'expect':241 'expert':92,756 'extern':358,450,584 'failur':130,260,326,336 'falsif':237 'featur':275,388 'feature-flag':387 'fix':464,468,472,490,499,509,652,689,701,721 'flag':276,389 'flow':438 'focus':707 'format':671 'frequenc':571,679 'frequency/trends':206 'full':440 'fullstori':202 'function':349 'gather':177,588 'generat':162,224,456,471,529,651,719 'getdatadogtrac':600 'getsentryissu':594 'goal':65 'gradual':420 'guidanc':28 'handl':252,362 'honeycomb':193 'hypothes':166 'hypothesi':223,227,619,718 'identif':463 'identifi':612 'impact':477,680,694 'implement':469 'includ':228 'incorrect':257 'initi':135,561 'inject':325 'input':69,765 'insight':710 'inspect':419 'instruct':63 'instrument':339,380,629 'integr':259,359 'intellig':338 'interact':290,452 'intermitt':320,559 'intermittent/consistent':132 'introduc':526 'invas':385 'issu':114,176,288,304,313,544,555,676,723 'jaeger':191 'knowledg':100,535 'latenc':663 'leak':268 'level':480 'like':372,579 'limit':417,727 'load':322,626 'local':293 'locat':344 'log':194,391,393 'logic':247 'logpoint':368 'logrocket':201 'logs/traces/code':236 'loki':198 'manag':254 'match':736 'memori':267 'messages/stack':120 'method':625 'methodid':635 'metric':184 'minim':404,551 'mismatch':280 'miss':773 'modern':102 'monitor':502,641,705 'monitoring/alerts':541 'monkey/gremlin':324 'mutat':356 'n':580,620,643 'need':27,54,483 'new':186,523 'node':351 'non':384 'non-invas':383 'null':251 'observ':105,171,301,589 'observability-driven':300 'open':87 'opentelemetri':381 'oper':603 'optim':342 'outcom':76 'output':670,745 'outsid':60 'overhead':405 'pars':117 'pass':513,662 'path':363,442 'pattern':131,149,213,462,645,716 'payment':568,605,624,647 'per':617 'perform':126,216,495,515 'permiss':766 'plan':697 'platform':106 'point':346,357,449 'pool':270 'post':489 'post-fix':488 'power':146,436 'practic':30,73 'prevent':528,703 'probabl':155,229 'process':113,569,604 'product':303,371,376,576 'production-lik':370 'production-saf':375 'production/staging':175 'profil':400,402 'propos':690 'protect':412 'provid':77,672 'pyroscop':406 'queri':203,582,616,622,655,658,666 'querycount':632 'race':249 'rank':165 'rate':416,504,518 'rate-limit':415 'read':408 'read-on':407 'recognit':150,717 'recommend':167 'reconstruct':443 'record':316 'reduc':664 'regress':516,530 'relat':214 'relev':71 'relic':187 'replac':653 'replay':200,317 'report':674 'reproduc':292 'reproduct':122 'requir':68,86,476,764 'resourc':265 'resources/implementation-playbook.md':88 'review':507,757 'risk':479,693 'rollback':484 'rollbar':181 'root':109,431,538,682 'rr/redux':314 'run':492 'runbook':549 'safe':377 'safeti':767 'sampl':398 'sampling-bas':397 'schema':279 'scope':62,738 'score':230 'select':284,285 'sentri':180 'sentry/datadog/honeycomb':305 'sentrydata':592 'sequenti':614,654 'servic':601 'session':199,553 'sever':160 'shift':422 'similar':460,543 'skill':16,42,730 'skill-debugging-toolkit-smart-debug' 'small':328 'smart':4,12,22,36,51 'smell':458 'source-sickn33' 'span':382 'span.setattribute':630,633 'specialist':97 'specif':212,395,752 'splunk':197 'stack':151 'stale':255 'state':253,312,355,418,445 'statist':327 'step':79,123,298,547,698 'step-through':297 'stop':758 'strategi':169,283,485 'structur':673 'subag':140 'substitut':748 'success':334,510,770 'suggest':341,578 'suit':494 'summari':677 'support':233 'symptom':242 'task':24,45,138,734 'techniqu':378 'test':239,481,493,512,531,661,704,754 'throughout':714 'time':309 'time-travel':308 'timelin':220 'timeout':263,557,570,586,596 'timing/sequence':454 'tool':59,104,139 'toolkit':3,11,21,35,50 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'trace':121,152,190,306,610 'track':179,446 'traffic':421,429,640 'transit':258 'travel':310 'treat':743 'triag':136 'troubleshoot':546 'true':244 'type':141 'typescript':554 'unchang':519 'unrel':47 'updat':534 'use':6,14,40,137,364,532,711,728 'user':208,396 'valid':75,487,660,696,722,753 'var':274 'variabl':444 'verif':81,491,648 'verifi':700 'version':426 'vs':294,335,498 'work':8,18 'workflow':26,133 'zipkin':192","prices":[{"id":"5da42a80-a01a-41cf-8564-34d2041e1b3a","listingId":"5bc9de3c-7606-4137-b95b-7700e4933443","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:35:52.174Z"}],"sources":[{"listingId":"5bc9de3c-7606-4137-b95b-7700e4933443","source":"github","sourceId":"sickn33/antigravity-awesome-skills/debugging-toolkit-smart-debug","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/debugging-toolkit-smart-debug","isPrimary":false,"firstSeenAt":"2026-04-18T21:35:52.174Z","lastSeenAt":"2026-04-24T06:51:02.512Z"}],"details":{"listingId":"5bc9de3c-7606-4137-b95b-7700e4933443","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"debugging-toolkit-smart-debug","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34831,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-24T06:41:17Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"2d9a68d1c71e201318f27339d6ab1b3782eee61e","skill_md_path":"skills/debugging-toolkit-smart-debug/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/debugging-toolkit-smart-debug"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"debugging-toolkit-smart-debug","description":"Use when working with debugging toolkit smart debug"},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/debugging-toolkit-smart-debug"},"updatedAt":"2026-04-24T06:51:02.512Z"}}