diagnose SKILL.md skillA

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

Install it, pinned
mdr add kerberosclaw/kc_ai_skills/diagnose@v0.3.0

Pins v0.3.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kerberosclaw/kc_ai_skills
Path
diagnose/SKILL.md
Versions recorded
3
Latest version
v0.3.0, committed Jul 30, 2026
First version recorded
Jul 14, 2026
Size
7,182 bytes
Repository stars
79
License
MIT

Use when the user reports misbehaving software to investigate — a bug, crash, wrong output, flaky behavior, or '為什麼壞掉/不會動/查一下' — and the root cause is not yet established. Enforces building a red-capable reproduction command BEFORE any hypothesis is allowed, then 3-5 ranked falsifiable hypotheses before testing any single one. NOT for conceptual questions, code reading requests, or feature work. When a failing command already exists, Step 1 is pre-satisfied — still apply, jumping straight to…

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 — 先架測謊機,再准審問

You are a disciplined debugger. 你最大的敵人不是 bug,是**自己的過早結論**:讀兩眼 code 就宣稱「找到原因了」,修下去症狀還在、信用先沒了。本 skill 的核心只有一件事——**Step 1 的 feedback loop 才是全部,其餘都是機械動作**。

## Step 0: 適用判定

| 情境 | 套不套 |
|---|---|
| 行為異常(錯輸出 / crash / 時好時壞 / 效能劣化)且原因未明 | ✅ 套 |
| 已有一條會 fail 的指令(失敗測試 / 可重現的 curl) | ✅ 套,既有指令當**候選 loop**——過一遍 Step 1 五條判準(常已滿足)再進 Step 3,必要時回 Step 2 最小化 |
| 純概念問題、讀 code 導覽、新功能需求 | ❌ 不套 |
| 原因已確立、只是要修 | ❌ 不套,直接修 |

## Step 1: 建 red-capable feedback loop(本 skill 的全部)

**CRITICAL — 停止句:這條指令存在之前,禁止讀 code 建理論、禁止提任何 root cause。** 發現自己在沒有重現指令的狀態下開始「應該是因為…」——停,回來先建 loop。

### 完成判準(五條全過才算有 loop)

- [ ] 一條**實際跑過至少一次**的指令(把指令和輸出貼出來,不是「應該可以這樣測」)
- [ ] **Red-capable**:它斷言的是 user 講的那個症狀(錯值、crash、缺資料),**不是「沒噴錯」**
- [ ] 確定性:重跑結果一致(非決定性 bug → 目標改成**拉高重現率**——50% 可以 debug、1% 不行)
- [ ] 秒級完成(分鐘級的 loop 會讓你懶得跑、開始用猜的)
- [ ] 可無人執行(不需要 user 幫忙點畫面)

### Loop 手法選擇

| 情境 | 手法 |
|---|---|
| 有測試框架 | 寫一個 failing test |
| HTTP 服務 | curl + 斷言輸出(grep / jq) |
| CLI / script | 固定 fixture 輸入重跑 |
| 只在特定資料上壞 | 把那筆資料抽成最小 fixture |
| 版本回歸 | `git bisect` + 上面任一手法當判準 |
| 效能問題 | **不用 log**,先量基準數字,再二分定位 |
| 真的建不出來 | 最後手段:明講建不出、列出試過什麼、向 user 要環境 / log dump / 錄影——**不准在沒有 loop 的情況下開始猜** |

## Step 2: 最小化重現
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kerberosclaw/kc_ai_skills/diagnose@sha256:053c4a8eb26dd4e8

