Convert physician verbal dictation into structured SOAP notes. Trigger.
46
33%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/Academic Writing/medical-scribe-dictation/SKILL.mdQuality
Discovery
32%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 identifies a clear medical documentation use case but is critically incomplete. The truncated 'Trigger.' fragment suggests the description was cut off or corrupted, leaving no explicit guidance on when Claude should select this skill. The core capability is understandable but lacks the detail and trigger terms needed for reliable skill selection.
Suggestions
Complete the trigger clause with explicit guidance, e.g., 'Use when the user provides audio transcription, voice recordings, or asks to format clinical notes into SOAP format.'
Add natural trigger terms users would say: 'medical notes', 'clinical documentation', 'transcription', 'patient encounter', 'subjective objective assessment plan'.
Expand specific capabilities: 'Converts verbal dictation into structured SOAP notes with Subjective, Objective, Assessment, and Plan sections, extracts diagnoses, and formats medical terminology.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (physician dictation, SOAP notes) and one action (convert), but doesn't list multiple concrete actions like formatting sections, extracting diagnoses, or handling medical terminology. | 2 / 3 |
Completeness | The 'what' is present but the 'when' clause is broken - 'Trigger.' appears to be an incomplete or corrupted sentence fragment, providing no actual trigger guidance. | 1 / 3 |
Trigger Term Quality | Includes relevant terms like 'dictation', 'SOAP notes', and 'physician', but missing common variations users might say like 'medical notes', 'clinical documentation', 'transcription', or 'patient notes'. | 2 / 3 |
Distinctiveness Conflict Risk | SOAP notes and physician dictation are fairly specific to medical documentation, but could overlap with general transcription or medical documentation skills without clearer boundaries. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill suffers from severe template bloat - it appears to be generated from a generic skill template with medical scribe content inserted, resulting in redundant sections, circular references, and boilerplate that obscures the actual medical transcription guidance. The core medical scribe functionality (SOAP structure, terminology handling) is present but buried under excessive scaffolding that doesn't serve Claude's needs.
Suggestions
Remove all circular references ('See ## X above') and consolidate duplicate sections - the document references itself unnecessarily at least 6 times
Delete boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) that don't provide medical-scribe-specific value
Add concrete examples of dictation input → SOAP output transformation to demonstrate the actual processing logic
Include explicit validation checkpoints for medical accuracy (e.g., 'Verify drug names against formulary before finalizing', 'Flag ambiguous dosages for physician review')
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose with significant redundancy - multiple sections reference each other circularly ('See ## Features above', 'See ## Usage above'), duplicate audit commands, boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status) that add little value, and excessive templating that doesn't serve the medical scribe use case specifically. | 1 / 3 |
Actionability | Provides some concrete code examples (Python API usage, CLI commands) and a clear SOAP output structure, but much is pseudocode-like or placeholder-heavy. The actual medical NLP processing logic is not shown - just imports and method calls without implementation details Claude would need. | 2 / 3 |
Workflow Clarity | Has numbered workflow steps and mentions validation, but the medical-specific workflow (dictation → transcription → SOAP structuring → validation) lacks explicit checkpoints for clinical accuracy verification. The generic workflow section doesn't address the critical validation needs for medical content. | 2 / 3 |
Progressive Disclosure | References external files appropriately (references/soap-templates.md, etc.) but the main document is bloated with boilerplate sections that should be omitted or consolidated. The circular 'See ## X above' references create confusion rather than clarity. | 2 / 3 |
Total | 7 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
4a48721
Table of Contents
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.