Magnus Hedemarkandfactory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
47cd4d430a
Document lookup.py in an Available Scripts table with invocation and run-when guidance tied to the routing workflow; add Prerequisites and Limitations reflecting the stdlib-only local-library search. Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
dsm5
An evidence-based companion to the DSM-5-TR for serious conversations about mental health and neurocognitive conditions.
Why Install This Skill
Mental health questions are everywhere, and most answers online are vibes, not criteria. This skill grounds those conversations in the real diagnostic framework of the DSM-5-TR (text revision) so that "could this be X?" becomes a structured comparison — symptoms weighed against actual criteria, with met, unmet, and unknown kept separate — instead of a guess. It was built from a copy of the DSM-5-TR text revision and organized as a searchable reference library, with safety handling and calibrated language built into every answer.
Who it is for: clinicians and practitioners double-checking criteria, specifiers, or differentials; patients and family members who want an evidence-based understanding of a condition and good questions to take to a provider; and anyone who needs to explain a mental health topic accurately and without stigma.
What it is not: it is not a diagnostic tool, it does not render "you have X" verdicts, it gives no treatment or medication advice, and it is not the manual itself. It is a paraphrased companion for orientation and education, and it always says so.
What You Get
| Item | What it provides |
|---|---|
SKILL.md |
The conversation workflow: safety triage first, question/audience clarification, reference routing, criteria comparison, differential reasoning, and calibrated communication. |
references/ (66 files) |
Chapter indexes plus part files: foundation (00–02), per-chapter references for all 22 DSM-5-TR diagnostic classes (10–31), Part III (32–33), and cross-cutting differentials (40). Large chapters are split into an index plus focused part files so any agent can read a file in one call. |
scripts/lookup.py |
A keyword search across every reference file — finds where a topic lives and which files to read first. |
evals/evals.json |
Output-quality test cases that keep the skill's answers honest across safety, criteria fidelity, and plain-language scenarios. |
Quick Start
No setup, no API keys, no dependencies. Two ways to use it:
-
Browse by chapter. Open
references/and pick the file for the condition in question (for example,13-depressive-disorders.mdfor depression). -
Search by keyword. Find where any topic lives:
python3 scripts/lookup.py 'insomnia'The script prints matching lines grouped by file and a short list of the best reference files to read. Add
--listto see every reference file with its one-line description, or--jsonfor machine-readable output.
Triggers
Load this skill when someone asks about:
- What a set of symptoms "could be" or whether a description matches a known condition.
- Diagnostic criteria, specifiers, or codes for a mental health condition.
- The difference between two conditions (for example, ADHD vs. anxiety, or delirium vs. dementia).
- How common a condition is, when it starts, or how it typically runs its course.
- A plain-language explanation of a diagnosis for a patient or family member.
- What questions to bring to a clinician or therapist.
Requirements
- Python 3 (standard library only) if you want to use
scripts/lookup.py. - The reference files, which ship with the skill — no downloads needed.
- For exact verbatim criteria, codes, and recording procedures, consult the official DSM-5-TR (the user's copy). This skill is a companion, not the authoritative text.
DSM-5-TR is © American Psychiatric Association (2022). This skill is an independent companion reference; it paraphrases and summarizes the manual for orientation and education and is not a substitute for the manual, for clinical training, or for professional evaluation. Always verify criteria and codes against the official DSM-5-TR before formal use.