analytical-troubleshooting SKILL.md skillA
analytical-troubleshooting from air-gapped/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add air-gapped/skills/analytical-troubleshooting@git:20261019.819b406Pins git:20261019.819b406 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- air-gapped/skills
- Path
.claude/skills/analytical-troubleshooting/SKILL.md- Versions recorded
- 10
- Latest version
- git:20261019.819b406, committed Oct 19, 2026
- First version recorded
- Jul 29, 2026
- Size
- 15,879 bytes
- Repository stars
- 5
- License
- MIT
Structured live troubleshooting for deviation problems: something worked (or should work) and now doesn't, and the cause is unknown. Staged method — quick likelihood-weighted tests first, escalating to a comparative IS/IS-NOT specification with distinctions-and-changes analysis when quick tests fail or the search space is large. Influenced by the problem-analysis tradition of Kepner & Tregoe. Works whether the user runs the tests (agent directs, user executes) or the agent can test directly.
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
# Analytical Troubleshooting A staged method for finding the cause of a **deviation**: performance that used to be acceptable (or should be) no longer is, and nobody knows why. The core discipline: track what the problem **IS** and, with equal care, what it plausibly **could be but IS NOT**. A cause that explains only the failures is a guess; a cause that explains the failures *and* the survivals is a diagnosis. Never anchor on the first plausible cause or collect only confirming evidence. Act as process leader and bookkeeper: keep the table, the hypothesis list and the test plan. When a human partner is involved, they are the sensors and hands — ask sharp questions rather than assume their system's state. Why each mechanism is here: `references/evidence.md`. ## Hard rules 1. **Never invent evidence.** Every fact in the analysis carries a provenance tag: `[observed]` (directly seen this session by agent or user), `[reported]` (someone said so), or `[assumed]`. Evidence not obtained from the world must not be recorded as observed. When a test hasn't run yet, its result is unknown — not "probably fine". Tag what the user did not …
Read the whole file at its exact version.
How to install
mdr add air-gapped/skills/analytical-troubleshooting@sha256:d8a0fed0defa4961The line at the top of this page pins the label git:20261019.819b406, 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.
[](https://markdownregistry.com/a/art_n2gxr6hhieblgm3z)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 10 versions of this file, between Jul 29, 2026 and Oct 19, 2026, about one every 9 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261019.819b406 latest | 2026-10-19 | 819b406 | 15,879 B | A | view · diff |
| git:20261019.c43eb0d | 2026-10-19 | c43eb0d | 15,927 B | A | view · diff |
| git:20261019.de3b358 | 2026-10-19 | de3b358 | 16,053 B | A | view · diff |
| git:20261019.e514ae8 | 2026-10-19 | e514ae8 | 15,875 B | A | view · diff |
| git:20261019.f3d62b9 | 2026-10-19 | f3d62b9 | 15,919 B | A | view · diff |
| git:20260809.f9d58a3 | 2026-08-09 | f9d58a3 | 14,901 B | A | view · diff |
| git:20260729.11cc13c | 2026-07-29 | 11cc13c | 13,877 B | A | view · diff |
| git:20260729.4b81418 | 2026-07-29 | 4b81418 | 13,734 B | A | view · diff |
| git:20260729.55bfc4a | 2026-07-29 | 55bfc4a | 13,874 B | A | view · diff |
| git:20260729.5b41423 | 2026-07-29 | 5b41423 | 13,800 B | A | view |
Audit of the latest version
- 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
air-gapped/skills · 5 stars · license MIT · pushed 2026-10-28 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_n2gxr6hhieblgm3z GET https://markdownregistry.com/api/v1/resolve?ref=air-gapped/skills/analytical-troubleshooting GET https://markdownregistry.com/api/v1/blob/d8a0fed0defa4961cfe6f4baf89a7dcc97da3b68ea9b3595765490c00e7cf1f8
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.