ask-openmed
GitHubOpenMed工作流智能路由技能,根据用户意图将请求分发至采集、隐私脱敏、提取等下游模块。通过确定性规则匹配关键词,确保临床数据在处理前经过隐私网关,实现标准化流程引导。
Trigger Scenarios
Install
npx skills add maziyarpanahi/openmed --skill ask-openmed -g -y
SKILL.md
Frontmatter
{
"name": "ask-openmed",
"license": "Apache-2.0",
"metadata": {
"pairs": "adjacent",
"project": "OpenMed",
"version": "1.0",
"category": "openmed-core"
},
"description": "Choose the first OpenMed workflow skill for an intake, privacy, extraction, exchange, or verification request using deterministic local routing. Use when a goal is broad, spans several clinical-data stages, or leaves the data-sensitivity status unclear; the privacy gate is selected before downstream work when raw clinical or personal content may be present."
}
Ask OpenMed
Use this skill as the first pass when a request does not name a focused OpenMed workflow. It selects an existing skill identifier; it does not process input, download a model, call a service, or make a clinical decision. No mandatory network call is part of this route.
Deterministic routing contract
Apply these rules in order:
- Normalize only the stated goal: lowercase it, trim surrounding whitespace, and collapse repeated whitespace. Do not inspect or copy the data payload.
- Apply the intake boundary. If the goal matches an Intake row, select the first matching intake skill even when the goal also names a later stage. If sensitivity is unclear, its next handoff is the privacy gate: deidentifying-clinical-text, before extraction, exchange, or verification sees the parsed content.
- For a goal with no intake cue, apply the privacy override. If it asks to
analyze, extract, exchange, share, upload, or verify clinical or personal
content and is not explicitly marked safe, start at the privacy gate. The
only safe markers are
synthetic input,synthetic note,synthetic record,synthetic dataset,input is synthetic,data is synthetic,already de-identified, andalready deidentified. A marker does not count whenno,not,never,unknown, oruncertainoccurs in the four normalized words before it. Treat every ambiguous safety statement as sensitive. - Otherwise inspect the remaining tables in the fixed handoff order shown below. Treat each comma-separated cue as a case-insensitive substring of the normalized goal, and select the first matching row. Every cue cell is a comma-separated list of alternatives; conjunctions have no special meaning. Do not add synonyms or infer cues from the payload. This stage order and row order break every tie.
- If no row matches, use building-with-openmed as the orientation fallback.
Route output should contain only the selected category, skill identifier, matched rule index, and next handoff. Never echo the request, input values, exception text, or detected spans into a log or report.
For a multi-stage request, route one stage at a time in this fixed handoff order: intake → privacy → extraction → exchange → verification. A later stage does not bypass the privacy gate merely because it was named first.
Intake
Choose the first skill for turning an external document or record format into local, processable input.
| Goal cues | First skill | Continue with |
|---|---|---|
| laboratory table, lab table | extracting-lab-tables | privacy, then verification |
| scan, fax, image, PDF, CSV, table, document OCR | ingesting-clinical-documents | privacy, then extraction |
| C-CDA, CCD, CDA XML | parsing-ccda-documents | privacy, then extraction |
| HL7 v2, ADT, ORU, MDM, OBX, pipe-delimited feed | parsing-hl7v2-messages | privacy, then extraction |
| DICOM header, DICOM-SR metadata | extracting-dicom-metadata | privacy, then extraction |
| pull FHIR records, page FHIR records, FHIR server | fetching-fhir-resources | privacy, then extraction |
Privacy
Use the privacy table both for an explicit privacy goal and for the privacy override. The first row is the default gate for unspecified sensitive input.
| Goal cues | First skill | Continue with |
|---|---|---|
| remove clinical identifiers, mask clinical identifiers, redact clinical text, anonymize clinical text, de-identify clinical text | deidentifying-clinical-text | extraction or exchange |
| find identifiers, detect identifiers, PII entities | extracting-pii-entities | de-identification or review |
| privacy policy, privacy profile | configuring-privacy-policies | de-identification |
| PHI in logs, PHI in errors, PHI in telemetry, no-PHI logging | enforcing-nophi-logging | verification |
| de-identify non-English text, multilingual de-identification | deidentifying-multilingual-text | extraction |
| stable pseudonyms, approved linkage pseudonyms | pseudonymizing-for-gdpr | verification |
Extraction
Choose the focused skill after intake and privacy handling when the request is about finding or structuring clinical meaning.
| Goal cues | First skill | Continue with |
|---|---|---|
| diseases, drugs, anatomy, genes, clinical NER | extracting-clinical-entities | exchange or verification |
| custom entity labels, zero-shot extraction | running-zeroshot-ner | exchange or verification |
| housing, food, work, transport, SDOH | extracting-sdoh | verification |
| lab values, units, reference ranges, abnormal flags | parsing-lab-values | terminology or exchange |
| radiology findings, radiology measurements, radiology impression | structuring-radiology-reports | exchange or verification |
| note sections, clinical sections, section segmentation | segmenting-clinical-sections | extraction |
Exchange
Choose an exchange skill only after the source is safe to handle. These skills may use a user-supplied endpoint or terminology service; this router itself performs no network call.
| Goal cues | First skill | Continue with |
|---|---|---|
| FHIR R4 resources, export to FHIR | exporting-to-fhir | bundle or conformance verification |
| FHIR transaction Bundle, FHIR batch Bundle | assembling-fhir-bundles | conformance verification |
| FHIR Bulk Data export, bulk FHIR | exporting-bulk-fhir | privacy, then extraction |
| SMART-on-FHIR app, SMART-on-FHIR launch | scaffolding-smart-on-fhir | conformance verification |
| terminology validation, terminology expansion, terminology translation, terminology server | querying-terminology-service | exchange or verification |
Verification
Use verification routes for a stated release, safety, leakage, audit, risk, or conformance check. If the source is not explicitly safe, the privacy override still wins first.
| Goal cues | First skill | Decision or handoff |
|---|---|---|
| residual identifiers, de-identification leakage | auditing-deid-leakage | block release on a finding |
| de-identification audit trail, no-PHI audit trail | auditing-deidentification-runs | retain offsets, hashes, and provenance |
| leakage gate, release leakage | evaluating-with-leakage-gates | fail closed on leakage |
| re-identification risk, k-anonymity, quasi-identifiers | reviewing-reidentification-risk | review residual risk |
| Safe Harbor | auditing-safe-harbor-checklist | review the no-PHI report |
| FHIR US Core, USCDI conformance | validating-us-core | correct the resource before exchange |
| HIPAA privacy checklist, HIPAA security checklist | checking-hipaa-compliance | address gaps before release |
Ambiguous goals and escalation examples
Use the privacy override and the fixed handoff order for ambiguous requests:
- “Turn this clinical note into FHIR.” The sensitivity is unstated, so start at deidentifying-clinical-text, then hand off to extracting-clinical-entities and exporting-to-fhir.
- “Extract medications from a synthetic note.” The input is explicitly synthetic, so route directly to extracting-clinical-entities.
- “OCR this image and extract findings.” Route to ingesting-clinical-documents, then apply the privacy gate before extraction.
- “Is this dataset safe to share?” If de-identification is not stated, start with deidentifying-clinical-text and then use auditing-deid-leakage.
- “Verify this clinical dataset; it is not de-identified.” The negated safety statement does not count as a safe marker, so start at deidentifying-clinical-text.
- “Which OpenMed workflow fits?” Use the orientation fallback building-with-openmed, then re-route once the goal and sensitivity status are explicit.
These are routing examples only. Keep all demonstrations synthetic or placeholder-based, and keep route diagnostics free of source content.
Version History
- dd6d157 Current 2026-08-27 13:06


