[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7BKJT33PTHP54ZPSQT4WT84":3,"skill-same:01M7BKJT33PTHP54ZPSQT4WT84":61},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":16,"sourceHtmlUrl":17,"categories":18,"keywords":19,"publishedAt":20,"linkOnly":21,"markdownContent":22,"markdownBody":23,"frontMatter":24,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":14,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M7BKJT33PTHP54ZPSQT4WT84","diagnosing-bugs",null,"Diagnose hard bugs and performance regressions. Use when debugging failures or slowness.","BetoFrega\u002Fskills","BetoFrega","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F637874?v=4","01M7BKHP444BSK41T281GQDPM7","Beto Frega","01M7BKHP5863T6EC03B63D0Q4T",0,"MIT","https:\u002F\u002Fgithub.com\u002FBetoFrega\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fdiagnosing-bugs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FBetoFrega\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fdiagnosing-bugs\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: diagnosing-bugs\ndescription: Diagnose hard bugs and performance regressions. Use when debugging failures or slowness.\n---\n\n# Diagnosing bugs\n\nRead relevant domain and ADR guidance. Justify skipped phases. Redact secrets as `\u003CREDACTED>`; use environment credentials and show only diagnostic evidence.\n\n1. **Build a tight, red-capable loop.** Run and show one command and redacted output proving the user's exact symptom. Require unattended execution, repeatability, and seconds-scale feedback; for intermittent bugs, establish a high reproduction rate. Prioritize this loop before hypotheses. If human interaction is unavoidable, use [the HITL template](scripts\u002Fhitl-loop.template.sh). Without a working loop, report attempts and request access or redacted evidence. Before requesting authorization for temporary production instrumentation, inspect existing provider telemetry as described in step 4. Ask when redaction removes the needed signal.\n2. **Reproduce and minimize.** Capture the exact failure and reproduce it repeatedly. Remove one element at a time, rerunning the loop. Proceed when every remaining element is load-bearing: removing any one makes the loop green.\n3. **Hypothesize.** Generate 3–5 ranked, falsifiable hypotheses with predicted observations. Show them before testing, incorporate user corrections, and continue without requiring a reply.\n4. **Instrument.** First inspect existing telemetry in the relevant providers. Record the time window, filters, sampling and correlation; check exact identifiers and individual spans when a root-only trace search is empty. An empty query does not establish absence of failure or instrumentation. Identify the missing diagnostic evidence before adding signals. Test predictions, changing one variable at a time. Prefer debugger\u002FREPL, then targeted logs with a unique debug prefix. For performance regressions, measure a baseline and bisect.\n5. **Fix and protect.** At a seam exercising the real bug pattern, write the regression test before fixing; watch it fail, apply the fix, and watch it pass. If no suitable seam exists, document the architectural limitation instead of claiming regression coverage. Then run variant analysis as [Fix Root Causes](..\u002Fbeto-mode\u002Fprinciples\u002Ffix-root-causes.md) describes.\n6. **Verify and clean up.** Rerun the original, unminimized scenario and verify green; require a passing regression test or document missing coverage. Remove temporary instrumentation and delete throwaway harnesses or retain them in a clearly marked debug location. Keep cleanup apart from recovery: restoring a prior version or getting green probes is a fix only with causal evidence and verification of the affected journey. Record the confirmed cause in the commit or PR; retain inconclusive results and remaining gaps in the diagnostic record.\n","# Diagnosing bugs\n\nRead relevant domain and ADR guidance. Justify skipped phases. Redact secrets as `\u003CREDACTED>`; use environment credentials and show only diagnostic evidence.\n\n1. **Build a tight, red-capable loop.** Run and show one command and redacted output proving the user's exact symptom. Require unattended execution, repeatability, and seconds-scale feedback; for intermittent bugs, establish a high reproduction rate. Prioritize this loop before hypotheses. If human interaction is unavoidable, use [the HITL template](scripts\u002Fhitl-loop.template.sh). Without a working loop, report attempts and request access or redacted evidence. Before requesting authorization for temporary production instrumentation, inspect existing provider telemetry as described in step 4. Ask when redaction removes the needed signal.\n2. **Reproduce and minimize.** Capture the exact failure and reproduce it repeatedly. Remove one element at a time, rerunning the loop. Proceed when every remaining element is load-bearing: removing any one makes the loop green.\n3. **Hypothesize.** Generate 3–5 ranked, falsifiable hypotheses with predicted observations. Show them before testing, incorporate user corrections, and continue without requiring a reply.\n4. **Instrument.** First inspect existing telemetry in the relevant providers. Record the time window, filters, sampling and correlation; check exact identifiers and individual spans when a root-only trace search is empty. An empty query does not establish absence of failure or instrumentation. Identify the missing diagnostic evidence before adding signals. Test predictions, changing one variable at a time. Prefer debugger\u002FREPL, then targeted logs with a unique debug prefix. For performance regressions, measure a baseline and bisect.\n5. **Fix and protect.** At a seam exercising the real bug pattern, write the regression test before fixing; watch it fail, apply the fix, and watch it pass. If no suitable seam exists, document the architectural limitation instead of claiming regression coverage. Then run variant analysis as [Fix Root Causes](..\u002Fbeto-mode\u002Fprinciples\u002Ffix-root-causes.md) describes.\n6. **Verify and clean up.** Rerun the original, unminimized scenario and verify green; require a passing regression test or document missing coverage. Remove temporary instrumentation and delete throwaway harnesses or retain them in a clearly marked debug location. Keep cleanup apart from recovery: restoring a prior version or getting green probes is a fix only with causal evidence and verification of the affected journey. Record the confirmed cause in the commit or PR; retain inconclusive results and remaining gaps in the diagnostic record.\n",{"name":5,"description":7},"main","b212a89a4ff3d13380a0ee75a91d99ee0aad2858","skills\u002Fdiagnosing-bugs","https:\u002F\u002Fgithub.com\u002FBetoFrega\u002Fskills","https:\u002F\u002Fgithub.com\u002FBetoFrega","2026-11-14 02:43:03",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add BetoFrega\u002Fskills --skill diagnosing-bugs",{"tool":37,"command":38},"bunx","bunx skills add BetoFrega\u002Fskills --skill diagnosing-bugs",{"tool":40,"command":41},"pnpm","pnpm dlx skills add BetoFrega\u002Fskills --skill diagnosing-bugs","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FBetoFrega\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fdiagnosing-bugs\u002FSKILL.md",true,[45,51,55],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"agents\u002Fopenai.yaml","REFERENCE","参考文档",103,"https:\u002F\u002Fgithub.com\u002FBetoFrega\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fdiagnosing-bugs\u002Fagents\u002Fopenai.yaml",{"path":52,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":54,"sourceHtmlUrl":16},"LICENSE","许可证",1068,{"path":56,"resourceType":57,"resourceTypeDesc":58,"sizeBytes":59,"sourceHtmlUrl":60},"scripts\u002Fhitl-loop.template.sh","SCRIPT","脚本",1316,"https:\u002F\u002Fgithub.com\u002FBetoFrega\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fdiagnosing-bugs\u002Fscripts\u002Fhitl-loop.template.sh",[62,69,77,84,92,99],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":20},"01M7BKPW918QFBHANWQRR8JXTA","writing-for-humans","Load before writing any reader-facing text, including messages, and follow its rules as you write. Also use to rewrite or audit existing prose for plain language, clarity, readability, or actionability.","https:\u002F\u002Fgithub.com\u002FBetoFrega\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-for-humans\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":73,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":20},"01M7BKPSYAK48C7RBZXKQN805M","writing-for-agents","Write agent-facing documents. Use when creating or editing skills, AGENTS.md, or CLAUDE.md.","https:\u002F\u002Fgithub.com\u002FBetoFrega\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-for-agents\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FBetoFrega\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":20},"01M7BKPQG1ZNVYYJVSGE69V5DZ","write-adr","Write, revise, or supersede architecture decision records (ADRs) documenting an architectural choice and its rationale.","https:\u002F\u002Fgithub.com\u002FBetoFrega\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwrite-adr\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":88,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":20},"01M7BKPMZC59QZ0G1746SCZ3S4","wizard","Wizard scripts for human-only provisioning, credential\u002FCI setup, unfamiliar dashboards, migrations, or cutovers; use only for steps the agent cannot perform.","https:\u002F\u002Fgithub.com\u002FBetoFrega\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwizard\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FBetoFrega\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwizard\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":20},"01M7BKPHD7Y6X4BM9SV06PNKAC","verify","Check whether the current task's claimed outcome is confirmed.","https:\u002F\u002Fgithub.com\u002FBetoFrega\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fverify\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":20},"01M7BKPESBZ2WZYN1EWK6SGB67","verb-tense","Choose verb tense and mood by when each event happens and how certain it is. Use when writing or reviewing any text, and when a reader asks for a tense review.","https:\u002F\u002Fgithub.com\u002FBetoFrega\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fverb-tense\u002FSKILL.md",[],[]]