debug is agent-read markdown (skill) from firzus/agent-skills: Investigate bugs, failing tests, crashes, unexpected behavior, and performance regressions through reproducible evidence and hypothesis testing. Use when asked to debug or diagnose; apply and verify a fix only when authorized..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# Debug with evidence
Find the cause of the reported failure, not merely a change that hides it.
Accept a symptom, failing command, or captured artifact; ask only for missing
information that prevents the next useful check. Feature work is outside this skill.
## 1. Establish the failure
- Read applicable instructions, relevant code, callers, tests, and recent changes.
Record expected versus actual behavior, affected inputs, environment, and versions.
- Confirm scope: diagnosis permits inspection, not source edits. A fix request permits
local implementation and verification, not deployment or production experiments.
Obtain authorization for instrumentation or other writes outside that scope.
- Protect existing work. Sanitize commands, logs, traces, and fixtures before sharing;
never dump credentials or replay requests with real side effects without permission.
- During an incident, separate authorized service-restoration measures from diagnosis;
retain available evidence before disruptive actions. Recovery does not prove cause.
**Ready:** a precise symptom and a safe investigation scope; otherwise request the
…
Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
A 17 of 17 checks passed. Deterministic, no model, same answer every run.
pass: Frontmatter block present
pass: Frontmatter declares a name
pass: Frontmatter declares a description
pass: Size between 200 bytes and 200 KB (5562 bytes)
pass: No zero-width or bidi control characters
pass: No instruction hidden inside an HTML comment
pass: No link to an exfiltration or paste host
pass: No credential-shaped string
pass: No instruction to send local credentials anywhere
pass: No text hidden with inline styles
pass: No prompt-injection phrasing
pass: No curl or wget piped into a shell
pass: No recursive delete of root, home or parent
pass: No instruction to read or print local credentials
pass: No base64 blob over 200 characters
pass: No link to a raw IP address
pass: No script tag
Source
GitHub
firzus/agent-skills · 3 stars · license MIT · pushed 2026-09-23 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_hlqo2gzupo7pjwin
GET https://markdownregistry.com/api/v1/resolve?ref=firzus/agent-skills/debug
GET https://markdownregistry.com/api/v1/blob/0e7b52b3febbfd6e655a7f56c43afec1804890e71ac36b0364f6ba48e258f2cb
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
firzus/agent-skills · skills/engineering/code-review/SKILL.md · Review a scoped diff against requirements, project standards, and correctness using independent read-only reviewers…
firzus/agent-skills · skills/engineering/deep-research/SKILL.md · Investigate a question across sources with delegated research, adversarial verification, and a reusable evidence…
firzus/agent-skills · skills/engineering/gamification/SKILL.md · Gamification design for products, apps, and game meta-layers: design an engagement, habit, or retention system; choose…
firzus/agent-skills · skills/engineering/implement/SKILL.md · Deliver prepared work with test-first verification, current documentation, and a verified handoff.
firzus/agent-skills · skills/engineering/interview/SKILL.md · Prepare approved Linear work briefs through a continuous interview, with progressive framing for large goals.
firzus/agent-skills · skills/engineering/prototype/SKILL.md · Resolve a bounded design or feasibility question through an observable experiment. Use for authorized interface, logic…
firzus/agent-skills · skills/engineering/security-review/SKILL.md · Perform source-only security audits of codebases, APIs, services, and applications. Use for security questions, focused…
firzus/agent-skills · skills/engineering/setup-codex/SKILL.md · Configure a reviewed Codex Operating Policy through model_instructions_file and offer low model verbosity with separate…
yeachan-heo/oh-my-claudecode · skills/debug/SKILL.md · Diagnose the current OMC session or repo state using logs, traces, state, and focused reproduction
nanocoai/nanoclaw · .claude/skills/debug/SKILL.md · Debug container agent issues. Use when things aren't working, container fails, authentication problems, or to…
agentic-community/mcp-gateway-registry · .claude/skills/debug/SKILL.md · Debug issues in the MCP Gateway Registry using first-principles thinking. Invoke when something is broken, timing out…
suboss87/fdeops · skills/debug/SKILL.md · Investigate a failure, regression or incorrect result in an integration or application, even before it can be…
arbiterforge/codearbiter · plugins/ca-codex/routines/debug/SKILL.md · Investigate-then-decide root-cause analysis for a defect whose cause is unknown (distinct from /fix, which assumes a…
arbiterforge/codearbiter · plugins/ca/skills/debug/SKILL.md · Investigate-then-decide root-cause analysis for a defect whose cause is unknown (distinct from /fix, which assumes a…
arbiterforge/codearbiter · plugins/ca-pi/routines/debug/SKILL.md · Investigate-then-decide root-cause analysis for a defect whose cause is unknown (distinct from /fix, which assumes a…
