← All skills

debug-mantra

100 / 100 · Low risk

Fine to try.

By danchamorro/pi-agent-toolkit (GitHub) · coding · 17 stars · scanned at commit b762a11

Four-mantra debugging discipline — reproduce, trace the fail path, falsify the hypothesis, cross-reference every breadcrumb. Recite the mantra block verbatim at the start of any debugging session, then apply the four steps in order before proposing any fix. Trigger on /debug-mantra and proactively whenever debugging starts — user reports a bug, says something is broken/throwing/failing, asks to debug/diagnose/investigate an issue, or pastes a stack trace or error log.

Works with any agent that supports SKILL.md skills.

What this skill can do

We found nothing in the files we read that matches our rules. That does not prove the skill is safe: see the limits of static scanning.

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'debug-mantra' ] || [ -L ~/.agents/skills/'debug-mantra' ]; then echo 'A skill folder named debug-mantra already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/danchamorro/pi-agent-toolkit' "$d" && git -C "$d" checkout --quiet 'b762a116c343f012c9b23009a7f2d9af217b8b00' -- 'dotfiles/personal-skills/engineering/debug-mantra' && mkdir -p ~/.agents/skills && cp -R "$d"/'dotfiles/personal-skills/engineering/debug-mantra' ~/.agents/skills/'debug-mantra' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'debug-mantra' ~/.claude/skills/'debug-mantra' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for danchamorro/pi-agent-toolkit shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/danchamorro/pi-agent-toolkit.svg)](https://zalavijaysinh.github.io/skilltrust/repos/danchamorro/pi-agent-toolkit/)

Score history