The line at the top of this page pins the label v0.3.0, 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_rl23s3a2okulpcqq.svg)](https://markdownregistry.com/a/art_rl23s3a2okulpcqq)

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

Versions

The registry has recorded 3 versions of this file, between Jul 14, 2026 and Jul 30, 2026, about one every 8 days.

versioncommittedcommitsizeaudit
v0.3.0 latest2026-07-30 d4fda1a 7,182 BA view · diff
v0.2.02026-07-30 880b677 6,743 BA view · diff
v0.1.02026-07-14 3afcf61 6,240 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 (7182 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

kerberosclaw/kc_ai_skills · 79 stars · license MIT · pushed 2026-10-16 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_rl23s3a2okulpcqq
GET https://markdownregistry.com/api/v1/resolve?ref=kerberosclaw/kc_ai_skills/diagnose
GET https://markdownregistry.com/api/v1/blob/053c4a8eb26dd4e886e988340d0b677a8ac8798f5687569f3ffadf030711a241

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 kerberosclaw/kc_ai_skills

adr SKILL.md skill
kerberosclaw/kc_ai_skills · adr/SKILL.md · Use when a durable technical decision was just made in conversation and should be recorded, or when user asks to…
v0.3.1 · audit A · 79 stars
align SKILL.md skill
kerberosclaw/kc_ai_skills · align/SKILL.md · Reconcile existing repository documentation with the current implementation, especially after verified hotfixes or…
v0.4.0 · audit A · 79 stars
character-lora SKILL.md skill
kerberosclaw/kc_ai_skills · character-lora/SKILL.md · Use when the user wants to build a consistent-identity LoRA for an original character — defining the character…
v0.2.1 · audit A · 79 stars
conference-report SKILL.md skill
kerberosclaw/kc_ai_skills · conference-report/SKILL.md · Use when the user attended one or more sessions of a conference (with audio recordings + slide photos) and needs help…
v0.2.0 · audit A · 79 stars
ctf-kit SKILL.md skill
kerberosclaw/kc_ai_skills · ctf-kit/SKILL.md · Use when the user is solving an authorized CTF / lab reverse-engineering challenge focused on Windows application…
v0.5.0 · audit A · 79 stars
goal-engineer SKILL.md skill
kerberosclaw/kc_ai_skills · goal-engineer/SKILL.md · Author a self-contained unattended dispatch for a generate-and-select loop (generate candidates, grade, iterate, keep…
v1.3.2 · audit A · 79 stars
DESIGN.md@goal-engineer/docs DESIGN.md file
kerberosclaw/kc_ai_skills · goal-engineer/docs/DESIGN.md
git:20261015.be10792 · audit A · 79 stars
gpt-image-gen SKILL.md skill
kerberosclaw/kc_ai_skills · gpt-image-gen/SKILL.md · Use when the user asks to generate OR edit an image via GPT/Codex (e.g. 「叫 gpt 生圖」「幫我用 gpt 生圖」「gpt 畫一個…
v0.6.0 · audit A · 79 stars
grill SKILL.md skill
kerberosclaw/kc_ai_skills · grill/SKILL.md · Use when the user says 先討論 / wants to align on a fuzzy idea before building, or before any non-trivial implementation…
v0.1.0 · audit A · 79 stars
ios-resign SKILL.md skill
kerberosclaw/kc_ai_skills · ios-resign/SKILL.md · Use when the user wants to rebuild, re-sign and reinstall one of their own iOS apps onto their iPhone(s) — typically…
v0.1.1 · audit A · 79 stars
job-scout SKILL.md skill
kerberosclaw/kc_ai_skills · job-scout/SKILL.md · Use when the user is considering applying to, interviewing with, or accepting an offer from a company and wants due…
v1.1.0 · audit A · 79 stars
llm-benchmark SKILL.md skill
kerberosclaw/kc_ai_skills · llm-benchmark/SKILL.md · Use when the user wants to test, compare, or choose local Ollama models for their machine. Checks Ollama/GPU state…
v1.1.0 · audit B · 79 stars

Every file in kerberosclaw/kc_ai_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
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
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
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
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
diagnose SKILL.md skill
rustyrazorblade/skills · plugins/cassandra-expert/skills/diagnose/SKILL.md · Systematic troubleshooting for Apache Cassandra clusters. Use when diagnosing performance issues, latency problems…
git:20260407.324e497 · audit A · 44 stars

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