CtrlK
BlogDocsLog inGet started
Tessl Logo

automated-soap-note-generator

Generate structured SOAP notes from clinical narratives, transcripts, or existing notes; use when the user needs de-identified clinical documentation organized into Subjective, Objective, Assessment, and Plan sections, with clear assumptions and review points.

57

Quality

66%

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/automated-soap-note-generator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

48%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 body is thorough and well-sectioned with working CLI commands, but it is padded with redundant meta-process boilerplate and its Python examples reference a module and methods that do not exist in the bundle. The provided reference files are orphaned rather than wired into the document.

Suggestions

Fix the Python examples to import from scripts/main.py and use the methods that actually exist (generate, extract_entities, detect_negation, classify_section), or document the real API surface instead of the fictional soap_generator module.

Collapse the redundant meta-process sections (Output Requirements, Response Template, Output Contract, Error/Failure Handling, When Not to Use, User Checkpoints, Quick Validation) into one concise section and remove explanations of SOAP concepts Claude already knows.

Link the existing reference files from the body (e.g., 'See references/sample_soap_notes.md for examples', 'references/medical_terminology.md for abbreviation handling') and move the entity-type and export-format tables there to slim the main SKILL.md.

DimensionReasoningScore

Conciseness

The ~420-line body is noticeably verbose: it explains SOAP concepts Claude already knows and stacks heavily redundant meta-process sections (Output Requirements, Response Template, Output Contract, Error Handling, Failure Handling, When Not to Use, Required Inputs, User Checkpoints, Quick Validation) that restate the same ideas. It sits above the severely-padded 1 anchor but well below an efficient skill.

2 / 5

Actionability

The audit-ready CLI commands and parameter tables are concrete and executable, but the Python API examples are not: they import from a non-existent 'scripts.soap_generator' module and call methods (generate_from_transcript, extract_medical_entities, classify_soap_sections, extract_temporal_info, analyze_certainty, generate_soap_document) that do not exist in scripts/main.py, and the docs claim hl7/csv formats the script does not support. This is incomplete/pseudocode-grade guidance mixed with working commands, matching the 3 anchor.

3 / 5

Workflow Clarity

There is a sequenced 5-step Workflow with explicit stop-early validation, plus a py_compile Quick Check, Audit-Ready Commands, and Quick Validation checkpoints — clear sequence with most checkpoints present. It stays below 5 because the workflow steps are generic meta-process ('Confirm the user objective') rather than concrete SOAP-generation steps and several checkpoint sections duplicate one another.

4 / 5

Progressive Disclosure

Bundle reference files exist (clinical_guidelines.md, medical_terminology.md, sample_soap_notes.md) but are never linked or signaled from the body, while content that belongs in those files (entity-type tables, sample SOAP structure, export formats) is inlined in a long monolithic document — matching the 'references present but not clearly signaled; content that should be separate is inline' anchor.

3 / 5

Total

12

/

20

Passed

Description

83%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: third-person, concrete, and explicit about both what it does and when to use it. Minor room to add a few more natural synonyms (dictation, medical notes) and tighten the action list.

DimensionReasoningScore

Specificity

Lists several concrete actions — generating structured SOAP notes from clinical narratives, transcripts, or existing notes and organizing output into Subjective/Objective/Assessment/Plan sections — but they elaborate one primary action rather than enumerating many distinct capabilities, so it sits below the comprehensive 5 anchor.

4 / 5

Completeness

Explicitly answers both 'what' (generate structured SOAP notes from narratives/transcripts/existing notes) and 'when' ('use when the user needs de-identified clinical documentation organized into Subjective, Objective, Assessment, and Plan sections') with a concrete trigger phrase, matching the top anchor.

5 / 5

Trigger Term Quality

Includes natural terms users would say ('SOAP notes', 'clinical narratives', 'transcripts', 'de-identified clinical documentation') with good coverage, but misses common synonyms like 'dictation' or 'medical notes', placing it just below the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The SOAP-note / S-O-A-P niche is specific and unlikely to fire for unrelated skills, but 'clinical documentation' could overlap marginally with adjacent medical-research skills, so it is just below the minimal-conflict 5 anchor.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
aipoch/medical-research-skills
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.