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 well-structured, highly actionable skill body with executable CLI and Python examples and a clear two-step workflow supported by edge-case guidance. It is slightly verbose in places and, lacking any bundle files, keeps all content inline rather than splitting into one-level-deep references.
Suggestions
Tighten the opening paragraph and 'When to use' section to avoid restating the zero-shot concept already implied by the description, improving conciseness toward the 5 anchor.
Consider extracting the CLI flag reference and Python API field listings into a short reference file (e.g. references/api.md) to better realize progressive disclosure's one-level-deep pattern.
Add an explicit validate→retry note for the index step (e.g. re-run `openmed zero index` after adding checkpoints) to give the workflow a clearer feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes Claude's competence — it does not explain what NER or a checkpoint is — but has minor trimmable prose such as the restated 'When to use' framing and the opening paragraph that lightly re-explains the zero-shot concept, placing it just below the lean 5 anchor. | 4 / 5 |
Actionability | Provides copy-paste ready, fully executable guidance across both interfaces — install commands, the two-step `openmed zero index` / `zero infer` CLI invocations with all flags, and a complete Python `NerRequest`/`infer` example plus index and label utilities — covering the common cases. | 5 / 5 |
Workflow Clarity | The index-then-infer workflow is clearly numbered and sequenced, with a diagnostic checkpoint (`openmed zero deps`) and an edge-cases section covering failure modes, but there is no explicit validate→fix→retry feedback loop; this is a read-only inference task so the destructive/batch cap does not apply. | 4 / 5 |
Progressive Disclosure | Well-organized into clearly headed sections (When to use, Install, workflow, Python API, labels, hand-off, edge cases, references) with external links clearly signaled and no nested references, but as a single ~146-line file with no bundle files it stops short of the ideal one-level-deep reference split described by the 5 anchor. | 4 / 5 |
Total | 17 / 20 Passed |