create-soap-note

Generate structured medical SOAP notes with all required sections in a single comprehensive file write.

Quality

53%

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/create-soap-note/SKILL.md

Quality

Content

57%

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

The body is well-structured and self-contained with a useful template, but it carries some introductory padding, abstract step wording, and a vague verification checkpoint that keep most dimensions at the mid-level. Tightening the prose and making the review step concrete would raise conciseness, actionability, and workflow clarity.

Suggestions

Replace the vague review step with a concrete checklist, e.g. "Confirm each of S/O/A/P has substantive content; if a section is empty, fill it with ‘Information not provided’ before saving."

Cut the opening meta-sentence and the Objective restatement; let the workflow steps speak for themselves to improve token efficiency.

Make the Draft step more actionable by tying each sub-bullet to the matching template field rather than listing abstract section names.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient, but introductory meta-explanation such as "This skill defines the workflow for creating structured medical documentation…" restates what the headings already convey and could be trimmed.	2 / 3
Actionability	A concrete template and a file-naming convention ("soap_note_<patient_id>_<date>.md") are provided, but the surrounding workflow steps are abstract directives ("Draft Comprehensive Content", "Organize the note") rather than fully concrete instruction.	2 / 3
Workflow Clarity	The four numbered steps give a clear sequence and step 4 adds a review checkpoint, but the verification ("Verify that all four headers exist") is vague with no feedback loop describing what to do on failure beyond the separate Troubleshooting section.	2 / 3
Progressive Disclosure	The skill is a self-contained single-purpose document with well-organized sections and no nested or missing references; no bundle files are needed, so the structure is appropriate.	3 / 3
	Total	9 / 12 Passed

Description

50%

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 clear and domain-specific with correct third-person voice, but it omits any explicit "Use when…" trigger guidance and offers only a single concrete action, leaving every dimension at the mid-level. Adding trigger phrasing and one or two more concrete actions would lift specificity and completeness.

Suggestions

Add an explicit "Use when…" clause, e.g. "Use when creating medical SOAP notes, clinical visit documentation, or charting a patient encounter."

List a second concrete action beyond generation, such as "…and save them to a structured markdown file with standardized S/O/A/P sections."

Include natural trigger variations like "clinical documentation", "patient note", or "visit note" to improve trigger-term coverage.

Dimension	Reasoning	Score
Specificity	Quotes "Generate structured medical SOAP notes" and "single comprehensive file write" name the domain and a concrete action, but only one main action is given rather than the multiple specific concrete actions required for a 3.	2 / 3
Completeness	The description clearly states what the skill does, but there is no "Use when…" clause or equivalent trigger guidance, which caps completeness at 2 per the judging guidelines.	2 / 3
Trigger Term Quality	"medical SOAP notes" is a natural term a user would say, but common variations like "clinical documentation", "patient note", or "charting" are missing, so coverage is partial.	2 / 3
Distinctiveness Conflict Risk	"medical SOAP notes" is a fairly specific niche, but without explicit triggers it could still overlap with broader medical-documentation or charting skills.	2 / 3
	Total	8 / 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/create-soap-note/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.