CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

reconciling-problem-lists

Deduplicate and reconcile OpenMed-extracted conditions into one clean active problem list with clinical status (active / resolved / historical). Use after NER and context resolution when the user wants a problem list, condition reconciliation, dedup of synonymous diagnosis mentions, or active-vs-resolved status from a note. Covers clustering synonymous mentions into one concept, excluding negated mentions, applying clinical context (historical / hypothetical / recent) to set status, and emitting a USCDI-Problem-shaped list. SNOMED CT concept grounding is user-supplied and out-of-process. Hand-off: consume openmed.analyze_text Disease entities plus resolving-clinical-context axes. Pairs after extracting-clinical-entities.

72

Quality

90%

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

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 well-structured, highly actionable body: executable quick start, crisp workflow, and genuinely useful gotchas. The main weaknesses are mild repetition of the negation and SNOMED-out-of-process points and the absence of an explicit output-verification step.

Suggestions

State the negation/hypothetical exclusion rule once (workflow step 3) and cut the repetitions in the intro, hand-off, and edge cases to tighten conciseness.

Add a short verification step at the end of the workflow — e.g., assert that no negated or hypothetical concept reached the final list and that each entry's provenance offsets trace back to note text — to raise workflow clarity.

Consider moving the Standards & references URL list into a references/ file to keep the main body focused on the workflow and edge cases.

DimensionReasoningScore

Conciseness

The body is mostly lean — a runnable quick start, dense numbered workflow, and terse edge cases — with every token close to earning its place. However, the negation point is repeated four times (intro, step 3, hand-off, edge cases) and 'SNOMED CT grounding is out-of-process' appears three times, so minor trimming would reach the level-5 anchor.

4 / 5

Actionability

The quick start is copy-paste-ready, executable code with expected output shown in comments ('# -> [{"concept": "type 2 diabetes", ...}]', '# "chest pain" excluded (negated)'), and the workflow names exact API calls (analyze_text, resolve_span_context, NEGATED/HISTORICAL/HYPOTHETICAL). The cheap normalize() placeholder is explicitly justified as out-of-process SNOMED territory, so it does not drag the score below fully executable.

5 / 5

Workflow Clarity

The six-step sequence is clear, ordered, and includes aggregation precedence rules ('Active wins over historical') plus edge-case checkpoints for known failure modes. It falls short of level 5 only because there is no explicit verification step (e.g., assert no NEGATED/HYPOTHETICAL concept landed on the list, or spot-check provenance offsets against the note) — checkpoints are present but implicit in the edge cases.

4 / 5

Progressive Disclosure

No bundle files exist, and the ~125-line body is well organized into clearly signaled sections (When to use, Quick start, Workflow, Hand-off, Edge cases, Standards) with only one-level external URLs. It is not level 5 because the skill exceeds the under-50-lines simple-skill bar and the edge cases / standards sections could arguably live in a reference file, though the single file remains easy to navigate.

4 / 5

Total

17

/

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: concrete, third-person, with an explicit 'Use when...' trigger clause and clear hand-off boundaries against sibling skills. The only gap is a handful of natural synonyms for the trigger terms.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Deduplicate and reconcile OpenMed-extracted conditions', 'clustering synonymous mentions into one concept', 'excluding negated mentions', 'applying clinical context (historical / hypothetical / recent) to set status', and 'emitting a USCDI-Problem-shaped list' — with comprehensive coverage of the skill's capabilities. It clearly matches the level-5 anchor (multiple specific concrete actions) rather than level 4, which would leave coverage gaps.

5 / 5

Completeness

It explicitly answers both questions: what it does ('Deduplicate and reconcile... into one clean active problem list with clinical status') and when to use it ('Use after NER and context resolution when the user wants a problem list, condition reconciliation, dedup...'). Both are stated with concrete trigger phrases, matching the level-5 anchor exactly.

5 / 5

Trigger Term Quality

Natural trigger phrases are present: 'problem list', 'condition reconciliation', 'dedup of synonymous diagnosis mentions', 'active-vs-resolved status'. Coverage is good but a few natural variations a clinician might say ('diagnosis list', 'chart review', 'past medical history cleanup') are missing, so it sits at the level-4 anchor rather than fully comprehensive level 5.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (OpenMed condition reconciliation into a problem list) and explicitly delimits against sibling skills ('Use after NER and context resolution', 'Pairs after extracting-clinical-entities', 'Hand-off: consume openmed.analyze_text Disease entities'), minimizing conflict risk. It is clearly distinct from the extraction and context-resolution skills it references, matching the level-5 anchor.

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/reconciling-problem-lists/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.