Agent skill

Systematic Debug

by modimihir07 in modimihir07/agentic-os

4-phase root cause analysis and debugging. An agent skill from modimihir07/agentic-os.

MITAuto-check passedDevelopment

Install Systematic Debug

skills CLI
$ npx skills add modimihir07/agentic-os --skill systematic-debug -a claude-code

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

GitHub CLI
$ gh skill install modimihir07/agentic-os systematic-debug --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/modimihir07/agentic-os.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/systematic-debug .claude/skills/systematic-debug && 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-debug
GitHub stars
192
Token cost
~269 tokens
SKILL.md length
118 words
Files
4
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

4-phase root cause analysis and debugging. An agent skill from modimihir07/agentic-os.

  • Works in 5 steps: Reproduce: Capture exact steps,… → Investigate: Trace root cause through… → Fix: Apply minimal fix addressing root… → …
  • Tasks that involve Debugging
  • SKILL.md covers Description, When to Use, Process and Safety, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Systematic Debug is an agent skill from modimihir07/agentic-os. 4-phase root cause analysis and debugging

Its SKILL.md is about 270 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `eval.json`, `learnings.md` and `score-history.json`).

It sits in Development, covering Debugging and Root cause analysis. The repository describes itself as: Agentic OS: Multi-agent orchestration platform for opencode, Hermes & Gemini CLI. Skills hub, scheduler, cost analytics, memory & backup. The licence is MIT.

When your agent uses it

  • Tasks that involve Debugging
  • Tasks that involve Root cause analysis

Example prompts

  • “/systematic-debug”

Workflow steps

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

  1. Reproduce: Capture exact steps, environment, and error output
  2. Investigate: Trace root cause through logs, stack traces, and code analysis
  3. Fix: Apply minimal fix addressing root cause (not symptoms)
  4. Verify: Confirm fix resolves the issue and doesn't introduce regressions
  5. Update learnings.md with debugging insights

What it can do on your machine

Read from SKILL.md and the folder at commit c7ebbb4. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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 Debug loads about 269 tokens when it runs. Until then it costs about 15 tokens; SKILL.md has 118 words of instructions outside code blocks.

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

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 modimihir07/agentic-os at commit c7ebbb4, republished under its MIT licence (© modimihir07). 118 words, ~269 tokens.

Download SKILL.mdSave it as .claude/skills/systematic-debug/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
systematic-debug
description
4-phase root cause analysis and debugging
version
1.0.0
author
Agentic OS
tags
debugging, bug, fix, root-cause

Systematic Debugging

Description

Four-phase debugging methodology: reproduce, investigate, fix, verify. Prevents guesswork and ensures root cause is found before any fix is applied.

When to Use

  • Encountering a bug or error
  • System failure or crash
  • Unexplained behavior
  • Performance regression

Process

  1. Reproduce: Capture exact steps, environment, and error output
  2. Investigate: Trace root cause through logs, stack traces, and code analysis
  3. Fix: Apply minimal fix addressing root cause (not symptoms)
  4. Verify: Confirm fix resolves the issue and doesn't introduce regressions
  5. Update learnings.md with debugging insights

Safety

  • If 3 fix attempts fail, trigger architectural review
  • Never apply workaround without understanding root cause

Output

Debug report: symptoms, root cause, fix applied, verification results

Agent Assignment

  • Primary: opencode

© modimihir07, 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 3 other files in skills/systematic-debug of modimihir07/agentic-os.

  • SKILL.md
  • eval.json
  • learnings.md
  • score-history.json

Open the folder on GitHubat commit c7ebbb4

Compare with similar skills

Systematic Debug 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 Debug compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Systematic Debug this skillmodimihir07/agentic-os192—~269Automated safety check: PassMIT
OpenLogi macOS Permissions TriageAprilNEA/OpenLogi23k—~2.5kAutomated safety check: NotesApache-2.0
Bug Finder for daisyUIsaadeghi/daisyui43k—~2.3kAutomated safety check: PassMIT
Root Cause Debugginggarrytan/gstack136k—~1.4kAutomated safety check: PassMIT
Graph-Based Bug Tracingtirth8205/code-review-graph32k1 repos~287Automated safety check: PassMIT
Systematic DebuggingChrisWiles/claude-code-showcase6.1k3 repos~1.2kAutomated safety check: PassNone

