diagnose SKILL.md skillA

diagnose from timharris707/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add timharris707/skills/diagnose@git:20261008.0b04f1c

Pins git:20261008.0b04f1c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
timharris707/skills
Path
plugins/clickai-codex/skills/run/diagnose/SKILL.md
Versions recorded
4
Latest version
git:20261008.0b04f1c, committed Oct 8, 2026
First version recorded
Sep 5, 2026
Size
8,804 bytes
Repository stars
44
License
MIT

For a bug-fix brief, a bug resisting its first fix, or a fix about to ship without a proven cause, reproduce the failure, state its cause with evidence, and keep a regression check before shipping.

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

Read the [Codex desktop binding](../../../CODEX.md) when this workflow needs harness mechanics, model routing, or recovery.

A fix may not ship without a **named cause**: one plain sentence stating what was wrong, backed by evidence, readable by a non-engineer decider. This skill is the discipline a working lane follows inline when fixing bugs. It is not a lane type of its own, and it deliberately has no binding slots: everything repo-specific already arrived in the lane's brief.

**The named-cause test is the trigger, and it binds on every fix.** If you can already state the cause in one sentence and point at the evidence, the loop is satisfied: ship. If you cannot, the loop runs, however small the bug looks. "Hard bugs only" is the wrong gate, because the first fix attempt is where the vibes-fix ships: a change that makes the symptom go away for reasons nobody can state.

## The loop

Six steps, in order. A failed fix re-enters at the step whose output it disproved, usually the hypothesis list, sometimes the repro itself.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add timharris707/skills/diagnose@sha256:69c335361692655f

The line at the top of this page pins the label git:20261008.0b04f1c, 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_tpqkbkqldsqojz6c.svg)](https://markdownregistry.com/a/art_tpqkbkqldsqojz6c)

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

Versions

The registry has recorded 4 versions of this file, between Sep 5, 2026 and Oct 8, 2026, about one every 11 days.

versioncommittedcommitsizeaudit
git:20261008.0b04f1c latest2026-10-08 0b04f1c 8,804 BA view · diff
git:20261006.1b01c5f2026-10-06 1b01c5f 8,728 BA view · diff
git:20260906.a9317e02026-09-06 a9317e0 8,114 BA view · diff
git:20260905.b0748d82026-09-05 b0748d8 8,016 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 (8804 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

timharris707/skills · 44 stars · license MIT · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_tpqkbkqldsqojz6c
GET https://markdownregistry.com/api/v1/resolve?ref=timharris707/skills/diagnose
GET https://markdownregistry.com/api/v1/blob/69c335361692655f95061e2b70e38622ee884d448761a91ba8a6060192d1a4dc

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 timharris707/skills

CLAUDE.md CLAUDE.md file
timharris707/skills · CLAUDE.md
git:20260906.c7e0ad4 · audit A · 44 stars
ingest SKILL.md skill
timharris707/skills · editions/codex/overrides/skills/investigate/ingest/SKILL.md · For a media file or URL shared with a goal, transcription requests, or takeaways from a call, demo, playtest, or video…
git:20260906.a9317e0 · audit A · 44 stars
huh SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/author/huh/SKILL.md · When a message did not land or pasted agent output needs translation, restate it plainly, expand shorthand, separate…
git:20260906.a9317e0 · audit A · 44 stars
plainspoken SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/author/plainspoken/SKILL.md · For chat replies, status updates, review comments, and commit messages, write plainly without AI tells. Also use to…
git:20260906.a9317e0 · audit A · 44 stars
writing-for-agents SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/author/writing-for-agents/SKILL.md · For skills, standing agent instructions, recorded rules, or documents agents skip, write and prune reliable triggers…
git:20261008.0b04f1c · audit A · 44 stars
writing-for-humans SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/author/writing-for-humans/SKILL.md · For public-facing drafts, pages that read like agent documentation, or a final AI-tell scrub, write clear human copy in…
git:20260906.a9317e0 · audit A · 44 stars
advisory-board SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/decide/advisory-board/SKILL.md · For an explicitly requested advisory board, roundtable, panel, idea tournament, multi-model review or debate, red-team…
git:20260906.a9317e0 · audit B · 44 stars
decision-map SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/decide/decision-map/SKILL.md · When asked to chart a decision map, work a map ticket, or plan work whose open decisions gate each other, map the…
git:20261009.3cdacee · audit A · 44 stars
grilling SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/decide/grilling/SKILL.md · When asked to grill, stress-test, or pressure-test an idea, or before a decision map or spec rests on an untested…
git:20261008.0b04f1c · audit A · 44 stars
codebase-review SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/investigate/codebase-review/SKILL.md · Before an upcoming feature, when merged work crosses the recorded review threshold, or when implementation exposes…
git:20261008.0b04f1c · audit A · 44 stars
ingest SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/investigate/ingest/SKILL.md · For a media file or URL shared with a goal, transcription requests, or takeaways from a call, demo, playtest, or video…
git:20260906.a9317e0 · audit A · 44 stars
prototype SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/investigate/prototype/SKILL.md · When discussion or static mockups cannot settle how something should look, behave, or feel, build a disposable…
git:20260906.a9317e0 · audit A · 44 stars

Every file in timharris707/skills

Other files named diagnose

diagnose SKILL.md skill
github/awesome-copilot · skills/diagnose/SKILL.md · Perform a systematic diagnostic scan of an AI workflow across 5 quality dimensions — prompt quality, context…
git:20260506.7f59e01 · audit A · 40,226 stars
diagnose SKILL.md skill
pedrohcgs/claude-code-my-workflow · .claude/skills/diagnose/SKILL.md · Root-cause a failing or wrong empirical result with a disciplined reproduce → minimise → hypothesise → instrument → fix…
git:20260927.6535de7 · audit A · 1,666 stars
diagnose SKILL.md skill
kerberosclaw/kc_ai_skills · diagnose/SKILL.md · Use when the user reports misbehaving software to investigate — a bug, crash, wrong output, flaky behavior, or…
v0.3.0 · audit A · 79 stars
diagnose SKILL.md skill
skillberry-ai/cap-evolve · skills/phases/diagnose/SKILL.md · Extract the learning signal from execution traces — the textual analogue of a gradient. Use between evaluation and…
git:20261010.2b56481 · audit A · 66 stars
diagnose SKILL.md skill
tserentserenov/fmt-exocortex-template · .claude/skills/diagnose/SKILL.md · Диагностика ступени мастерства (Диагност R28, FORM.089 §6.1 v5.0) прямо в VS Code / claude.ai. До 6 вопросов, ~3 мин…
v5.0.0 · audit A · 63 stars
diagnose SKILL.md skill
mycelium-hq/ai-brain-starter · skills/diagnose/SKILL.md · Use when an AI Brain vault needs a health check or something feels off: Claude ignores CLAUDE.md, journal entries…
git:20260816.6ac8364 · audit A · 47 stars
diagnose SKILL.md skill
anantys-oss/koan · koan/skills/core/diagnose/SKILL.md · Analyze the last mission failure and queue a fix attempt
v1.0.0 · audit A · 47 stars
diagnose SKILL.md skill
timharris707/skills · skills/run/diagnose/SKILL.md · The disciplined bug-fixing loop: no fix ships without a cause the fixer can state in one plain sentence, with evidence…
git:20261008.0b04f1c · audit A · 44 stars

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