method-debug SKILL.md skillA

method-debug from sajor2000/methodsmith is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add sajor2000/methodsmith/method-debug@git:20261016.73e5a37

Pins git:20261016.73e5a37 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
sajor2000/methodsmith
Path
plugins/methodsmith/skills/method-debug/SKILL.md
Versions recorded
1
Latest version
git:20261016.73e5a37, committed Oct 16, 2026
Size
15,879 bytes
Repository stars
3
License
MIT

Reproduces, traces, and fixes failing analysis code, pipelines, or tests by finding the cause first. Use when the user reports an error, failing test, or broken or slow run.

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 and Fix

## Skill Value

- **Problem it solves:** Bug fixing fails when agents patch symptoms without reproducing or understanding the root cause.
- **Use when:** The user reports an error, failed test, broken behavior, stack trace, issue, or asks why something is failing.
- **Output:** A reproduced cause, minimal fix, targeted tests, and a concise explanation of the causal chain.
- **Ask only if:** Only when reproduction requires unavailable credentials, data state, user role, or another external condition, or at the fix / diagnosis-only, branch, and learning-capture decision points.
- **Do not do:** Do not guess-fix without a causal chain unless the user explicitly accepts a best-available hypothesis.
- **Interaction:** Check repo/config/chat evidence first. Ask one decision-changing question at a time; use the current harness's blocking question UI when available, otherwise present numbered choices and wait.

Trace the full causal chain before proposing a fix, then optionally implement it test-first.

<bug_description> #$ARGUMENTS </bug_description>

## Core Principles
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add sajor2000/methodsmith/method-debug@sha256:901add7cc03d978c

The line at the top of this page pins the label git:20261016.73e5a37, 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_ngaq7ra57bv26ok4.svg)](https://markdownregistry.com/a/art_ngaq7ra57bv26ok4)

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

Versions

The registry has recorded 1 version of this file, committed on Oct 16, 2026.

versioncommittedcommitsizeaudit
git:20261016.73e5a37 latest2026-10-16 73e5a37 15,879 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 (15879 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

sajor2000/methodsmith · 3 stars · license MIT · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ngaq7ra57bv26ok4
GET https://markdownregistry.com/api/v1/resolve?ref=sajor2000/methodsmith/method-debug
GET https://markdownregistry.com/api/v1/blob/901add7cc03d978c366e3c88f90b1cb3e13222d3c2f09d192e70dfbce5868fba

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 sajor2000/methodsmith

AGENTS.md AGENTS.md file
sajor2000/methodsmith · AGENTS.md
git:20261016.114b5d8 · audit A · 3 stars
CLAUDE.md CLAUDE.md file
sajor2000/methodsmith · CLAUDE.md
git:20260318.f47f829 · audit B · 3 stars
coding-tutor SKILL.md skill
sajor2000/methodsmith · plugins/coding-tutor/skills/coding-tutor/SKILL.md · Personalized coding tutorials that build on your existing knowledge and use your actual codebase for examples. Creates…
git:20261010.185da1f · audit A · 3 stars
AGENTS.md@plugins/methodsmith AGENTS.md file
sajor2000/methodsmith · plugins/methodsmith/AGENTS.md
git:20261016.114b5d8 · audit A · 3 stars
method-adversarial-review SKILL.md skill
sajor2000/methodsmith · plugins/methodsmith/skills/method-adversarial-review/SKILL.md · Challenges a high-stakes analysis diff or plan with an adversarial pass and, when available, a cross-model…
git:20261016.73e5a37 · audit A · 3 stars
method-anti-slop SKILL.md skill
sajor2000/methodsmith · plugins/methodsmith/skills/method-anti-slop/SKILL.md · Detects and removes generic AI-writing tells from finished scientific prose, keeping passive Methods voice. Use when…
git:20261016.73e5a37 · audit A · 3 stars
method-brainstorm SKILL.md skill
sajor2000/methodsmith · plugins/methodsmith/skills/method-brainstorm/SKILL.md · Explores a research or analysis idea, compares study designs, and scopes requirements before planning. Use when the…
git:20261016.73e5a37 · audit A · 3 stars
method-checklist SKILL.md skill
sajor2000/methodsmith · plugins/methodsmith/skills/method-checklist/SKILL.md · Selects EQUATOR reporting guidelines (CONSORT, STROBE, RECORD, PRISMA, TRIPOD+AI, TARGET, STARD, CLAIM) for a study…
git:20261016.73e5a37 · audit A · 3 stars
method-citations SKILL.md skill
sajor2000/methodsmith · plugins/methodsmith/skills/method-citations/SKILL.md · Builds evidence-traceable citations from PubMed and Paperclip into a DOCX with editable Zotero fields. Use when adding…
git:20261016.114b5d8 · audit A · 3 stars
method-clean-branches SKILL.md skill
sajor2000/methodsmith · plugins/methodsmith/skills/method-clean-branches/SKILL.md · Deletes local git branches whose upstream is gone, and their worktrees, after confirmation. Use when the user asks to…
git:20261016.73e5a37 · audit A · 3 stars
method-clif-meta-analysis SKILL.md skill
sajor2000/methodsmith · plugins/methodsmith/skills/method-clif-meta-analysis/SKILL.md · Plans formal R/Python meta-analysis. Use when pooling CLIF site effects or conducting a literature systematic review.
git:20261017.9e40c82 · audit A · 3 stars
method-clif-template SKILL.md skill
sajor2000/methodsmith · plugins/methodsmith/skills/method-clif-template/SKILL.md · Initializes or audits a CLIF analysis repo against the official CLIF Project Template, with PHI and output safeguards…
git:20261016.73e5a37 · audit A · 3 stars

Every file in sajor2000/methodsmith

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