debug SKILL.md skillA

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

Install it, pinned
mdr add ohm41321/luciazero/debug@git:20261007.d703251

Pins git:20261007.d703251 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ohm41321/luciazero
Path
skills/debug/SKILL.md
Versions recorded
5
Latest version
git:20261007.d703251, committed Oct 7, 2026
First version recorded
Aug 15, 2026
Size
2,338 bytes
Repository stars
6
License
MIT

Debug a stubborn bug with a deterministic reproduction, hypothesis ledger, one-variable fixes, and a regression test. Use after the first obvious look fails, reproduction is unclear, or a fix attempt failed. Not for routine obvious failures; use for "ไล่บั๊ก".

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

For bugs that resist the first obvious look: debugging starts with a hypothesis,
not an edit. Reality, not a plausible patch, decides.

## 1. Reproduce first

Find one command that shows the failure deterministically. It is ground truth.
Do not theorize about causes of a failure you cannot trigger.

For intermittent failures, fix the seed, pin the time/timezone, run it in a loop,
and identify the trigger before proceeding.

## 2. Minimize

Shrink to smaller input, fewer flags, one test instead of the suite. Stop when
further reduction costs more than it clarifies.

## 3. Hypothesis ledger

Before inventing causes, search the symptom in:

- repo ledger `docs/lessons.md`;
- configured harness `luciazero-heuristics.md` under
  `${CLAUDE_CONFIG_DIR:-$HOME/.claude}` or
  `${CODEX_HOME:-$HOME/.codex}`.

A match becomes **H1**, but must pass its `proven-by` observation.

```
H<N>: <suspected cause> — refutable by: <command / observation> → <refuted|confirmed|pending>
```

Run the observation, not the edit. Choose the cheapest discriminating log,
query, debugger stop, grep, or bisect. Trust real state. Dead hypotheses stay in
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ohm41321/luciazero/debug@sha256:f262c3c4886b4ce8

The line at the top of this page pins the label git:20261007.d703251, 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_azcxp3j3sqhjp6ox.svg)](https://markdownregistry.com/a/art_azcxp3j3sqhjp6ox)

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

Versions

The registry has recorded 5 versions of this file, between Aug 15, 2026 and Oct 7, 2026, about one every 13 days.

versioncommittedcommitsizeaudit
git:20261007.d703251 latest2026-10-07 d703251 2,338 BA view · diff
git:20261006.cf0de5b2026-10-06 cf0de5b 2,268 BA view · diff
git:20260820.35b5e3e2026-08-20 35b5e3e 2,267 BA view · diff
git:20260816.a197bdc2026-08-16 a197bdc 4,206 BA view · diff
git:20260815.06dd5a62026-08-15 06dd5a6 4,231 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 (2338 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

ohm41321/luciazero · 6 stars · license MIT · pushed 2026-10-11 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_azcxp3j3sqhjp6ox
GET https://markdownregistry.com/api/v1/resolve?ref=ohm41321/luciazero/debug
GET https://markdownregistry.com/api/v1/blob/f262c3c4886b4ce83e338c0039889504b41003b0fda18e4fa1a276473e36bf5f

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 ohm41321/luciazero

lucia-orchestrator SKILL.md skill
ohm41321/luciazero · adapters/astra-luna/skills/lucia-orchestrator/SKILL.md · Coordinate bounded project work through Luciazero's existing proof and closeout skills when project-scoped delegation…
git:20260921.007e161 · audit A · 6 stars
luciazero-bootstrap SKILL.md skill
ohm41321/luciazero · migrations/luciazero-bootstrap-v2.2.0/SKILL.md · Compatibility alias for /ready. Use only when the user explicitly invokes /luciazero-bootstrap; tell them it was…
git:20260816.a197bdc · audit A · 6 stars
bisect SKILL.md skill
ohm41321/luciazero · skills/bisect/SKILL.md · Pinpoint the first bad commit for a reproducible regression in a safe temporary worktree. Use when HEAD is bad, a known…
git:20261006.cf0de5b · audit A · 6 stars
discipline-report SKILL.md skill
ohm41321/luciazero · skills/discipline-report/SKILL.md · Analyze Luciazero stop-outcome logs for evidence-backed verification habits. Use for discipline stats, recurring nudge…
git:20260820.35b5e3e · audit A · 6 stars
done SKILL.md skill
ohm41321/luciazero · skills/done/SKILL.md · Run the closeout ritual before handing back non-trivial work; full verification, revert-probe honesty, independent…
git:20261007.d703251 · audit A · 6 stars
experiment SKILL.md skill
ohm41321/luciazero · skills/experiment/SKILL.md · Measure performance or tuning changes with a baseline, controlled comparison, correctness check, and recorded verdict…
git:20260820.35b5e3e · audit A · 6 stars
imouto-mode SKILL.md skill
ohm41321/luciazero · skills/imouto-mode/SKILL.md · Use only when explicitly invoked to select Lucia's optional warm, lightly tsundere coding voice or inspect its choices…
git:20260909.2144eb1 · audit A · 6 stars
lucia-bus SKILL.md skill
ohm41321/luciazero · skills/lucia-bus/SKILL.md · Coordinate with other agents through the Luciazero Agent Bus (beta): register, read the inbox, claim a task, work…
git:20260905.31a7dc3 · audit A · 6 stars
lucia-chat SKILL.md skill
ohm41321/luciazero · skills/lucia-chat/SKILL.md · Set two agent sessions talking through the Luciazero Agent Bus and watch it live in a terminal: pick the pair, open the…
git:20261007.433fba9 · audit A · 6 stars
lucia-relay SKILL.md skill
ohm41321/luciazero · skills/lucia-relay/SKILL.md · Transfer unfinished work and non-obvious knowledge across sessions, agents, people, machines, or harnesses. Use for…
git:20261007.9a31b8a · audit A · 6 stars
plan SKILL.md skill
ohm41321/luciazero · skills/plan/SKILL.md · Build a falsifiable implementation plan for new features, major refactors, ambiguous work, or risky multi-module…
git:20260820.35b5e3e · audit A · 6 stars
ready SKILL.md skill
ohm41321/luciazero · skills/ready/SKILL.md · Make an unfamiliar repository agent-ready with a verify command, smoke tests, guardrails, and project notes. Use for…
git:20261006.cf0de5b · audit A · 6 stars

Every file in ohm41321/luciazero

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.