Content
82%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 highly actionable, well-structured skill: the index-then-infer workflow is concrete and executable in both CLI and Python forms, with a genuine gotchas section covering failure modes. The main improvement levers are trimming the duplicated install/deps caveats and folding index validation into the workflow steps themselves.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence — OpenMed-specific facts (index resolution, extras, checkpoint families) dominate and no space is spent on what NER or pip are. Minor redundancy keeps it from anchor 5: the '`zero deps` does not install' caveat appears in both the Install section and Edge cases, and the accuracy-vs-fine-tuned tradeoff is repeated in 'When to use' and gotchas. | 4 / 5 |
Actionability | Everything is executable and copy-paste ready: real `openmed zero index` / `zero infer` invocations with flags and a realistic clinical sentence, a complete `NerRequest` + `infer(...)` Python example with the response shape enumerated, and index-build plus label-utility snippets. It is not 4 because the examples cover the common cases end-to-end with no gaps. | 5 / 5 |
Workflow Clarity | The two-step flow is explicitly numbered ('1. openmed zero index <models_dir> ... 2. openmed zero infer ...') and `openmed zero deps` serves as a dependency checkpoint, with threshold tuning as a recall/precision feedback loop. It falls short of anchor 5 because the key validation — confirming `--model-id` exists in the index before infer — is relegated to the gotchas list rather than being an explicit step with a recovery loop in the sequence itself. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), so all guidance is inline; the body is well-sectioned with clear headers and every section earns its place. At ~150 lines with the Python API field listing and label utilities inlined, some material could be split into a reference file, which is the minor organization gap that holds it at anchor 4 rather than 5. | 4 / 5 |
Total | 17 / 20 Passed |