diagnose SKILL.md skillA
diagnose from mycelium-hq/ai-brain-starter is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add mycelium-hq/ai-brain-starter/diagnose@git:20260816.6ac8364Pins git:20260816.6ac8364 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- mycelium-hq/ai-brain-starter
- Path
skills/diagnose/SKILL.md- Versions recorded
- 5
- Latest version
- git:20260816.6ac8364, committed Aug 16, 2026
- First version recorded
- Jun 19, 2026
- Size
- 8,475 bytes
- Repository stars
- 50
- License
- MIT
Use when an AI Brain vault needs a health check or something feels off: Claude ignores CLAUDE.md, journal entries missing from /weekly, hooks not firing, something broke after a git pull, a friend''s install misbehaves, Obsidian crashes or pegs the CPU, a .claude/worktrees folder appeared, Granola/WhatsApp/Slack/Gmail notes stopped arriving, or Windows .ps1 scripts error. Also after major /setup-brain upgrades. Not for debugging code; audits the vault install only.
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
# /diagnose
> **`{SKILL_DIR}`** = this skill's own folder (locally: the directory this SKILL.md lives in; a served brain substitutes the real absolute path before you read this). Shared starter files live at the repo root two levels up: `{SKILL_DIR}/../..`. If a path does not resolve, name the missing file and stop — never guess another location.
Tells you whether your second brain is healthy.
## Why
Most "Claude is broken" reports trace to one of:
- CLAUDE.md missing or has no Vault Map
- Hooks not registered, so no auto context-loading
- `journal-index.json` stale or malformed, so insights find nothing
- `.ps1` files lost their UTF-8 BOM, so Windows PowerShell crashes
- ai-brain-starter is many commits behind, so the user is on stale logic
`/diagnose` checks all of these in ~5 seconds. It writes nothing, sends no network requests beyond a single `git fetch`, and exits with a status code so it can be wired into CI or cron.
## What to do
1. Find the script: `{SKILL_DIR}/../../scripts/diagnose.sh` (the starter repo root sits two levels above this skill's folder on every install shape).
2. Run it. Pick the right one for the platform:
**Mac / Linux:**
```bash
…Read the whole file at its exact version.
How to install
mdr add mycelium-hq/ai-brain-starter/diagnose@sha256:e23752950a7ab03eThe line at the top of this page pins the label git:20260816.6ac8364, 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_f4wjstydep4kyuit)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Jun 19, 2026 and Aug 16, 2026, about one every 14 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260816.6ac8364 latest | 2026-08-16 | 6ac8364 | 8,475 B | A | view · diff |
| git:20260722.7893e72 | 2026-07-22 | 7893e72 | 7,649 B | A | view · diff |
| git:20260707.f0ac903 | 2026-07-07 | f0ac903 | 7,388 B | A | view · diff |
| git:20260620.d5e44bb | 2026-06-20 | d5e44bb | 7,235 B | A | view · diff |
| git:20260619.26491e3 | 2026-06-19 | 26491e3 | 6,587 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 (8475 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
mycelium-hq/ai-brain-starter · 50 stars · license MIT · pushed 2026-11-02 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_f4wjstydep4kyuit GET https://markdownregistry.com/api/v1/resolve?ref=mycelium-hq/ai-brain-starter/diagnose GET https://markdownregistry.com/api/v1/blob/e23752950a7ab03ec6b97b0631f6323c3989138c78bea98b6b0390e188dc4985
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 mycelium-hq/ai-brain-starter
Every file in mycelium-hq/ai-brain-starter