Content
90%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, highly actionable body: executable quick-start code for both intake paths, a concrete six-step workflow, and genuinely non-obvious gotchas (range mis-splitting, unit/range separation, PHI in header columns) with no padding. The only gaps are the absence of an explicit validation feedback loop in the workflow and a single-file layout that is slightly long for a SKILL.md overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly every sentence carries OpenMed-specific knowledge Claude cannot already know: API signatures ("ocr(image, engine=...) → an OcrResult whose .words are OcrWord(text, bbox, confidence, page)"), return types, install extras, and real gotchas. It never explains what a PDF or a lab panel is in the abstract, contains no filler or library comparisons, and has no time-sensitive dates or versions, matching the lean score-5 anchor. | 5 / 5 |
Actionability | The Quick start is copy-paste executable and covers both intake paths (image OCR and CSV/TSV with classify_columns/redact_table) against the real imports, and the Workflow gives six concrete steps including exact failure modes ("PDF/DOCX raise UnsupportedDocumentError", "ocr() raises ... MissingDependencyError"). This matches the score-5 anchor of fully executable guidance covering the common cases. | 5 / 5 |
Workflow Clarity | The six-step Workflow is clearly sequenced with per-step detail, and confidence gating ("Confidence (OcrWord.confidence) flags shaky cells for review", plus the low-confidence edge case routing to human review) provides a checkpoint. It stops short of 5 because there is no explicit validate → fix → retry feedback loop in the workflow itself — e.g., a step that re-clusters or re-checks the reconstructed grid against the header when alignment fails — leaving validation implicit rather than a structured checkpoint. | 4 / 5 |
Progressive Disclosure | The body is a single well-organized file with clear sections, and all pointers (parsing-lab-values, mapping-loinc, exporting-to-fhir, deidentifying-clinical-text, and the standards URLs) are one level deep and clearly signaled in dedicated sections; no bundle files exist to offload to, and none are referenced as if they existed. It does not reach 5 because at ~140 lines the Edge cases & gotchas and Hand-off sections carry detail that a references file could hold, and the simple-skill exception (under 50 lines) does not apply. | 4 / 5 |
Total | 18 / 20 Passed |