Content
86%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.
An excellent action-oriented skill body: runnable code for every supported path, explicit pipeline ordering with sibling hand-offs, and honest error-mode documentation. The only trims available are the duplicated submodule-import and PDF/DOCX statements between the main sections and the gotchas list; validation checkpoints exist but are listed as gotchas rather than integrated steps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes competence — no primer on what OCR or C-CDA is, every section carries OpenMed-specific facts ("ocr() lives in the submodule (it is intentionally not re-exported)", "PDF and DOCX have no live handler yet"). It is not a 5 because two facts are stated twice: the submodule import and the PDF/DOCX UnsupportedDocumentError both appear in their main sections and again verbatim in "Edge cases & gotchas", which could be trimmed. | 4 / 5 |
Actionability | All code is copy-paste ready with real imports ("from openmed.multimodal.ocr import ocr", "from openmed.multimodal import redact_document"), executable calls, and expected outputs ("doc.text", "doc.spans[:3]", "redacted.manifest"). Install commands are exact ("pip install \"openmed[multimodal]\"", "pip install \"openmed[ocr-paddle]\"") and the common cases — image OCR, one-step redact_document, CSV redaction, offset-to-bbox mapping — each get a runnable example. Not a 4: no example is pseudocode and none is missing key details. | 5 / 5 |
Workflow Clarity | The sequence is explicit and well-ordered — "This is the **first** stage. After intake, hand off to deidentifying-clinical-text then extracting-clinical-entities", plus a numbered two-step quick start and a clear one-step vs two-step decision rule ("Use redact_document when you want OpenMed to own intake **and** redaction"). Checkpoints exist ("inspect OcrWord.confidence to flag low-quality pages", "MissingDependencyError with an install hint", run NER on the **redacted** text) but they live in a gotchas list rather than being woven into the pipeline steps, which fits anchor 4 ("most checkpoints present; minor validation gaps") better than 5. | 4 / 5 |
Progressive Disclosure | SKILL.md is a true overview: the full data contract, engine list, and tabular pipeline are split into references/multimodal-ingest.md (verified to exist), which is one level deep and clearly signaled at three points ("See [references/multimodal-ingest.md] ... for the full contract, engines, and the tabular pipeline"). Sections are well-organized (when to use, install, quick start, per-format sections, hand-off, gotchas), matching the anchor-5 pattern of a concise overview with well-signaled single-depth references. Not a 4: there are no organization gaps or inline content that belongs in the reference file. | 5 / 5 |
Total | 18 / 20 Passed |