Content
75%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, domain-dense body: an executable quick start, a clearly sequenced 7-step workflow with an audit checkpoint, and high-value gotchas (negation flips meaning, date-driven measurement periods, value-set membership over keywords). Main weaknesses are the internally inconsistent illustrative keyword-matching in the quick start, the absence of error-recovery feedback loops, and lightly signaled cross-skill references. No bundle files are present, so all content appropriately lives in the body.
Suggestions
Fix the quick-start example to match the skill's own guidance: replace the keyword-matching check ("counseling" in note.lower()) with a label/value-set-based check, since the gotchas explicitly forbid matching on surface words.
Add a short error-recovery branch to the workflow (e.g. what to do when a fact fails the negation/temporality pass or a date cannot be resolved) to turn the final audit step into a true validate-fix-retry loop.
Make the sibling-skill references navigable: turn inline mentions like `resolving-clinical-context` and `building-patient-timelines` into a clearly labeled 'Related skills' list so the hand-off points are easy to discover.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and mostly earns its tokens: the population table, the quick start, the 7-step workflow, and the gotchas all carry skill-specific information rather than general knowledge. It is not level 5 because the opening paragraph and the eCQM anatomy section re-explain domain concepts (what CQL/QDM are, what IPP/denominator mean) that Claude largely already knows, though these are brief; it is well above the 'noticeably verbose' level-3/2 anchors. | 4 / 5 |
Actionability | The quick start is executable (`openmed.analyze_text(note, output_format="dict")` with the entity shape documented) and the workflow steps name concrete tools, skills, and vocabulary. It falls short of level 5 because the fact-derivation snippet is labeled "illustrative" and uses raw keyword matching ("counseling" in note.lower()) that the skill's own gotchas later forbid ("don't match on the surface word"), an internal inconsistency; there is also no executable example for the QDM-materialization step. | 4 / 5 |
Workflow Clarity | The 7-step workflow is clearly sequenced (read measure -> de-identify -> extract -> code -> materialize QDM -> compute in certified engine -> reconcile & audit) with a final verification/audit checkpoint and a negation-assertion gate in step 3. It does not reach level 5 because there are no explicit feedback loops for error recovery (no fix-and-retry guidance when coding, dating, or negation checks fail), leaving it at 'clear sequence with most checkpoints present'. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), and the ~115-line body is appropriately self-contained with well-organized, clearly headed sections (quick start, workflow, hand-off, gotchas, standards) — matching 'good structure; most content is appropriately placed'. It is not level 5 because the sibling-skill pointers (`choosing-openmed-models`, `resolving-clinical-context`, `building-patient-timelines`, `etl-to-omop-cdm`) are mentioned inline in prose without being clearly signaled as navigable references, a minor organization gap. | 4 / 5 |
Total | 16 / 20 Passed |