soap-note-creation-b354d8

Create structured medical SOAP notes by writing comprehensive content to a file in one iteration

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./benchmarks/gdpval/skills/soap-note-creation-b354d8/SKILL.md

Quality

Content

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable and well-structured with a copy-paste template and a clear, checkpointed workflow; its only weakness is mild verbosity in section introductions that restate concepts Claude already knows.

Suggestions

Trim section-introduction lines that restate well-known concepts (e.g., 'Document observable, measurable findings') to lift conciseness toward lean efficiency.

Consider collapsing the duplicated structure list (the prose breakdown and the markdown template) to reduce redundancy while keeping the template.

Dimension	Reasoning	Score
Conciseness	Mostly efficient with a concrete, useful template, but includes some explanation of concepts Claude already knows (e.g., 'Document observable, measurable findings', 'Document clinical reasoning') and could be tightened in the section intros.	2 / 3
Actionability	Provides a complete, copy-paste-ready markdown template with concrete placeholders, a numbered usage workflow, and specific format guidance (e.g., file size of 3000-10000+ bytes), making it fully executable.	3 / 3
Workflow Clarity	The 'Example Usage' section gives a clearly sequenced four-step process with an explicit verification checkpoint ('Ensure no required section is missing before completing the task'); for this single write-file task the workflow is unambiguous.	3 / 3
Progressive Disclosure	No bundle files exist and none are referenced; the skill is a self-contained single-file document with well-organized sections (When to Use, Structure, Template, Best Practices, Example, File Format) and clean navigation, which is appropriate for this scope.	3 / 3
	Total	11 / 12 Passed

Description

57%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is concrete and distinctive but incomplete: it states what the skill does without specifying when it should be invoked, and it omits common trigger-term variations users would naturally say.

Suggestions

Add an explicit 'when' trigger clause, e.g. 'Use when creating clinical documentation, patient visit notes, or medical charting in SOAP format.'

Include more natural trigger terms users might say, such as 'clinical documentation', 'patient notes', or 'chart notes'.

Enumerate the specific actions (e.g., generate Subjective, Objective, Assessment, and Plan sections) to raise specificity from a single stated action to multiple concrete actions.

Dimension	Reasoning	Score
Specificity	Names the domain ('medical SOAP notes') and a concrete action ('create structured medical SOAP notes by writing comprehensive content to a file in one iteration'), but lists only a single main action rather than enumerating the multiple specific component actions (e.g., generating Subjective/Objective/Assessment/Plan sections).	2 / 3
Completeness	Clearly answers 'what' the skill does but provides no 'Use when...' clause or equivalent explicit trigger for 'when' to use it, which per the judging guidelines caps completeness at 2.	2 / 3
Trigger Term Quality	Contains the natural phrase 'medical SOAP notes', but lacks common variations a user might say such as 'clinical documentation', 'patient notes', 'chart notes', or 'medical notes'.	2 / 3
Distinctiveness Conflict Risk	'Medical SOAP notes' is a clear, narrow niche that is unlikely to overlap with or be triggered by unrelated skills.	3 / 3
	Total	9 / 12 Passed

Validation

100%

Warnings & errors only

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: HKUDS/OpenSpace
Path: benchmarks/gdpval/skills/soap-note-creation-b354d8/SKILL.md
Commit: c5a9c4b

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.