debug SKILL.md skillA

This file is byte-identical to the first copy the registry indexed, one of 4 indexed copies. Same content hash, so the same checks give both the same grade.

debug from yelmuratoff/exuno is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add yelmuratoff/exuno/debug@git:20260728.7c60c81

Pins git:20260728.7c60c81 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
yelmuratoff/exuno
Path
.ai/src/skills/debug/SKILL.md
Versions recorded
5
Latest version
git:20260728.7c60c81, committed Jul 28, 2026
First version recorded
Apr 5, 2026
Size
1,979 bytes
Repository stars
17
License
GPL-3.0

Investigate and fix bugs, errors, or unexpected behavior systematically — reproduce, locate, understand the root cause, fix it, and add a regression test. Use this skill when the user reports a failure (test, runtime, build, CI), shares a stack trace or error message, says something doesn't work, asks why something is broken, or asks for a fix that requires diagnosis — even when the word "debug" is not used (e.g. "this is broken", "why is it failing", "X doesn't work").

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Debug

Systematically find and fix the root cause of a bug.

## Steps

1. **Reproduce** — Get the exact error message, stack trace, or steps to reproduce. Understand what happens vs. what should happen.
2. **Locate** — Narrow down where the problem is:
   - Read the error message and stack trace — they usually point to the exact location.
   - Search for relevant keywords (error strings, function names).
   - Trace the data flow from input to the failure point.
3. **Understand** — Before fixing, understand *why* it fails:
   - What assumption is violated?
   - When was it introduced? (`git log`, `git blame`)
   - Logic error? Data problem? Race condition? Missing edge case?
4. **Fix** — Make the smallest change that correctly addresses the root cause.
5. **Verify** — Write or update a test that catches this bug. Run the full test suite for regressions.
6. **Explain** — Briefly describe what caused it and why the fix is correct.

## Gotchas

- Let the error surface until you understand it. A silent try-catch hides the cause and breeds a worse bug later.
- Trace to the root cause before applying the fix. Symptom-level patches return as new bugs.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add yelmuratoff/exuno/debug@sha256:1e50f261efd10d1c

