diagnose SKILL.md skillA

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

Install it, pinned
mdr add xopcai/xopc/diagnose@git:20260916.b7327d9

Pins git:20260916.b7327d9 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
xopcai/xopc
Path
skills/engineering/diagnose/SKILL.md
Versions recorded
3
Latest version
git:20260916.b7327d9, committed Sep 16, 2026
First version recorded
May 10, 2026
Size
7,363 bytes
Repository stars
40
License
MIT

Disciplined reproduce → minimise → hypothesise → instrument → fix loop for hard bugs and performance regressions.

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

A discipline for hard bugs. Skip phases only when explicitly justified.

When exploring the codebase, use the project's domain glossary to get a clear mental model of the relevant modules, and check ADRs in the area you're touching.

## Phase 1 — Build a feedback loop

**This is the skill.** Everything else is mechanical. If you have a fast, deterministic, agent-runnable pass/fail signal for the bug, you will find the cause — bisection, hypothesis-testing, and instrumentation all just consume that signal. If you don't have one, no amount of staring at code will save you.

Spend disproportionate effort here. **Be aggressive. Be creative. Refuse to give up.**

### Ways to construct one — try them in roughly this order

1. **Failing test** at whatever seam reaches the bug — unit, integration, e2e.
2. **Curl / HTTP script** against a running dev server.
3. **CLI invocation** with a fixture input, diffing stdout against a known-good snapshot.
4. **Headless browser script** (Playwright / Puppeteer) — drives the UI, asserts on DOM/console/network.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add xopcai/xopc/diagnose@sha256:786d45a95d5b939f

The line at the top of this page pins the label git:20260916.b7327d9, 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_yso2xajodarvdlpe.svg)](https://markdownregistry.com/a/art_yso2xajodarvdlpe)

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

Versions

The registry has recorded 3 versions of this file, between May 10, 2026 and Sep 16, 2026, about one every 65 days.

versioncommittedcommitsizeaudit
git:20260916.b7327d9 latest2026-09-16 b7327d9 7,363 BA view · diff
git:20260618.8ea2a182026-06-18 8ea2a18 7,004 BA view · diff
git:20260510.b4830d52026-05-10 b4830d5 7,163 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 (7363 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

xopcai/xopc · 40 stars · license MIT · pushed 2026-11-04 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_yso2xajodarvdlpe
GET https://markdownregistry.com/api/v1/resolve?ref=xopcai/xopc/diagnose
GET https://markdownregistry.com/api/v1/blob/786d45a95d5b939f5a37df8e69d30db8414c84af7e1cac1657526f5131eae817

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 xopcai/xopc

CLAUDE.md@.claude CLAUDE.md file
xopcai/xopc · .claude/CLAUDE.md
git:20261005.7ae6c39 · audit A · 40 stars
deveco-flow Cursor rule
xopcai/xopc · .cursor/rules/deveco-flow.mdc · Multi-platform development routing rules (HarmonyOS/Android/iOS)
git:20260917.28f6271 · audit A · 40 stars
AGENTS.md AGENTS.md file
xopcai/xopc · AGENTS.md
git:20261101.cf63000 · audit A · 40 stars
DESIGN.md DESIGN.md file
xopcai/xopc · DESIGN.md
git:20260827.9fbb3b2 · audit A · 40 stars
AGENTS.md@docs/reference/templates AGENTS.md file
xopcai/xopc · docs/reference/templates/AGENTS.md
git:20261007.fd5738d · audit A · 40 stars
AGENTS.md@docs/zh/reference/templates AGENTS.md file
xopcai/xopc · docs/zh/reference/templates/AGENTS.md
git:20260827.c29236a · audit A · 40 stars
AGENTS.md@evals/coder/suites/coding-core/fixture AGENTS.md file
xopcai/xopc · evals/coder/suites/coding-core/fixture/AGENTS.md
git:20260906.bd4f558 · audit B · 40 stars
AGENTS.md@evals/coder/suites/coding-core/fixture/src AGENTS.md file
xopcai/xopc · evals/coder/suites/coding-core/fixture/src/AGENTS.md
git:20260906.bd4f558 · audit B · 40 stars
chat-charts SKILL.md skill
xopcai/xopc · skills/creative/chat-charts/SKILL.md · Add an inline line or bar chart to an xopc chat response when comparing numerical trends or categories helps the user…
git:20261017.91622d3 · audit A · 40 stars
frontend-design SKILL.md skill
xopcai/xopc · skills/creative/frontend-design/SKILL.md · Create distinctive, production-grade frontend interfaces, pages, components, dashboards, and HTML/CSS layouts.
git:20260916.b7327d9 · audit A · 40 stars
hatch-pet SKILL.md skill
xopcai/xopc · skills/creative/hatch-pet/SKILL.md · Create and install a custom animated xopc desktop pet from a user description.
git:20260916.b7327d9 · audit A · 40 stars
theme-factory SKILL.md skill
xopcai/xopc · skills/creative/theme-factory/SKILL.md · Apply or generate cohesive color and font themes for artifacts, slides, documents, reports, and landing pages.
git:20260916.b7327d9 · audit A · 40 stars

Every file in xopcai/xopc

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,941 stars
diagnose SKILL.md skill
pedrohcgs/claude-code-my-workflow · .agents/skills/diagnose/SKILL.md · Root-cause a failing or wrong empirical result with a disciplined reproduce → minimise → hypothesise → instrument → fix…
git:20261106.a8c8716 · audit A · 1,686 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,686 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 · 69 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 · 50 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 · 48 stars

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