Agent skill

Debug

by SeifBenayed in SeifBenayed/cloclo

Troubleshoot and debug issues. An agent skill from SeifBenayed/cloclo.

MITAuto-check: notesDevelopment

Install Debug

skills CLI
$ npx skills add SeifBenayed/cloclo --skill debug -a claude-code

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

GitHub CLI
$ gh skill install SeifBenayed/cloclo 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/SeifBenayed/cloclo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/debug .claude/skills/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
debug
GitHub stars
114
Token cost
~419 tokens
SKILL.md length
216 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

Troubleshoot and debug issues. An agent skill from SeifBenayed/cloclo.

  • Works in 5 steps: Understand the problem → Reproduce → Investigate → …
  • The user reports an error
  • Calls git
  • Unexpected behavior

What it does

Debug is an agent skill from SeifBenayed/cloclo. Troubleshoot and debug issues. Use when the user reports an error, a test failure, unexpected behavior, or asks to investigate why something isn't working.

Its SKILL.md is about 420 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Failing and flaky tests and Debugging. The repository describes itself as: Open-source Claude Code SDK — single-file CLIs in Node.js, Python, Go, Rust that use directly. The licence is MIT.

When your agent uses it

  • The user reports an error
  • Unexpected behavior
  • Asks to investigate why something isnt working

Example prompts

  • “/debug”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Read, Grep, Glob

Workflow steps

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

  1. Understand the problem
  2. Reproduce
  3. Investigate
  4. Form a hypothesis and verify
  5. Report findings

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Grep
    • Glob

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Debug loads about 419 tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 216 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Grep, Glob

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 SeifBenayed/cloclo at commit 00f5195, republished under its MIT licence (© SeifBenayed). 216 words, ~419 tokens.

Download SKILL.mdSave it as .claude/skills/debug/SKILL.md (or your agent's skills folder).
name
debug
description
Troubleshoot and debug issues. Use when the user reports an error, a test failure, unexpected behavior, or asks to investigate why something isn't working.
allowed-tools
Bash, Read, Grep, Glob

Debug

Help diagnose and troubleshoot the described issue or the most recent error.

Steps

  1. Understand the problem

    • Read any error messages or stack traces mentioned
    • Ask clarifying questions if the problem description is vague
    • Check recent git changes that might have caused the issue: git diff HEAD~3
  2. Reproduce

    • If there's a failing test, run it to see the exact error
    • If it's a runtime issue, try to reproduce with minimal steps
  3. Investigate

    • Find the relevant source files using the stack trace or error message
    • Trace the code path that leads to the error
    • Check for common issues:
      • Typos in variable or function names
      • Wrong types or missing type conversions
      • Missing imports or dependencies
      • Race conditions or async issues
      • Environment differences (missing env vars, wrong paths)
      • Recent changes that broke assumptions
  4. Form a hypothesis and verify

    • State what you think the root cause is
    • Find evidence in the code that supports or refutes it
    • If needed, add targeted logging to narrow down the issue
  5. Report findings

    • Root cause explanation (why it broke, not just what broke)
    • Suggested fix with specific code changes
    • How to prevent similar issues in the future

Do NOT make changes unless explicitly asked — diagnose and explain first. The user should decide whether and how to fix it.

$ARGUMENTS

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

Files

Just SKILL.md in .claude/skills/debug of SeifBenayed/cloclo.

Open the folder on GitHubat commit 00f5195

Compare with similar skills

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.

Debug compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Debug this skillSeifBenayed/cloclo114—~419Automated safety check: NotesMIT
React Router Bug Fix Workflowremix-run/react-router57k—~1.3kAutomated safety check: PassMIT
Runtime Debugvercel/next.js143k1 repos~618Automated safety check: PassMIT
Root Cause Debuggingjsmastery-pro/skills1.4k—~1.8kAutomated safety check: NotesMIT
Superpowers Systematic Debuggingchristopherarter/superpowers-reasonix102—~2kAutomated safety check: PassMIT
Minimal Code Fixcobusgreyling/loop-engineering11k1 repos~345Automated safety check: NotesMIT

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

    vercel/next.js

    Official

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

    143k GitHub starsUsed in 1 repo~618 tokens
    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
  • 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
  • Fix The Class

    joetawil7/first-pass

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

    92 GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed

More from SeifBenayed/cloclo

  • Browse

    SeifBenayed/cloclo

    Visual feedback browser automation with multi-session, multi-tab, iframe support, and enterprise primitives.

    114 GitHub stars~2.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Chatgpt Search

    SeifBenayed/cloclo

    Search ChatGPT and extract the full response + hydration JSON that powers the UI.

    114 GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check: notes
  • Simplify

    SeifBenayed/cloclo

    Review code for unnecessary complexity and simplify it. An agent skill from SeifBenayed/cloclo.

    114 GitHub stars~430 tokensUpdated 6 mo ago
    Auto-check: notes
  • Commit

    SeifBenayed/cloclo

    Create a git commit with a good message. An agent skill from SeifBenayed/cloclo.

    114 GitHub stars~299 tokensUpdated 6 mo ago
    Auto-check: notes
  • Review PR

    SeifBenayed/cloclo

    Review a pull request for bugs, security issues, and improvements.

    114 GitHub stars~376 tokensUpdated 6 mo ago
    Auto-check: notes

Questions about Debug

What does Debug do?

Troubleshoot and debug issues. An agent skill from SeifBenayed/cloclo. Debug is an agent skill from SeifBenayed/cloclo. Troubleshoot and debug issues.

When should I use Debug?

Debug fits situations like: the user reports an error; unexpected behavior; asks to investigate why something isnt working.

How do I install Debug in Claude Code?

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

How do I install Debug in Codex?

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

Can I use 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 SeifBenayed/cloclo --skill 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/debug, .gemini/skills/debug, .github/skills/debug and .opencode/skills/debug in your project.

What does Debug need to run?

Going by SKILL.md and its folder, Debug needs the command-line tools its instructions call (git). Its frontmatter pre-approves these tools: Bash, Read, Grep, Glob.

Does Debug access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Debug safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Debug use?

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

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

Skills that share tags, products or a category with Debug: React Router Bug Fix Workflow (remix-run/react-router, 57k stars), Runtime Debug (vercel/next.js, 143k 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 Debug?

SeifBenayed (a GitHub user) maintains it in SeifBenayed/cloclo, which has 114 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on April 5, 2026.

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