New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Debug Agent

by millionco in millionco/expect

Systematic evidence-based debugging using runtime logs. An agent skill from millionco/expect.

Custom licenceAuto-check passedDevelopment

Install Debug Agent

skills CLI
$ npx skills add millionco/expect --skill debug-agent -a claude-code

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

GitHub CLI
$ gh skill install millionco/expect debug-agent --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/millionco/expect.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/debug-agent .claude/skills/debug-agent && 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-agent
GitHub stars
3.6k
Token cost
~2.6k tokens
SKILL.md length
1,387 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
Custom licence

At a glance

Systematic evidence-based debugging using runtime logs. An agent skill from millionco/expect.

  • Works in 6 steps: Start the logging server (MANDATORY… → Understand the log format → Insert instrumentation logs → …
  • The user reports a bug
  • SKILL.md covers Logging, Critical Reminders (must follow) and Server API reference
  • Calls npx

What it does

Debug Agent is an agent skill from millionco/expect. Systematic evidence-based debugging using runtime logs. Generates hypotheses, instruments code with NDJSON logs, guides reproduction, analyzes log evidence, and iterates until root cause is proven with cited log lines. Use when the user reports a bug, unexpected behavior, or asks to debug an issue.

Its SKILL.md is about 2.6k 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 Debugging and Root cause analysis. The repository describes itself as: Expect tests your agent's code in a real browser.

When your agent uses it

  • The user reports a bug
  • Unexpected behavior
  • Asks to debug an issue

Example prompts

  • “/debug-agent”

Requirements

  • Node.js

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Start the logging server (MANDATORY BEFORE ANY INSTRUMENTATION)
  2. Understand the log format
  3. Insert instrumentation logs
  4. Clear previous log file before each run (MANDATORY)
  5. Read logs after user runs the program
  6. Keep logs during fixes

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • npx

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

  • Network

    No URLs in SKILL.md. Its commands use npx, 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 Agent loads about 2.6k tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 1,387 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,387 words (~2,618 tokens).

“You are now in DEBUG MODE. You must debug with runtime evidence.”

— opening of SKILL.md by millionco, Custom licence
name
debug-agent

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/debug-agent of millionco/expect.

Open the folder on GitHubat commit 39e9750

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders. This page covers the copy in millionco/expect, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Debug Agent 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 Agent compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Debug Agent this skillmillionco/expect3.6k—~2.6kAutomated safety check: PassCustom licence
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

  • OpenLogi macOS Permissions Triage

    AprilNEA/OpenLogi

    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 7 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.

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

More from millionco/expect

  • Effect Best Practices

    millionco/expect

    Enforces Effect-TS patterns for services, errors, layers, and atoms.

    3.6k GitHub stars~3.8k tokensUpdated 5 mo ago
    Auto-check passed

  • Effect Portable Patterns

    millionco/expect

    Portable Effect patterns for robust promise execution. An agent skill from millionco/expect.

    3.6k GitHub stars~3.7k tokensUpdated 5 mo ago
    Auto-check passed

  • Expect

    millionco/expect

    A skill your agent uses when editing .tsx/.jsx/.css/.html, React components, pages, routes, forms, styles, or layouts.

    3.6k GitHub stars~988 tokensUpdated 5 mo ago
    Auto-check passed

  • Skill Writing

    millionco/expect

    Write and improve agent skills (SKILL.md files). An agent skill from millionco/expect.

    3.6k GitHub stars~1.8k tokensUpdated 5 mo ago
    Auto-check passed

Categories

Questions about Debug Agent

What does Debug Agent do?

Systematic evidence-based debugging using runtime logs. An agent skill from millionco/expect. Debug Agent is an agent skill from millionco/expect. Systematic evidence-based debugging using runtime logs.

When should I use Debug Agent?

Debug Agent fits situations like: the user reports a bug; unexpected behavior; asks to debug an issue.

How do I install Debug Agent in Claude Code?

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

How do I install Debug Agent in Codex?

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

Can I use Debug Agent 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 millionco/expect --skill debug-agent -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-agent, .gemini/skills/debug-agent, .github/skills/debug-agent and .opencode/skills/debug-agent in your project.

What does Debug Agent need to run?

Going by SKILL.md and its folder, Debug Agent needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does Debug Agent access the network?

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

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

Debug Agent has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Debug Agent use?

About 2.6k tokens (SKILL.md is roughly 10k 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 Agent?

Skills that share tags, products or a category with Debug Agent: 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 Debug Agent?

millionco (a GitHub organization) maintains it in millionco/expect, which has 3,558 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on May 6, 2026.

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