debug-loop SKILL.md skillA

debug-loop from protolabsai/protoagent is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add protolabsai/protoagent/debug-loop@git:20261016.98e6e56

Pins git:20261016.98e6e56 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
protolabsai/protoagent
Path
plugins/engineer/skills/debug-loop/SKILL.md
Versions recorded
2
Latest version
git:20261016.98e6e56, committed Oct 16, 2026
First version recorded
Sep 25, 2026
Size
6,226 bytes
Repository stars
17
License
MIT

Guide the operator through finding and fixing a bug as their navigator — one checkpoint per turn (orient, reproduce, narrow, hypothesize, locate, the operator fixes, verify, the operator commits), asking for their hypothesis before giving yours, and never editing or committing unless they explicitly ask. Use when something is broken, failing, hangs, returns nothing, "stops without answering", throws, or a test is red.

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

# Guided debug loop

You are the navigator; the operator drives. **Each numbered step is ONE turn.** Do the
step, show the evidence, then **end the turn with the question shown.** Don't run ahead to
the next step unless the operator says "keep going", "go ahead", or equivalent. Open each
turn with a one-line "where we are" (e.g. `Step 2/7: reproduce`).

If the operator says **"just tell me"** or **"speed up"**, compress: give your conclusion
with evidence and move on, but still leave the edit and the commit to them (unless they say
"apply it").

## 1. Orient (only if the repo isn't mapped yet; otherwise skip to 2)
Run `repo-onboard`. Ask: *"Want to reproduce it together, or is there a part of the flow
you'd like to walk through first?"*

## GitHub stays theirs
Read it freely: the issue that reported the bug, the PR that introduced it, the failing CI
run's log are all evidence. But never open, comment on, label, close, or merge an issue or
PR, and never push, unless the operator's latest message asks. Draft the text instead
(issue body, PR description, review comment) and let them post it.

## 2. Reproduce (then STOP)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add protolabsai/protoagent/debug-loop@sha256:365ba047c9740420

The line at the top of this page pins the label git:20261016.98e6e56, 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_vfpw27gmqnhceswy.svg)](https://markdownregistry.com/a/art_vfpw27gmqnhceswy)

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

Versions

The registry has recorded 2 versions of this file, between Sep 25, 2026 and Oct 16, 2026, about one every 20 days.

versioncommittedcommitsizeaudit
git:20261016.98e6e56 latest2026-10-16 98e6e56 6,226 BA view · diff
git:20260925.75b6c262026-09-25 75b6c26 5,928 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 (6226 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

protolabsai/protoagent · 17 stars · license MIT · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_vfpw27gmqnhceswy
GET https://markdownregistry.com/api/v1/resolve?ref=protolabsai/protoagent/debug-loop
GET https://markdownregistry.com/api/v1/blob/365ba047c9740420db491fbb508db54c5be75814edce41b3fc438f7491be0543

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 protolabsai/protoagent

protocol-research SKILL.md skill
protolabsai/protoagent · .proto/evolve/skills/protocol-research/SKILL.md · Systematic research workflow for documenting protocols, standards, or technologies
git:20260811.efa4d71 · audit A · 17 stars
AGENTS.md AGENTS.md file
protolabsai/protoagent · AGENTS.md
git:20260826.039be25 · audit A · 17 stars
CLAUDE.md CLAUDE.md file
protolabsai/protoagent · CLAUDE.md
git:20260621.c2b38fe · audit A · 17 stars
web-research SKILL.md skill
protolabsai/protoagent · config/skills/web-research/SKILL.md · Use this whenever the user asks you to research a topic, find the current state of something, compare options, or…
git:20260614.0806170 · audit A · 17 stars
web-browse SKILL.md skill
protolabsai/protoagent · plugins/agent_browser/skills/web-browse/SKILL.md · Open a website, fill a form, click buttons, take a screenshot, print a page to PDF, scrape or extract page content…
git:20261005.5840202 · audit A · 17 stars
diagramming-code SKILL.md skill
protolabsai/protoagent · plugins/artifact/skills/diagramming-code/SKILL.md · When the user asks for a diagram OF THE CODE — a sequence diagram of a call flow, a flowchart or class diagram of a…
git:20260926.92196ac · audit A · 17 stars
rendering-artifacts SKILL.md skill
protolabsai/protoagent · plugins/artifact/skills/rendering-artifacts/SKILL.md · When the user wants to SEE, render, visualize, preview, or "show me" a chart, diagram, mock-up, table, or interactive…
git:20261029.970834a · audit B · 17 stars
consolidate-memory SKILL.md skill
protolabsai/protoagent · plugins/cowork/skills/consolidate-memory/SKILL.md · Reflective maintenance pass over long-term memory — merge duplicates, retire stale or completed items, sharpen what…
git:20260912.42516ad · audit A · 17 stars
daily-brief SKILL.md skill
protolabsai/protoagent · plugins/cowork/skills/daily-brief/SKILL.md · Compose the operator's daily brief — schedule, things waiting on them, ongoing work, and heads-ups. LOAD THIS SKILL…
git:20260912.42516ad · audit A · 17 stars
docx SKILL.md skill
protolabsai/protoagent · plugins/cowork/skills/docx/SKILL.md · Produce or modify Word documents (.docx) as real files — reports, memos, letters, proposals, or any deliverable the…
git:20261006.9b4f42f · audit A · 17 stars
drop-folder SKILL.md skill
protolabsai/protoagent · plugins/cowork/skills/drop-folder/SKILL.md · Turn a fenced work folder into a drop zone — a watch notices when files land, change, or disappear there and runs a…
git:20260912.42516ad · audit A · 17 stars
pdf SKILL.md skill
protolabsai/protoagent · plugins/cowork/skills/pdf/SKILL.md · Read, extract from, combine, split, watermark, fill, or produce PDF files. Use whenever a .pdf is the input or the…
git:20261006.9b4f42f · audit A · 17 stars

Every file in protolabsai/protoagent

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