- Capture the observed behavior, expected behavior, environment, impact, and available evidence. Reproduce the issue safely when possible; do not claim reproduction or root cause without evidence.
- Narrow the failure boundary by comparing working and failing paths, inputs, states, versions, and timing. Prefer observable facts over intuition.
- Form ranked, falsifiable hypotheses. Use targeted checks to eliminate them and trace causes back through the relevant data, control flow, and external boundaries.
- Select the smallest change that addresses the demonstrated cause, considering validation, error handling, and defense in depth. Avoid unrelated cleanup while diagnosis is incomplete.
- Verify the fix against the original failure and relevant regressions. Record the evidence, remaining uncertainty, and follow-up work if the root cause cannot yet be established.
Act Systematic Debugging
Investigates defects through reproducible observations, hypotheses, root-cause tracing, minimal changes, and regression-aware verification.
Act Systematic Debugging by fabioc-aloha · cf9b073
npx skillmds@latest add fabioc-aloha/act-systematic-debugging File contents
---name: act-systematic-debuggingdescription: Investigates defects through reproducible observations, hypotheses, root-cause tracing, minimal changes, and regression-aware verification.---1. Capture the observed behavior, expected behavior, environment, impact, and available evidence. Reproduce the issue safely when possible; do not claim reproduction or root cause without evidence.2. Narrow the failure boundary by comparing working and failing paths, inputs, states, versions, and timing. Prefer observable facts over intuition.3. Form ranked, falsifiable hypotheses. Use targeted checks to eliminate them and trace causes back through the relevant data, control flow, and external boundaries.4. Select the smallest change that addresses the demonstrated cause, considering validation, error handling, and defense in depth. Avoid unrelated cleanup while diagnosis is incomplete.5. Verify the fix against the original failure and relevant regressions. Record the evidence, remaining uncertainty, and follow-up work if the root cause cannot yet be established.
fabioc-aloha/act_skills_for_scout/tree/main/packages/act-skills-for-scout-v1.0.0/act-systematic-debugging commit cf9b073056
Frequently asked questions
Run npx skillmds@latest add fabioc-aloha/act-systematic-debugging in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Investigates defects through reproducible observations, hypotheses, root-cause tracing, minimal changes, and regression-aware verification. It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
fabioc-aloha (@fabioc-aloha) published this skill. Their other Agent Skills are listed on their SkillMD profile.