From 47cd4d430a028d63dce6fb6d99308febbbdd92b9 Mon Sep 17 00:00:00 2001 From: Magnus Hedemark Date: Sat, 22 Aug 2026 23:14:30 -0400 Subject: [PATCH] chore(dsm5): add Available Scripts table and Prerequisites/Limitations 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/SKILL.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/dsm5/SKILL.md b/dsm5/SKILL.md index 028a530..0f2ac39 100644 --- a/dsm5/SKILL.md +++ b/dsm5/SKILL.md @@ -293,3 +293,24 @@ need. part ≤ ~40,000 characters; indexes ≤ ~10,000). If a tool reports a file as truncated, re-read it in chunks with an offset, or use `python3 scripts/lookup.py` to find the specific part file instead of reading a whole chapter. + +## Available Scripts + +This skill bundles one script; there are no others to discover. + +| Script | Purpose | Invocation | +|---|---|---| +| `scripts/lookup.py` | Searches this skill's `references/` library for a keyword or phrase and recommends the file(s) to read. Run it whenever the routing table does not obviously cover the condition, when locating a topic without knowing its chapter, or to find the specific part file of a split chapter instead of reading a whole one. | `python3 scripts/lookup.py ""` | + +Useful flags: `--json` (machine-readable output), `--list` (list every reference file with its H1 title), `--max N` (cap matches shown per file, default 10), `-q` (print only recommended file names). + +## Prerequisites + +- Python 3 with standard library only; `lookup.py` requires no third-party packages. +- Read access to this skill's `references/` directory — the script searches that local library and nothing else. + +## Limitations + +- The script searches only this skill's paraphrased reference library; it cannot verify wording against the official DSM-5-TR, and a "no match" result means the topic is not covered here, not that it does not exist. +- It performs keyword search and file recommendation only — no diagnosis, scoring, or clinical reasoning happens in the script. +- Output from the script does not change the citation rules above: cite codes, specifiers, and prevalence only from reference files you actually read, never from memory or from script summaries alone.