CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hipaa-compliance-auditor

Clinical-grade PII/PHI detection and de-identification for healthcare text data. Scans all 18 HIPAA identifier categories with confidence scoring, generates audit logs, supports custom regex patterns, and produces de-identified output while preserving document structure.

Quality

69%

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

Fix and improve this skill with Tessl

tessl review fix ./scientific-skills/Academic Writing/hipaa-compliance-auditor/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The skill body delivers a well-sequenced workflow with concrete commands and real error-recovery loops, but it is noticeably padded with duplicated and generic template sections, and its reference structure is undermined by broken file pointers and content that should be split out. Trimming boilerplate and fixing the references would lift both conciseness and organization.

Suggestions

Remove the duplicated py_compile block (keep it only in "Audit-Ready Commands") and delete or merge generic template sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Response Template) that contain no skill-specific instruction.

Fix reference accuracy: cite `references/hipaa_safe_harbor_guide.md` (the actual file), and either add a `references/test_cases/` directory or drop that pointer.

Move the 18-category list, output-format details, and audit-log JSON schema into a reference file (e.g. `references/identifier_categories.md`) and keep SKILL.md as a concise overview pointing to it.

Delete the unrelated "academic writing" bullet from "When to Use" and the duplicated "(Requires Manual Review)" parenthetical.

DimensionReasoningScore

Conciseness

There are several padded or duplicated sections: "Quick Check" and "Audit-Ready Commands" both run `python -m py_compile scripts/main.py`, "Overview" restates the frontmatter description, "When to Use" contains unrelated boilerplate ("academic writing tasks that require explicit assumptions, bounded scope"), and generic template blocks (Risk Assessment, Security Checklist, Lifecycle Status, Response Template, Evaluation Criteria) fill space without skill-specific guidance — including a duplicated "(Requires Manual Review)" parenthetical.

2 / 5

Actionability

Guidance is mostly executable: concrete CLI commands (`python scripts/main.py --input patient_text.txt --output deidentified.txt`, `python -m spacy download en_core_web_trf`), a runnable Python API block, and a complete parameter table. Minor gaps remain, such as the `from scripts.main import HIPAAAuditor` path assumption and the `--preserve-structure true` boolean-CLI syntax.

4 / 5

Workflow Clarity

The five-step workflow has explicit checkpoints and genuine feedback loops ("If neither input provided: Request the text", "If de-identification fails (missing spaCy model): Install ... then retry", "If unexpected PII remains: Increase custom patterns or lower confidence threshold"). It falls short of 5 because Workflow/Usage content is duplicated across sections and the misplaced "When to Use" boilerplate muddies navigation.

4 / 5

Progressive Disclosure

A References section signals one-level-deep pointers, but bulk content that belongs in separate files (the 18-category list, audit-log JSON schema, output-format details) is inlined in a ~300-line SKILL.md, and two references are broken: the body cites `references/hipaa_safe_harbor_guide.pdf` while the actual file is `.md`, and `references/test_cases/` does not exist in the bundle.

3 / 5

Total

13

/

20

Passed

Description

71%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, specific description that clearly states what the skill does with concrete actions and good domain keywords. Its main weakness is the absence of an explicit "when to use" trigger clause, and it could add natural synonyms like "anonymize" or "redact".

Suggestions

Append an explicit trigger clause, e.g. "Use when working with clinical notes, patient records, or any healthcare text that must be de-identified for HIPAA compliance."

Add natural synonyms such as "anonymize", "redact", or "scrub" to broaden trigger-term coverage.

Spell out PHI ("protected health information") at least once so users who type the full phrase still match.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — "Scans all 18 HIPAA identifier categories", "generates audit logs", "supports custom regex patterns", "produces de-identified output while preserving document structure" — giving comprehensive, non-generic coverage of the domain.

5 / 5

Completeness

The "what" is clearly and concretely answered, but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines.

3 / 5

Trigger Term Quality

Natural domain keywords users would say are present ("PII/PHI", "HIPAA", "de-identification", "healthcare text"), but common synonyms and variations such as "anonymize", "redact", or "protected health information" are missing.

4 / 5

Distinctiveness Conflict Risk

"HIPAA identifier categories" and "healthcare text data" carve a distinct niche with clear triggers, with only minor overlap risk against generic PII-detection or anonymization skills.

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository

aipoch/medical-research-skills

Path

scientific-skills/Academic Writing/hipaa-compliance-auditor/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.