Agent skill

Systematic Debugging

by 6BNBN in 6BNBN/FlowPilot

A skill your agent uses when diagnosing a bug, failing test, build issue, or unexpected behavior in Cursor before proposing a fix.

MITAuto-check passedDevelopment

Install Systematic Debugging

skills CLI
$ npx skills add 6BNBN/FlowPilot --skill systematic-debugging -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install 6BNBN/FlowPilot systematic-debugging --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/6BNBN/FlowPilot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/'兼容codex@cursor一键安装技能/cursor一键安装技能/skills/systematic-debugging' .claude/skills/systematic-debugging && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
systematic-debugging
GitHub stars
134
Token cost
~332 tokens
SKILL.md length
154 words
Files
10
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when diagnosing a bug, failing test, build issue, or unexpected behavior in Cursor before proposing a fix.

  • Works in 7 steps: Reproduce the issue reliably. → Read the exact error output and identify… → Check recent changes, configuration, and… → …
  • Diagnosing a bug
  • SKILL.md covers Goal, Workflow, Rules and Debugging Notes
  • Runs TypeScript and Shell scripts from its folder

What it does

Systematic Debugging is an agent skill from 6BNBN/FlowPilot. Use when diagnosing a bug, failing test, build issue, or unexpected behavior in Cursor before proposing a fix. Focus on reproducing the issue, tracing the cause, and validating the repair.

Its SKILL.md is about 330 tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files (for example `condition-based-waiting-example.ts`, `condition-based-waiting.md` and `defense-in-depth.md`).

It sits in Development, covering Debugging and Failing and flaky tests. The repository describes itself as: 一句需求,自动拆任务、并行多代理写码、断点恢复、验证收尾。FlowPilot 让 Claude Code / Codex / Cursor / snow-cli 进入真正的自动开发流程。 The licence is MIT.

When your agent uses it

  • Diagnosing a bug
  • Unexpected behavior in Cursor before proposing a fix

Example prompts

  • “/systematic-debugging”

Requirements

  • Node.js
  • A Bash shell

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Reproduce the issue reliably.
  2. Read the exact error output and identify where it surfaces.
  3. Check recent changes, configuration, and environmental differences.
  4. Compare the broken path to a working example when possible.
  5. Form one concrete hypothesis at a time.
  6. Make the smallest change needed to test that hypothesis.
  7. Verify the result before moving on.

What it can do on your machine

Read from SKILL.md and the folder at commit 57b1d49. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (TypeScript and Shell), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Systematic Debugging loads about 332 tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 154 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~332

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from 6BNBN/FlowPilot at commit 57b1d49, republished under its MIT licence (© 6BNBN). 154 words, ~332 tokens.

Download SKILL.mdSave it as .claude/skills/systematic-debugging/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
systematic-debugging
description
Use when diagnosing a bug, failing test, build issue, or unexpected behavior in Cursor before proposing a fix. Focus on reproducing the issue, tracing the cause, and validating the repair.

Systematic Debugging

Goal

Find the root cause before making changes.

Workflow

  1. Reproduce the issue reliably.
  2. Read the exact error output and identify where it surfaces.
  3. Check recent changes, configuration, and environmental differences.
  4. Compare the broken path to a working example when possible.
  5. Form one concrete hypothesis at a time.
  6. Make the smallest change needed to test that hypothesis.
  7. Verify the result before moving on.

Rules

  • Do not stack multiple speculative fixes together.
  • Do not call something fixed without reproducing the original path again.
  • If three attempted fixes fail, step back and question the design or architecture.
  • For behavior bugs, pair this with test-driven-development when possible.
  • Before declaring success, use verification-before-completion.

Debugging Notes

  • Log key boundaries in multi-step systems.
  • Trace bad values back to their origin rather than patching symptoms.
  • Prefer evidence and comparison over intuition.
  • Ask for clarification when the system behavior or expected outcome is unclear.

© 6BNBN, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 9 other files in 兼容codex@cursor一键安装技能/cursor一键安装技能/skills/systematic-debugging of 6BNBN/FlowPilot.

  • SKILL.md
  • condition-based-waiting-example.ts
  • condition-based-waiting.md
  • defense-in-depth.md
  • find-polluter.sh
  • root-cause-tracing.md
  • test-academic.md
  • test-pressure-1.md
  • test-pressure-2.md
  • test-pressure-3.md

Open the folder on GitHubat commit 57b1d49

Compare with similar skills

Systematic Debugging next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Systematic Debugging compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Systematic Debugging this skill6BNBN/FlowPilot134—~332Automated safety check: PassMIT
React Router Bug Fix Workflowremix-run/react-router57k—~1.3kAutomated safety check: PassMIT
Runtime DebugOpenHikmah/openhikmah-web181—~618Automated safety check: PassGPL-3.0
Root Cause Debuggingjsmastery-pro/skills1.4k—~1.8kAutomated safety check: NotesMIT
Superpowers Systematic Debuggingchristopherarter/superpowers-reasonix102—~2kAutomated safety check: PassMIT
Fix The Classjoetawil7/first-pass112—~1.5kAutomated safety check: PassMIT

