tmb_recovery SKILL.md skillA

tmb_recovery from trustmybot/plugin is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add trustmybot/plugin/tmb_recovery@git:20261105.e930e06

Pins git:20261105.e930e06 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
trustmybot/plugin
Path
skills/tmb_recovery/SKILL.md
Versions recorded
11
Latest version
git:20261105.e930e06, committed Nov 5, 2026
First version recorded
Jun 20, 2026
Size
10,275 bytes
Repository stars
6
License
MIT

Bro's response when something fails — an MCP tool returns is_error=true (halt + surface), the trajectory-server is unreachable (degraded sqlite3 readonly fallback), or the world model is unavailable or empty (reconnect the server, or run /scan); when the failure is a TMB bug, offering an opt-in bug report the Human previews before bro files it. Loaded reactively on the first failure of a session.

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

# Recovery — three failure modes, three responses, and a bug report

Bro keeps the user-visible flow moving on recoverable errors. Each failure class has a deterministic fallback path; the judgment is *which class applies*.

The bundled fallback `node --experimental-sqlite "${CLAUDE_PLUGIN_ROOT}/mcp/trajectory-server/dist/cli.js" bro-sqlite-readonly` is for §B (trajectory-server unreachable). Invoke it via Bash — use it as a black box, not by reading its source directly.

## A. MCP tool returns is_error=true

When any MCP call result has `is_error: true` or content includes `{"error": ...}`, the call was wrong — not the doctrine.

### Protocol

1. **Halt the current flow immediately.** Treat the failed call as the chain's last.
2. **Pick one path** based on the error class:
   - **Surface verbatim** to the Human and ask how to proceed, OR
   - **If recoverable AND you know the corrected call**, append a note recording the error and the corrected retry, then retry.

### Error classification

| Error shape | Meaning | Right response |
|---|---|---|
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add trustmybot/plugin/tmb_recovery@sha256:3aa6e4a6ac407eeb

The line at the top of this page pins the label git:20261105.e930e06, 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_6srz2uxgusfnksjr.svg)](https://markdownregistry.com/a/art_6srz2uxgusfnksjr)

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

Versions

The registry has recorded 11 versions of this file, between Jun 20, 2026 and Nov 5, 2026, about one every 14 days.

versioncommittedcommitsizeaudit
git:20261105.e930e06 latest2026-11-05 e930e06 10,275 BA view · diff
git:20261105.b9189082026-11-05 b918908 10,262 BA view · diff
git:20261105.867fc972026-11-05 867fc97 10,143 BA view · diff
git:20261103.5cf31a32026-11-03 5cf31a3 10,146 BA view · diff
git:20261103.cf94c8d2026-11-03 cf94c8d 10,129 BA view · diff
git:20261025.78307a32026-10-25 78307a3 5,172 BA view · diff
git:20261021.c1dfee52026-10-21 c1dfee5 5,166 BA view · diff
git:20261019.22de22a2026-10-19 22de22a 6,336 BA view · diff
git:20260710.8fdbfe92026-07-10 8fdbfe9 6,326 BA view · diff
git:20260702.0a2ee542026-07-02 0a2ee54 4,511 BA view · diff
git:20260620.5d159b72026-06-20 5d159b7 3,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 (10275 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

trustmybot/plugin · 6 stars · license MIT · pushed 2026-11-05 · branch dev

API

GET https://markdownregistry.com/api/v1/artifacts/art_6srz2uxgusfnksjr
GET https://markdownregistry.com/api/v1/resolve?ref=trustmybot/plugin/tmb_recovery
GET https://markdownregistry.com/api/v1/blob/3aa6e4a6ac407eeb86a1ea0651fc4cc9fefe6a38354bfadfb42cdab0aef7134f

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 trustmybot/plugin

CLAUDE.md CLAUDE.md file
trustmybot/plugin · CLAUDE.md
git:20261026.b1dee64 · audit A · 6 stars
tmb-agent-setup SKILL.md skill
trustmybot/plugin · adapters/codex/skills/tmb-agent-setup/SKILL.md · Inspect, install, or remove TrustMyBot's two fixed project-level Codex Agents. Use only when the user explicitly…
git:20261026.b1dee64 · audit A · 6 stars
tmb-bro SKILL.md skill
trustmybot/plugin · adapters/codex/skills/tmb-bro/SKILL.md · Inspect a Git project with TMB's project-local inventory and world model, clarify a request, and capture an approved…
git:20260815.a2d60de · audit A · 6 stars
tmb_audit SKILL.md skill
trustmybot/plugin · skills/tmb_audit/SKILL.md · How bro audits, verifies or checks a component or an architecture — start from its outputs, state the invariants they…
git:20261012.15cca9e · audit A · 6 stars
tmb_cheatcode SKILL.md skill
trustmybot/plugin · skills/tmb_cheatcode/SKILL.md · When bro hits a wall — a task leans on a capability the project plainly lacks — and an existing published skill, MCP…
git:20261101.b2d4ceb · audit A · 6 stars
tmb_comment-triage SKILL.md skill
trustmybot/plugin · skills/tmb_comment-triage/SKILL.md · Bro's PR/MR comment triage — resolve the PR, fetch the comment threads, judge which are task-worthy, and dispatch SWE…
git:20261019.3444f14 · audit A · 6 stars
tmb_concerns-protocol SKILL.md skill
trustmybot/plugin · skills/tmb_concerns-protocol/SKILL.md · How bro raises a concern when doubting the Human's plan — surface inline via discussion_append + ask, or spawn a…
git:20261019.01719a2 · audit A · 6 stars
tmb_docs-conventions SKILL.md skill
trustmybot/plugin · skills/tmb_docs-conventions/SKILL.md · Loaded when editing prompt files (agents, skills, CLAUDE.md, workflow markdown) or updating user-visible docs. Carries…
git:20261026.b1dee64 · audit A · 6 stars
tmb_planning SKILL.md skill
trustmybot/plugin · skills/tmb_planning/SKILL.md · Bro's code-touching flow — verify world model, triage the requirement (reuse vs build), propose branch, write spec…
git:20261105.fd408a5 · audit A · 6 stars
tmb_push-gate SKILL.md skill
trustmybot/plugin · skills/tmb_push-gate/SKILL.md · Bro's push-gate orchestration — reaping unsigned commits, spawning code-reviewer per task, and the all-pass push +…
git:20261105.fd408a5 · audit A · 6 stars
tmb_review SKILL.md skill
trustmybot/plugin · skills/tmb_review/SKILL.md · code-reviewer's diff-level push-gate review — check this task's diff against its spec, then write the validation_record…
git:20261105.fd408a5 · audit A · 6 stars
tmb_skill-creator SKILL.md skill
trustmybot/plugin · skills/tmb_skill-creator/SKILL.md · Generate a new project-local skill at <project>/.claude/skills/<name>/SKILL.md and attach it to existing agents. Loads…
git:20261103.1283019 · audit A · 6 stars

Every file in trustmybot/plugin

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