CtrlK
BlogDocsLog inGet started
Tessl Logo

deidentifying-clinical-text

Remove, mask, or replace PHI/PII in clinical free text on-device with OpenMed's deidentify(). Use when the user needs to de-identify medical notes, strip patient identifiers, redact PHI before sharing or analysis, anonymize discharge summaries, or pick a de-id method (mask vs remove vs replace vs hash vs shift_dates). Covers confidence_threshold for safety, consistent+seed for stable surrogates, keep_mapping for reversible de-id, policy= profiles, and the DeidentificationResult fields. Pairs with OpenMed extract_pii (detect spans), reidentify (restore), configuring-privacy-policies, and auditing-deidentification-runs.

76

Quality

94%

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

88%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 high-quality, action-oriented body with executable code, a validated workflow, and well-signaled cross-skill navigation. Minor conciseness trimming and offloading some inlined reference material into bundle files would push it to full marks.

Suggestions

Trim evaluative/restating sentences like 'This is the single most important OpenMed entry point for privacy work; everything else layers on top of it' to improve conciseness.

Move the full five-methods table and the HIPAA/standards section into a references/ file (e.g. methods.md, standards.md) and link from the body to improve progressive disclosure now that no bundle files exist.

Consider a short 'verify' code snippet (e.g. calling with audit=True and checking residual-risk) to make the validation checkpoint in the workflow directly executable.

DimensionReasoningScore

Conciseness

Mostly lean with executable code and no basic-concept padding, but a few sentences restate the obvious (e.g. 'This is the single most important OpenMed entry point… everything else layers on top of it') and could be trimmed; matches the efficient-with-minor-over-explanation level-4 anchor rather than the every-token-earns-its-place level 5.

4 / 5

Actionability

Provides fully executable, copy-paste-ready code with real parameter names (method, confidence_threshold, policy, consistent, seed, keep_mapping) and concrete field tables covering all five methods, matching the level-5 anchor; not level 4 because examples cover the common cases completely.

5 / 5

Workflow Clarity

A six-step sequenced workflow with an explicit validation checkpoint ('Verify, don't assume… audit=True') and error-recovery guidance, satisfying the level-5 anchor; the destructive/privacy-sensitive 3-cap does not apply because validation is present.

5 / 5

Progressive Disclosure

Well-organized with clearly signaled one-level sibling-skill references (extracting-pii-entities, configuring-privacy-policies, auditing-deidentification-runs), but with no bundle files the ~130-line body inlines content (full methods table, standards section) that could live in reference files, matching level-4 rather than the cleanly-split level 5.

4 / 5

Total

18

/

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, third-person description that concisely states capabilities, lists natural trigger synonyms, gives an explicit 'Use when' clause, and carves out a distinct niche against related skills. It earns top marks across all four dimensions.

DimensionReasoningScore

Specificity

Lists five concrete de-id methods (mask, remove, replace, hash, shift_dates) plus action verbs (remove, mask, replace) with comprehensive coverage and no gaps, matching the level-5 anchor; it is not level 4 because coverage is exhaustive rather than having minor gaps.

5 / 5

Completeness

Explicitly answers both 'what' (Remove, mask, or replace PHI/PII in clinical free text on-device with OpenMed's deidentify()) and 'when' (Use when the user needs to de-identify medical notes, strip patient identifiers, redact PHI…) with concrete trigger phrases, matching the level-5 anchor.

5 / 5

Trigger Term Quality

Covers natural synonyms users would say — 'de-identify medical notes', 'strip patient identifiers', 'redact PHI', 'anonymize discharge summaries' — matching the comprehensive-synonyms anchor at level 5 rather than the good-but-incomplete level 4.

5 / 5

Distinctiveness Conflict Risk

Occupies a clear clinical-de-identification niche and explicitly distinguishes itself from sibling functions (extract_pii for detection, reidentify for restoration), giving it minimal conflict risk per the level-5 anchor.

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
maziyarpanahi/openmed
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.