Skip to content

feat(skills): add systematic debugging skill - #3

Merged
pertrai1 merged 2 commits into
mainfrom
feat/add-systematic-debugging-skill
Apr 29, 2026
Merged

pertrai1 merged 2 commits into
mainfrom
feat/add-systematic-debugging-skill

Conversation

@pertrai1-bot

@pertrai1-bot pertrai1-bot commented Apr 29, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

  • Add skills/systematic-debugging/SKILL.md with a four-phase root-cause debugging workflow
  • Document the new skill in the README skills section
  • Add the new skill to AGENTS, CLAUDE, and Copilot instruction templates

Verification

  • Ran skill/frontmatter validation for all skills
  • Checked no disallowed {{PLACEHOLDER}} markers exist in directives/ or skills/
  • Ran git diff --check

Notes

  • Commit uses Commitizen-compatible Conventional Commits format: feat(skills): add systematic debugging skill

Summary by CodeRabbit

  • Documentation
    • Added comprehensive "Systematic Debugging" guidance: a four-phase, evidence-focused process (reproduce/observe, localize, form/test a single hypothesis, implement/verify fix) plus output-handling and quick-reference aids.
    • Updated README and instruction templates to require and reference the new systematic debugging guidance for handling bugs, failing tests, CI issues, and regressions.

@coderabbitai

coderabbitai Bot commented Apr 29, 2026 •

Copy link
Copy Markdown

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: f7a18707-d6f4-423a-a94f-da08d9485205

📥 Commits

Reviewing files that changed from the base of the PR and between 2a18252 and 9947d0a.

📒 Files selected for processing (1)
  • skills/systematic-debugging/SKILL.md

📝 Walkthrough

Walkthrough

A new "Systematic Debugging" skill is introduced to enforce root-cause-driven debugging workflows. The skill is documented in a dedicated SKILL.md file, added to the README's skills table, and integrated into agent/template configurations (templates/AGENTS.md, templates/CLAUDE.md, templates/copilot-instructions.md).

Changes

Cohort / File(s) Summary
Documentation & README
README.md
Updated "What's Included" table to add "systematic debugging" and added a new section describing the four-phase debugging process (reproduce, localize, hypothesize, fix).
New Systematic Debugging Skill
skills/systematic-debugging/SKILL.md
Added comprehensive skill doc defining scope/when-to-use, a four-phase root-cause workflow, output-handling lifecycle, "Rule of Three", forbidden-patterns, handoff/PR summary template, and a phase→output quick-reference.
Agent & Template Configuration
templates/AGENTS.md, templates/CLAUDE.md, templates/copilot-instructions.md
Inserted Systematic Debugging into the mandatory Skills lists of agent/template docs, pointing to the new SKILL.md; no runtime or API changes.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Poem

🐰 I sniff the stack where the bug likes to hide,

I trace each hop with a twitch and a stride,
Reproduce, localize, test one bright thought,
Fix the root, not a patch that was bought,
Hop off satisfied — the rabbit debugged right! 🥕

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The PR title clearly and accurately summarizes the main change: adding a new systematic debugging skill to the repository.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/add-systematic-debugging-skill

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
Review rate limit: 0/1 reviews remaining, refill in 60 minutes.

Comment @coderabbitai help to get the list of available commands and usage tips.

@pertrai1
pertrai1 merged commit cbfba5e into main Apr 29, 2026
1 check passed
@pertrai1
pertrai1 deleted the feat/add-systematic-debugging-skill branch April 29, 2026 23:49
@coderabbitai coderabbitai Bot mentioned this pull request May 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants