Use when converting medical text between academic and patient-friendly tones, translating medical jargon for patients, adapting research papers for public audiences, or rewriting clinical notes for patient handouts. Maintains medical accuracy while adjusting readability level.
56
63%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/Academic Writing/tone-adjuster/SKILL.mdQuality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that clearly defines its niche in medical text adaptation for different audiences. It provides specific actions, natural trigger terms, explicit 'Use when' guidance, and occupies a distinct domain that minimizes conflict risk. The description is concise yet comprehensive.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: converting medical text between tones, translating medical jargon, adapting research papers for public audiences, rewriting clinical notes for patient handouts. Also mentions maintaining medical accuracy while adjusting readability level. | 3 / 3 |
Completeness | Clearly answers both 'what' (converting medical text, translating jargon, adapting research papers, rewriting clinical notes while maintaining accuracy) and 'when' with an explicit 'Use when...' clause listing specific trigger scenarios. | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'medical text', 'patient-friendly', 'medical jargon', 'research papers', 'clinical notes', 'patient handouts', 'readability level'. These cover a good range of terms a user would naturally use when needing this skill. | 3 / 3 |
Distinctiveness Conflict Risk | Occupies a clear niche at the intersection of medical domain and tone/readability adaptation. The specific focus on medical-to-patient-friendly conversion with terms like 'clinical notes', 'patient handouts', and 'medical jargon' makes it highly distinct and unlikely to conflict with general writing or general medical skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
27%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill contains a genuinely useful core (the conversion rules, jargon dictionary, reading level guidance, and best practices sections) buried under extensive generic boilerplate that appears auto-generated. The description is repeated three times, and roughly half the document consists of generic workflow/error-handling/validation templates that add no domain-specific value. The result is a bloated skill that makes it hard to find the actionable medical tone conversion guidance.
Suggestions
Remove all generic boilerplate sections (Output Requirements, Error Handling, Input Validation, Response Template, Implementation Details) that are not specific to medical tone conversion — these waste tokens on things Claude already knows how to do.
Eliminate the repeated description from 'When to Use' and 'Key Features' sections; replace with a single concise purpose statement.
Add a concrete, domain-specific workflow for tone conversion: e.g., 1) Identify medical terms → 2) Determine target reading level → 3) Convert terminology → 4) Verify medical accuracy preserved → 5) Assess reading level of output.
Either provide the referenced bundle files (scripts/main.py, references/) or remove all references to them — currently they create false expectations of executable infrastructure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose and repetitive. The 'When to Use' section repeats the description verbatim. 'Key Features' restates the description again. There are multiple redundant sections (Workflow, Implementation Details, Output Requirements, Error Handling, Input Validation, Response Template) that are generic boilerplate not specific to tone adjustment. The skill explains concepts Claude already knows and pads heavily with unnecessary scaffolding. | 1 / 3 |
Actionability | The core capabilities section (Academic to Patient-Friendly, jargon dictionary, conversion rules, examples table) provides genuinely useful concrete guidance. However, the code examples reference modules (scripts.tone_adjuster, ToneAdjuster class) that may not exist (no bundle files provided), and much of the 'actionable' content is generic workflow boilerplate rather than task-specific executable guidance. The CLI usage and Python examples are concrete but potentially not executable. | 2 / 3 |
Workflow Clarity | The generic 'Workflow' section provides a numbered sequence but is entirely abstract and not specific to tone conversion. The Quality Checklist at the end provides useful validation checkpoints. However, there's no clear feedback loop for verifying medical accuracy after conversion, which is the most critical validation step for this skill. The actual tone conversion workflow is never clearly sequenced. | 2 / 3 |
Progressive Disclosure | The document is a monolithic wall of text with significant redundancy. Multiple sections cover overlapping concerns (Workflow, Implementation Details, Example Usage all describe the same generic process). References to 'references/' directory and 'scripts/main.py' cannot be verified as no bundle files exist. The document mixes genuinely useful domain content (jargon tables, conversion rules) with extensive generic boilerplate that obscures the valuable parts. | 1 / 3 |
Total | 6 / 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 | |
73f6514
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.