Similar skills

  • Decides whether an OpenLogi device problem on macOS is a privacy-permission (TCC) problem, using agent log lines, and says which identity needs which grant.

    23k GitHub stars~2.5k tokensUpdated 4 days ago
    DevelopmentAuto-check: notes
  • Bug Finder for daisyUI

    saadeghi/daisyui

    Investigates suspected bugs in the daisyUI monorepo through read-only analysis, then writes a decision-ready fix plan in tmp/bugs without changing any product code.

    43k GitHub stars~2.3k tokensUpdated 8 days ago
    DevelopmentAuto-check passed
  • Root Cause Debugging

    garrytan/gstack

    Investigates bugs, errors and stack traces in phases and requires a root-cause hypothesis to be confirmed before any fix is written.

    136k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Graph-Based Bug Tracing

    tirth8205/code-review-graph

    Traces a bug through a code knowledge graph, following callers, callees and execution flow before opening source files, within a small token budget.

    32k GitHub starsUsed in 1 repo~287 tokens
    DevelopmentAuto-check passed
  • Systematic Debugging

    ChrisWiles/claude-code-showcase

    Applies a four-phase debugging routine that finds the root cause of a bug or failing test before any fix is written.

    6.1k GitHub starsUsed in 3 repos~1.2k tokens
    DevelopmentAuto-check passed
  • Debugging and Error Recovery

    addyosmani/agent-skills

    Applies a stop-the-line rule and a step-by-step triage when tests fail, builds break or something stops working, aiming at the root cause instead of guesses.

    103k GitHub starsUsed in 1 repo~2.6k tokens
    DevelopmentAuto-check passed

More from modimihir07/agentic-os

All 12 skills in this repo
  • Code Review

    modimihir07/agentic-os

    Automated code review with checklist and quality gates. An agent skill from modimihir07/agentic-os.

    192 GitHub stars~222 tokensUpdated 1 mo ago
    Auto-check passed
  • Cost Analytics

    modimihir07/agentic-os

    Tracks token usage and API costs across all providers. An agent skill from modimihir07/agentic-os.

    192 GitHub stars~225 tokensUpdated 1 mo ago
    Auto-check passed
  • Daily Standup

    modimihir07/agentic-os

    Morning briefing with project status overview. An agent skill from modimihir07/agentic-os.

    192 GitHub stars~203 tokensUpdated 1 mo ago
    Auto-check passed
  • Devops Audit

    modimihir07/agentic-os

    GCP/K8s infrastructure audit and health check. An agent skill from modimihir07/agentic-os.

    192 GitHub stars~214 tokensUpdated 1 mo ago
    Auto-check passed
  • Goal Planner

    modimihir07/agentic-os

    Refines user inputs into executable step-by-step plans. An agent skill from modimihir07/agentic-os.

    192 GitHub stars~216 tokensUpdated 1 mo ago
    Auto-check passed
  • Heartbeat

    modimihir07/agentic-os

    Lightweight system health monitoring skill. An agent skill from modimihir07/agentic-os.

    192 GitHub stars~217 tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Systematic Debug

What does Systematic Debug do?

4-phase root cause analysis and debugging. An agent skill from modimihir07/agentic-os. Systematic Debug is an agent skill from modimihir07/agentic-os.

When should I use Systematic Debug?

Systematic Debug fits situations like: tasks that involve Debugging; tasks that involve Root cause analysis.

How do I install Systematic Debug in Claude Code?

Run `npx skills add modimihir07/agentic-os --skill systematic-debug -a claude-code`. Or copy the skill folder (skills/systematic-debug in modimihir07/agentic-os) into .claude/skills/systematic-debug in your project. Claude Code loads it when a task matches its description.

How do I install Systematic Debug in Codex?

Run `npx skills add modimihir07/agentic-os --skill systematic-debug -a codex`. Or copy the skill folder (skills/systematic-debug in modimihir07/agentic-os) into .agents/skills/systematic-debug in your project. Codex loads it when a task matches its description.

Can I use Systematic Debug 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 modimihir07/agentic-os --skill systematic-debug -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-debug, .gemini/skills/systematic-debug, .github/skills/systematic-debug and .opencode/skills/systematic-debug in your project.

What does Systematic Debug need to run?

SKILL.md names no scripts, command-line tools or credentials: Systematic Debug is instructions for the agent only.

Does Systematic Debug 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 Debug 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 Debug use?

Systematic Debug 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 Debug use?

About 269 tokens (SKILL.md is roughly 1.1k 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 Debug?

Skills that share tags, products or a category with Systematic Debug: OpenLogi macOS Permissions Triage (AprilNEA/OpenLogi, 23k stars), Bug Finder for daisyUI (saadeghi/daisyui, 43k stars), Root Cause Debugging (garrytan/gstack, 136k stars) and Graph-Based Bug Tracing (tirth8205/code-review-graph, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Systematic Debug?

modimihir07 (a GitHub user) maintains it in modimihir07/agentic-os, which has 192 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on August 11, 2026.

Source: modimihir07/agentic-os on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.