The line at the top of this page pins the label git:20260728.7c60c81, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_copofu2wvcwce4sk.svg)](https://markdownregistry.com/a/art_copofu2wvcwce4sk)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Apr 5, 2026 and Jul 28, 2026, about one every 29 days.

versioncommittedcommitsizeaudit
git:20260728.7c60c81 latest2026-07-28 7c60c81 1,979 BA view · diff
git:20260512.5fd702f2026-05-12 5fd702f 1,996 BA view · diff
git:20260425.aadd1612026-04-25 aadd161 1,892 BA view · diff
git:20260405.10ecc092026-04-05 10ecc09 2,163 BA view · diff
git:20260405.fa7c92c2026-04-05 fa7c92c 1,556 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the 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 (1979 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

yelmuratoff/exuno · 17 stars · license GPL-3.0 · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_copofu2wvcwce4sk
GET https://markdownregistry.com/api/v1/resolve?ref=yelmuratoff/exuno/debug
GET https://markdownregistry.com/api/v1/blob/1e50f261efd10d1c7f2b0ff8908c7ce88969d61e3c68b166d183fbf43c06d7b5

Your AI assistant 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.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from yelmuratoff/exuno

AGENTS.md@.ai/src AGENTS.md file
yelmuratoff/exuno · .ai/src/AGENTS.md
git:20261007.95b1395 · audit B · 17 stars
add-tool SKILL.md skill
yelmuratoff/exuno · .ai/src/skills/add-tool/SKILL.md · Add support for a new AI coding tool to Exuno's sync engine — create the tool YAML, configure targets and converters…
git:20261007.95b1395 · audit A · 17 stars
comments SKILL.md skill
yelmuratoff/exuno · .ai/src/skills/comments/SKILL.md · Scan recently written or edited code and remove comments that do not earn their place — narration, step markers…
git:20260512.5fd702f · audit A · 17 stars
commit SKILL.md skill
yelmuratoff/exuno · .ai/src/skills/commit/SKILL.md · Create a well-structured git commit for staged or unstaged changes — analyze the diff, match the project's existing…
git:20260728.7c60c81 · audit A · 17 stars
fix-issue SKILL.md skill
yelmuratoff/exuno · .ai/src/skills/fix-issue/SKILL.md · Investigate and fix a GitHub issue in this repo — pull the issue with `gh`, trace it to the root cause across `src/`…
git:20260919.72b55dc · audit A · 17 stars
prompt-engineering SKILL.md skill
yelmuratoff/exuno · .ai/src/skills/prompt-engineering/SKILL.md · Design, debug, and refine prompts for LLM-based coding tools, agents, and pipelines. Use this skill when writing or…
git:20261007.95b1395 · audit A · 17 stars
refactor SKILL.md skill
yelmuratoff/exuno · .ai/src/skills/refactor/SKILL.md · Restructure existing code without changing its behavior — reduce duplication, improve naming, simplify complex logic…
git:20260728.7c60c81 · audit A · 17 stars
release SKILL.md skill
yelmuratoff/exuno · .ai/src/skills/release/SKILL.md · Bump the Exuno version, write a CHANGELOG entry summarising changes since the last tag, and prepare a clean release…
git:20261012.dc99d8c · audit A · 17 stars
review SKILL.md skill
yelmuratoff/exuno · .ai/src/skills/review/SKILL.md · Perform a structured code review on a diff, PR, or staged changes — surface correctness, security, error-handling…
git:20261007.95b1395 · audit A · 17 stars
AGENTS.md@example/.ai/src AGENTS.md file
yelmuratoff/exuno · example/.ai/src/AGENTS.md
git:20260331.a1a2b85 · audit A · 17 stars
commit SKILL.md skill
yelmuratoff/exuno · example/.ai/src/skills/commit/SKILL.md · Create a well-structured git commit for staged or unstaged changes — analyze the diff, match the project's existing…
git:20260728.7c60c81 · audit A · 17 stars
debug SKILL.md skill
yelmuratoff/exuno · example/.ai/src/skills/debug/SKILL.md · Investigate and fix bugs, errors, or unexpected behavior systematically — reproduce, locate, understand the root cause…
git:20260728.7c60c81 · audit A · 17 stars

Every file in yelmuratoff/exuno

Other files named debug

debug SKILL.md skill
yeachan-heo/oh-my-claudecode · skills/debug/SKILL.md · Diagnose the current OMC session or repo state using logs, traces, state, and focused reproduction
git:20260925.570ed1c · audit A · 40,148 stars
debug SKILL.md skill
nanocoai/nanoclaw · .claude/skills/debug/SKILL.md · Debug container agent issues. Use when things aren't working, container fails, authentication problems, or to…
git:20260928.66fc9c0 · audit B · 30,979 stars
debug SKILL.md skill
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…
v1.0 · audit A · 1,012 stars
debug SKILL.md skill
suboss87/fdeops · skills/debug/SKILL.md · Investigate a failure, regression or incorrect result in an integration or application, even before it can be…
git:20261005.ed7f271 · audit A · 969 stars
debug SKILL.md skill
ericrisco/rsc-harness · skills/debug/SKILL.md · Use when something is broken — a failing or flaky test, crash, wrong result or regression — and the root cause must be…
git:20261003.f0c84d6 · audit A · 236 stars
debug SKILL.md skill
sd0xdev/sd0x-harness · skills/debug/SKILL.md · Interactive debugging workflow with hypothesis-driven probe loop. Use when: unknown bugs, script errors, silent…
git:20260925.3600370 · audit A · 194 stars
debug SKILL.md skill
arbiterforge/codearbiter · plugins/ca-codex/routines/debug/SKILL.md · Investigate an unexplained defect or unexpected behavior without changing application code. Use for root-cause…
git:20261012.4c2529e · audit A · 149 stars
debug SKILL.md skill
arbiterforge/codearbiter · plugins/ca/skills/debug/SKILL.md · Investigate an unexplained defect or unexpected behavior without changing application code. Use for root-cause…
git:20261012.4c2529e · audit A · 149 stars

Browse by kind, by grade A, or by owner.