Similar skills

  • React Router Bug Fix Workflow

    remix-run/react-router

    Fixes a React Router bug reported in a GitHub issue end to end: fetching the issue, validating the reproduction, writing a failing test and implementing the fix on a new branch.

    57k GitHub stars~1.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Runtime Debug

    OpenHikmah/openhikmah-web

    Debug and verification workflow for runtime-bundle and module-resolution regressions.

    181 GitHub stars~618 tokensUpdated today
    DevelopmentAuto-check passed
  • Root Cause Debugging

    jsmastery-pro/skills

    Runs a reproduce, localize, hypothesize, test, fix and verify loop to find a bug's root cause, applies the minimal fix and hands off a regression test.

    1.4k GitHub stars~1.8k tokensUpdated 1 mo ago
    DevelopmentAuto-check: notes
  • Superpowers Systematic Debugging

    christopherarter/superpowers-reasonix

    Any bug, failing or flaky test, or surprise behavior?. An agent skill from christopherarter/superpowers-reasonix.

    102 GitHub stars~2k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Fix The Class

    joetawil7/first-pass

    Bug-fix routine that fixes the whole class of bug, not just the reported instance.

    112 GitHub stars~1.5k tokensUpdated 6 days ago
    DevelopmentAuto-check passed
  • Minimal Code Fix

    cobusgreyling/loop-engineering

    Makes the smallest code change that fixes one well-scoped problem, such as a CI failure, review comment or typo, without refactoring anything unrelated.

    11k GitHub starsUsed in 1 repo~345 tokens
    DevelopmentAuto-check: notes

More from 6BNBN/FlowPilot

All 21 skills in this repo
  • Playwright

    6BNBN/FlowPilot

    A skill your agent uses when the task requires automating a real browser from the terminal in Cursor, including navigation, form filling, snapshots, screenshots, data extraction, and UI-flow…

    134 GitHub stars~1k tokensUpdated 6 mo ago
    Auto-check passed
  • Code Review

    6BNBN/FlowPilot

    A skill your agent uses when the user asks to review a pull request or diff with a structured Codex CLI workflow using parallel review passes and filtered actionable findings.

    134 GitHub stars~624 tokensUpdated 6 mo ago
    Auto-check passed
  • A skill your agent uses when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies.

    134 GitHub starsUsed in 1 repo~301 tokens
    Auto-check passed
  • Feature Dev

    6BNBN/FlowPilot

    A skill your agent uses when the user asks to build a new feature and wants a structured Codex CLI workflow with discovery, clarifying questions, architecture comparison, implementation, and review.

    134 GitHub stars~823 tokensUpdated 6 mo ago
    Auto-check passed
  • Writing Skills

    6BNBN/FlowPilot

    A skill your agent uses when creating, editing, or validating Cursor custom skills, especially when deciding where they should live, how they should be named, and how to describe when they apply.

    134 GitHub stars~322 tokensUpdated 6 mo ago
    Auto-check passed
  • Code Review

    6BNBN/FlowPilot

    A skill your agent uses when the user asks for a code review of local files, a workspace, a branch diff, or a pull request.

    134 GitHub stars~465 tokensUpdated 6 mo ago
    Auto-check passed

Questions about Systematic Debugging

What does Systematic Debugging do?

A skill your agent uses when diagnosing a bug, failing test, build issue, or unexpected behavior in Cursor before proposing a fix. Systematic Debugging is an agent skill from 6BNBN/FlowPilot. Use when diagnosing a bug, failing test, build issue, or unexpected behavior in Cursor before proposing a fix.

When should I use Systematic Debugging?

Systematic Debugging fits situations like: diagnosing a bug; unexpected behavior in Cursor before proposing a fix.

How do I install Systematic Debugging in Claude Code?

Run `npx skills add 6BNBN/FlowPilot --skill systematic-debugging -a claude-code`. Or copy the skill folder (兼容codex@cursor一键安装技能/cursor一键安装技能/skills/systematic-debugging in 6BNBN/FlowPilot) into .claude/skills/systematic-debugging in your project. Claude Code loads it when a task matches its description.

How do I install Systematic Debugging in Codex?

Run `npx skills add 6BNBN/FlowPilot --skill systematic-debugging -a codex`. Or copy the skill folder (兼容codex@cursor一键安装技能/cursor一键安装技能/skills/systematic-debugging in 6BNBN/FlowPilot) into .agents/skills/systematic-debugging in your project. Codex loads it when a task matches its description.

Can I use Systematic Debugging in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add 6BNBN/FlowPilot --skill systematic-debugging -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/systematic-debugging, .gemini/skills/systematic-debugging, .github/skills/systematic-debugging and .opencode/skills/systematic-debugging in your project.

What does Systematic Debugging need to run?

Going by SKILL.md and its folder, Systematic Debugging needs TypeScript and a shell for the scripts in its folder. Our summary lists: Node.js; A Bash shell.

Does Systematic Debugging access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Systematic Debugging safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Systematic Debugging use?

Systematic Debugging is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Systematic Debugging use?

About 332 tokens (SKILL.md is roughly 1.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Systematic Debugging?

Skills that share tags, products or a category with Systematic Debugging: React Router Bug Fix Workflow (remix-run/react-router, 57k stars), Runtime Debug (OpenHikmah/openhikmah-web, 181 stars), Root Cause Debugging (jsmastery-pro/skills, 1.4k stars) and Superpowers Systematic Debugging (christopherarter/superpowers-reasonix, 102 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Systematic Debugging?

6BNBN (a GitHub user) maintains it in 6BNBN/FlowPilot, which has 134 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on March 13, 2026.

Source: 6BNBN/FlowPilot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.