CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

building-with-openmed

Orient and bootstrap any project that uses OpenMed, the on-device clinical and biomedical NLP library, for named-entity recognition, PHI de-identification, FHIR export, and evaluation. Use when the user mentions OpenMed, wants to install it, asks which OpenMed capability or model fits a task, or is starting to build a clinical/medical text pipeline and needs the right entry point.

77

Quality

97%

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

93%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.

An exemplary overview skill: token-efficient, fully executable examples, a router table that implements progressive disclosure one level deep, and a validation gate for the de-identification workflow. The only gap is that error-recovery feedback for failed leakage gates is delegated to a companion skill rather than sketched inline, which keeps workflow_clarity at 4.

DimensionReasoningScore

Conciseness

The body is lean throughout: a 14-row handoff table instead of prose, three compact code blocks with inline comments (e.g. "# registry key, HF id, or local path"), and terse rule bullets ("Do not add cloud calls to PHI workflows"). It assumes Claude's competence — no concept is explained that Claude already knows — so it sits on the 5-anchor rather than the 4-anchor ("minor instances of over-explanation"), as even the extras paragraph adds new information beyond the pip block.

5 / 5

Actionability

All guidance is copy-paste ready: exact pip extras ("pip install \"openmed[hf]\""), three fully-parameterized Python calls (openmed.analyze_text, openmed.deidentify, openmed.extract_pii with model_name, output_format, method, policy), CLI equivalents ("openmed analyze --text … --format json"), and runtime discovery calls. These cover the common cases; not a 4 because no key execution detail is missing.

5 / 5

Workflow Clarity

The "typical pipeline" section lays out a clear five-stage sequence (ingest → de-identify → extract → ground → assemble FHIR → evaluate) and a validation gate is explicitly present ("De-identification is verified, not assumed. Gate on leakage with openmed.eval, not on F1 alone"), so the destructive-operation cap does not apply. Not a 5: the error-recovery feedback loop (what to do when leakage is detected) is deferred to the companion skill rather than stated inline, matching the 4-anchor ("most checkpoints present; minor validation gaps") rather than the 5-anchor ("feedback loops for error recovery").

4 / 5

Progressive Disclosure

This is a router skill executed exactly as the 5-anchor describes: a concise overview whose bulk is a well-signaled, one-level-deep handoff table ("## When to use this skill" → per-task skill/API pairs) with no content inlined that belongs in a deeper file. No bundle files exist to verify (references/, scripts/, assets/ are absent), but structure alone — table-driven navigation, short themed sections — places it clearly above the 4-anchor ("minor organization gaps").

5 / 5

Total

19

/

20

Passed

Description

100%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: it states what the skill does in third person with four concrete capabilities, and gives an explicit 'Use when…' clause with four natural, distinct trigger conditions including synonym coverage. It is both comprehensive and free of padding or over-claims.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "named-entity recognition, PHI de-identification, FHIR export, and evaluation" plus "Orient and bootstrap any project" — giving comprehensive coverage of the library's capability surface. Not a 4: there are no minor gaps; each listed capability is a specific, verifiable action rather than a generic verb.

5 / 5

Completeness

Both halves are explicit: the 'what' ("Orient and bootstrap any project that uses OpenMed… for named-entity recognition, PHI de-identification, FHIR export, and evaluation") and a concrete 'when' clause with four specific trigger conditions. Not a 4: the 'when' is not merely present but enumerates concrete trigger phrases, matching the 5-anchor exactly.

5 / 5

Trigger Term Quality

Natural trigger phrases cover the ways a user would actually ask: "mentions OpenMed", "wants to install it", "asks which OpenMed capability or model fits a task", and "build a clinical/medical text pipeline". Synonym coverage is present ("clinical/medical"), and no natural variation relevant to a named library (no file extension applies) is missing.

5 / 5

Distinctiveness Conflict Risk

The description is anchored to a uniquely named library ("OpenMed, the on-device clinical and biomedical NLP library") and positions itself as the entry point ("needs the right entry point"), which distinguishes it from the sibling focused OpenMed skills it routes to. Conflict risk with unrelated skills is minimal.

5 / 5

Total

20

/

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/building-with-openmed/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.