CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

computing-ecqms

Compute electronic clinical quality measures (eCQMs) over structured data using CQL/QDM logic, lifting note-derived numerator and exclusion facts from OpenMed to improve measure capture. Use when the user wants to compute an eCQM, evaluate a CMS/ECQI quality measure, improve numerator capture from clinical notes, build CQL/QDM measure logic, or close documentation gaps that structured codes miss. Covers eCQM structure (IPP/denominator/numerator/exclusions), CQL v1.5 and QDM v5.6, MADiE authoring, and mapping OpenMed entities to QDM data elements. Consumes OpenMed analyze_text facts (coded via the linking skills) to supplement structured EHR data; does not replace certified measure engines.

69

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description in third person that clearly states what the skill does and gives an explicit, multi-trigger 'Use when' clause with concrete, natural phrases. It also scopes boundaries (supplements, does not replace, certified engines), which further sharpens when it applies. The only gap is a handful of missing synonyms a user might naturally say (e.g. 'quality reporting', 'measure scoring').

DimensionReasoningScore

Specificity

Quotes multiple concrete actions: "Compute electronic clinical quality measures (eCQMs) over structured data using CQL/QDM logic", "lifting note-derived numerator and exclusion facts from OpenMed to improve measure capture", "build CQL/QDM measure logic", and "mapping OpenMed entities to QDM data elements". This matches the anchor for several specific, comprehensive concrete actions; it is not the level-4 anchor because coverage of the skill's capability surface is complete rather than showing minor gaps.

5 / 5

Completeness

It explicitly answers both questions: the "what" ("Compute electronic clinical quality measures (eCQMs) ... lifting note-derived numerator and exclusion facts") and a concrete "when" ("Use when the user wants to compute an eCQM, evaluate a CMS/ECQI quality measure, improve numerator capture from clinical notes, build CQL/QDM measure logic, or close documentation gaps"). This mirrors the level-5 good example's structure exactly; level 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural trigger phrases are present and well-matched: "compute an eCQM", "evaluate a CMS/ECQI quality measure", "improve numerator capture from clinical notes", "build CQL/QDM measure logic", "close documentation gaps". It falls short of the level-5 anchor because a few natural synonyms users might say are missing (e.g. "quality reporting", "MIPS", "measure scoring/calculation"), while coverage is clearly better than 'some relevant keywords' at level 3.

4 / 5

Distinctiveness Conflict Risk

A clear niche (eCQM computation supplemented by note-derived facts) with distinct, domain-specific triggers (CQL, QDM, MADiE, numerator/exclusion capture) and explicit boundary scoping ("does not replace certified measure engines"). Minimal conflict risk with generic analytics or NLP skills; not level 4 because there is no meaningful overlap with a closely related skill's trigger set.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

maziyarpanahi/openmed

Path

skills/computing-ecqms/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.