Diagnose SKILL.md skillA

Diagnose from wrg32786/aigent-os is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add wrg32786/aigent-os/Diagnose@git:20260707.2a2e857

Pins git:20260707.2a2e857 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
wrg32786/aigent-os
Path
skills/diagnose/SKILL.md
Versions recorded
1
Latest version
git:20260707.2a2e857, committed Jul 7, 2026
Size
6,538 bytes
Repository stars
23
License
MIT

When something feels off, type /diagnose and describe the symptom. The skill walks the seven-layer stack (kernel, skills, hooks, daemons, vault, doctrine, principal config) and reports which layer is most likely responsible. Caddy pattern applied to debugging.

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

Most failures in an aigent-OS install aren't bugs in any single component — they're integration failures across layers. `/diagnose` walks the stack with you so you don't have to.

## When to use

- "It used to work, now it doesn't"
- Caddy isn't surfacing a skill you expect
- `/open` produces incomplete context
- Hooks not firing
- Wikilinks not resolving
- AI behavior changed unexpectedly after an update
- Anything you can't immediately attribute to a single component

## How to execute

### Step 1 — Capture the symptom

Ask the user (or read from their prompt):
- **What were you trying to do?**
- **What happened instead?**
- **What did you expect?**
- **What changed recently?** (git pull, new skill installed, hook edit, kernel update)

Frame the symptom in one sentence. Example: *"Caddy used to surface /channel-audit when I asked about YouTube performance, now it doesn't."*

### Step 2 — Walk the seven-layer stack

For each layer, ask: could this layer be responsible for the symptom? If yes, run the specific check. If no, move on.

```
LAYER 7 — Principal Configuration
   - system/00_identity.md customized?
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add wrg32786/aigent-os/Diagnose@sha256:63b57798e2d26395

The line at the top of this page pins the label git:20260707.2a2e857, 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_3xh4xmcgnjzlv5fg.svg)](https://markdownregistry.com/a/art_3xh4xmcgnjzlv5fg)

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

Versions

The registry has recorded 1 version of this file, committed on Jul 7, 2026.

versioncommittedcommitsizeaudit
git:20260707.2a2e857 latest2026-07-07 2a2e857 6,538 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 (6538 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

wrg32786/aigent-os · 23 stars · license MIT · pushed 2026-10-23 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_3xh4xmcgnjzlv5fg
GET https://markdownregistry.com/api/v1/resolve?ref=wrg32786/aigent-os/Diagnose
GET https://markdownregistry.com/api/v1/blob/63b57798e2d26395d187b6d6d1c80b6e64f367e85ab1b8f6e3f9f0351c02ed9d

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 wrg32786/aigent-os

CLAUDE.md CLAUDE.md file
wrg32786/aigent-os · CLAUDE.md
git:20260730.ebbe603 · audit A · 23 stars
agent-fitness SKILL.md skill
wrg32786/aigent-os · skills/agent-fitness/SKILL.md · Track and surface sub-agent dispatch calibration ratios. Extract from JSONL transcript or read existing ledger…
git:20260707.2a2e857 · audit A · 23 stars
body-check SKILL.md skill
wrg32786/aigent-os · skills/body-check/SKILL.md · Compose the AIgent's body state by reading existing signals. Lazy compute. Never polled. Reports the five pressures +…
git:20260707.2a2e857 · audit A · 23 stars
brief SKILL.md skill
wrg32786/aigent-os · skills/brief/SKILL.md · Generate a structured delegation brief for any task
git:20260707.2a2e857 · audit A · 23 stars
Caddy Audit SKILL.md skill
wrg32786/aigent-os · skills/caddy-audit/SKILL.md · Quarterly skill that walks the skill-index against the actual SKILL.md files on disk, reports drift (skills indexed…
git:20260707.2a2e857 · audit A · 23 stars
caddy-enroll SKILL.md skill
wrg32786/aigent-os · skills/caddy-enroll/SKILL.md · Enroll a skill into Caddy's index so it can be surfaced when the right prompt arrives. Use when a new skill is created…
git:20260707.2a2e857 · audit A · 23 stars
Caddy Explain SKILL.md skill
wrg32786/aigent-os · skills/caddy-explain/SKILL.md · When a [CADDY] hint fires and the principal is confused why, /caddy-explain walks the scoring transparently — which…
git:20260707.2a2e857 · audit A · 23 stars
caddy-mute SKILL.md skill
wrg32786/aigent-os · skills/caddy-mute/SKILL.md · Mute a Caddy hint class for a window. Defaults to 4h auto-expiry. Classes — memory, context, body, routing, all.
git:20260719.404ad2a · audit A · 23 stars
capsule-compact SKILL.md skill
wrg32786/aigent-os · skills/capsule-compact/SKILL.md · Compact a long capsule chain. Walks parent_capsule_id backward from a head capsule; if chain >= 5, summarizes oldest 3…
git:20260707.2a2e857 · audit A · 23 stars
close SKILL.md skill
wrg32786/aigent-os · skills/close/SKILL.md · Commit the session to durable vault memory and prepare a clean resume point
git:20260726.7992efa · audit A · 23 stars
codex-adapter SKILL.md skill
wrg32786/aigent-os · skills/codex-adapter/SKILL.md · Route ONE bounded, mechanical task to the Codex CLI as a non-Claude executor, under the same review-before-merge gate…
git:20260724.c1e7aa7 · audit A · 23 stars
cognitive-update SKILL.md skill
wrg32786/aigent-os · skills/cognitive-update/SKILL.md · Conservative close-parity updates to GOAL_STACK, BELIEF_STATE, SELF_MODEL, and PROCEDURES. Writes only explicit or…
git:20260726.7992efa · audit A · 23 stars

Every file in wrg32786/aigent-os

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