diagnose is agent-read markdown (skill) from codybrom/clairvoyance: Routes a vague symptom or complaint to the most relevant Clairvoyance skill via a decision tree. Use when someone describes a problem but doesn't know which skill to reach for. Not for a comprehensive review (use design-review) or a checklist scan (use red-flags)..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# Diagnose
When invoked with $ARGUMENTS, match the described symptom against the decision tree below and route to the appropriate skill. If code paths are referenced, read them first to confirm the match before routing. This skill routes to other skills from Clairvoyance (https://clairvoyance.fyi). It works best when the full collection is installed.
## Decision Tree
### 1. "Something feels wrong but I can't say what"
The symptom is a general sense of unease with no concrete complaint.
→ **complexity-recognition**: Apply the three-symptom framework to locate the source.
### 2. "Simple changes require edits in many files"
Change amplification. Branch by cause:
- Shared knowledge is scattered across modules → **information-hiding** (look for leaked implementation details)
- Old abstractions no longer fit the current shape of the system → **code-evolution** (check whether the design has kept pace with requirements)
- Module boundaries cut across concerns instead of encapsulating them → **module-boundaries** (re-evaluate decomposition)
### 3. "This interface is awkward / too many parameters"
…
Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
GET https://markdownregistry.com/api/v1/artifacts/art_hechdqjbyielos3g
GET https://markdownregistry.com/api/v1/resolve?ref=codybrom/clairvoyance/diagnose
GET https://markdownregistry.com/api/v1/blob/e4d3523e98c51564ef978b2b5cc4bdeae4504ad9d3581a4476c3fe208f410d1b
Your agent 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.
codybrom/clairvoyance · skills/abstraction-quality/SKILL.md · Evaluates whether abstractions provide a genuinely different way of thinking or are structurally shallow. Use when…
codybrom/clairvoyance · skills/code-evolution/SKILL.md · Evaluates whether changes to existing code maintain or degrade design quality. Use when the user asks to review a diff…
codybrom/clairvoyance · skills/comments-docs/SKILL.md · Reviews comment quality and documentation practices: the four comment types, comments-first workflow, and comment rot…
codybrom/clairvoyance · skills/complexity-recognition/SKILL.md · Diagnoses whether complexity exists and where it comes from, using the three-symptom, two-root-cause framework. Use…
codybrom/clairvoyance · skills/deep-modules/SKILL.md · Measures module depth: whether the interface is simple relative to the implementation behind it. Use when an interface…
codybrom/clairvoyance · skills/design-it-twice/SKILL.md · Generates and compares at least two fundamentally different design alternatives on concrete criteria before committing…
codybrom/clairvoyance · skills/design-review/SKILL.md · Orchestrates a structured design review, running the other skills as a diagnostic funnel from complexity triage to a…
codybrom/clairvoyance · skills/error-design/SKILL.md · Reviews error handling and exception design, applying the "define errors out of existence" principle. Use when…
codybrom/clairvoyance · skills/information-hiding/SKILL.md · Checks for information leakage across module boundaries, including temporal decomposition and false encapsulation. Use…
codybrom/clairvoyance · skills/module-boundaries/SKILL.md · Evaluates where module boundaries are drawn and whether modules should be merged or split. Use when deciding whether to…
codybrom/clairvoyance · skills/naming-obviousness/SKILL.md · Reviews naming quality and code obviousness via the isolation test, scope-length principle, and consistency audit. Use…
github/awesome-copilot · skills/diagnose/SKILL.md · Perform a systematic diagnostic scan of an AI workflow across 5 quality dimensions — prompt quality, context…
terrylica/cc-skills · plugins/floating-clock/skills/diagnose/SKILL.md · Print a compact health report for FloatingClock. Covers binary info, code-sign status, running process, and test-suite…
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…
toongri/oh-my-toong-playground · skills/diagnose/SKILL.md · Use when asked to analyze architecture, debug issues, identify root cause, or provide technical recommendations…
