CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

choosing-openmed-models

Discover and pick the right OpenMed model for a clinical or biomedical task, domain, or language. Use when the user asks which OpenMed model to use, wants to list model categories, find a Disease vs Oncology vs Privacy/PII model, get a PII model for a specific language, search models by size or task, or inspect a model's labels and metadata before loading. Covers list_model_categories, get_models_by_category, get_pii_models_by_language, get_default_pii_model, search_models(ModelQuery(...)), get_model_info, and the openmed models CLI. Pairs with loading-openmed-models.

74

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 strong, highly actionable body: executable examples with real outputs, explicit gotchas with fallback guidance, and a sensible decision narrative (Disease vs Oncology vs Privacy, size trade-offs). Weaknesses are modest — some redundancy and inline API reference material that a small references/ file could absorb.

Suggestions

Remove the duplicate hand-off statement — say it once, either in 'When to use' or in 'Hand-off to / from OpenMed', and trim the 'When to use' bullets that restate the frontmatter description.

Move the full ModelInfo attribute table and ModelSearchResult field list into a references/ file (e.g. references/model-info.md), keeping only the 2-3 fields needed to make a choice inline.

Present the selection process as one ordered checklist (browse category → confirm entity_types/canonical_labels → check recommended_confidence → hand off with model_name), consolidating the steps currently spread across 'Quick start', 'Disease vs Oncology', and 'Edge cases'.

DimensionReasoningScore

Conciseness

The body is lean and code-dense, but a few spots could be trimmed: the hand-off to 'loading-openmed-models' is stated twice (once in 'When to use', again in 'Hand-off to / from OpenMed'), and the 'When to use' section largely restates the frontmatter description. This fits the 4-anchor ('minor instances of over-explanation that could be trimmed') better than the 5-anchor, where every token earns its place.

4 / 5

Actionability

All eight code blocks are executable and copy-paste ready with expected outputs shown ('['Medical', 'Privacy', ...]', 'print(default_es) # HF repo id, or None if unsupported'), covering the common paths: category browsing, model inspection, PII-by-language, structured ModelQuery search, suggestions, and CLI. This matches the 5-anchor ('fully executable; copy-paste ready code or commands; specific examples cover the common cases'), not the 4-anchor which expects gaps.

5 / 5

Workflow Clarity

A clear selection flow exists — 'Never hardcode a model list... query the registry at runtime', browse categories, inspect via 'entity_types' / 'recommended_confidence', verify labels 'before committing', and hand off — with error-recovery guidance ('get_default_pii_model(lang) can return None... fall back... and warn'). It is not a 5 because the sequence is distributed across sections rather than one coherent ordered workflow, leaving minor gaps in explicit sequencing (4-anchor: 'Clear sequence with most checkpoints present').

4 / 5

Progressive Disclosure

Sections are well-organized and clearly labeled, but the skill is a single ~190-line file with no bundle files: API reference material such as the full ModelInfo attribute table, the ModelSearchResult field list, and the CLI reference is inlined where a references/ file could carry it. That fits the 4-anchor ('Good structure; most content is appropriately placed; minor organization gaps') rather than the 5-anchor ('content appropriately split'), since the body exceeds the under-50-lines exception for single-file skills.

4 / 5

Total

17

/

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.

An exemplary description: concrete and comprehensive on capabilities, natural trigger phrases, explicit what-and-when structure, and clean separation from the adjacent loading skill. Third-person voice throughout, with no fluff or over-claims.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions — 'list model categories, find a Disease vs Oncology vs Privacy/PII model, get a PII model for a specific language, search models by size or task, or inspect a model's labels and metadata' — plus the specific APIs ('list_model_categories, get_models_by_category, get_pii_models_by_language, ... get_model_info, and the openmed models CLI'). Coverage is comprehensive, matching the 5-anchor ('Extract text and tables from PDF files, fill forms, merge documents'), not the 4-anchor which expects 'minor gaps in coverage'.

5 / 5

Completeness

It explicitly answers 'what' ('Discover and pick the right OpenMed model for a clinical or biomedical task... Covers list_model_categories, ... and the openmed models CLI') and 'when' via a concrete 'Use when the user asks...' clause with specific trigger scenarios — the exact shape of the 5-anchor example. It is not the 4-anchor case since the 'when' clause is fully explicit rather than improvable.

5 / 5

Trigger Term Quality

Trigger phrases are natural user utterances: 'which OpenMed model to use', 'list model categories', 'PII model for a specific language', 'search models by size or task', 'inspect a model's labels and metadata', with synonyms ('Disease vs Oncology vs Privacy/PII', 'domain, or language'). This is comprehensive coverage including variations, matching the 5-anchor rather than the 4-anchor ('a few natural terms missing').

5 / 5

Distinctiveness Conflict Risk

A clear niche — OpenMed model discovery/selection — with distinct triggers ('which OpenMed model to use', 'list model categories') and explicit boundary management ('Pairs with loading-openmed-models', i.e. this skill selects, that one loads). Overlap risk with adjacent skills is minimal, fitting the 5-anchor; the 4-anchor's 'minor overlap risk with closely related skills' is slightly less accurate given the explicit pairing note.

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/choosing-openmed-models/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.