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.
70
63%
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/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 a well-crafted skill description that clearly defines its niche in medical text adaptation and readability conversion. It opens with an explicit 'Use when...' clause containing multiple concrete trigger scenarios, and includes natural keywords that users in healthcare communication would use. The description is concise yet comprehensive, covering both capabilities and activation conditions effectively.
| 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 between tones, translating jargon, adapting research papers, rewriting clinical notes) 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 working in medical communication would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Occupies a clear niche at the intersection of medical domain and tone/readability adaptation. The specificity of 'medical text', 'clinical notes', 'patient-friendly tones' makes it highly 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 suffers from severe verbosity and repetition—the description appears three times, and generic boilerplate sections (Output Requirements, Response Template, Input Validation, Error Handling) consume significant tokens without adding skill-specific value. The core medical tone conversion content (jargon tables, conversion rules, reading levels, best practices, common pitfalls) is genuinely useful but is buried under layers of generic scaffolding. The skill would benefit enormously from removing all boilerplate, consolidating redundant sections, and adding a concrete validation step for medical accuracy.
Suggestions
Remove all generic boilerplate sections (Output Requirements, Response Template, Input Validation, Error Handling, Implementation Details) that don't contain skill-specific guidance—these waste tokens on things Claude already knows.
Consolidate the redundant execution sections (Example Usage, Quick Check, Audit-Ready Commands, Quick Start, CLI Usage) into a single 'Usage' section with the most actionable examples.
Add an explicit medical accuracy validation step in the workflow, e.g., 'After conversion, verify that all clinical facts, dosages, and conditions are preserved—flag any terms where simplification could cause misunderstanding.'
Move the jargon dictionary and detailed conversion examples to a separate reference file and link to it from a concise overview in SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose and repetitive. The description is repeated verbatim in 'When to Use' and 'Key Features'. There are multiple redundant sections (Workflow, Quick Start, Example Usage, Audit-Ready Commands, Quick Check) that overlap significantly. Generic boilerplate sections like 'Output Requirements', 'Response Template', 'Input Validation', and 'Error Handling' add bulk without skill-specific value—Claude already knows how to handle missing inputs and error reporting. | 1 / 3 |
Actionability | The skill provides Python code examples with specific API calls (ToneAdjuster, convert, to_patient_friendly, etc.) and CLI commands, plus a useful jargon translation table. However, it's unclear whether these code examples are actually executable—they reference modules like `scripts.tone_adjuster` and classes like `ToneAdjuster` that may or may not exist. The generic workflow steps (confirm objective, validate request) are abstract rather than concrete. | 2 / 3 |
Workflow Clarity | There is a numbered workflow and a quality checklist, but the main 'Workflow' section is entirely generic (confirm objective, validate scope, return structured result) with no medical-tone-specific steps or validation checkpoints. The 'Example run plan' is similarly generic. No explicit validation step checks whether medical accuracy was preserved after conversion, which is the most critical concern for this skill. | 2 / 3 |
Progressive Disclosure | The content is a monolithic wall of text with many sections that could be consolidated or split into separate files. References to `references/` directory and `scripts/main.py` are vague with no clear signaling of what those contain. Multiple sections repeat similar content (Quick Start vs Example Usage vs CLI Usage; Workflow vs Implementation Details). The document is poorly organized with no clear hierarchy between overview and detail. | 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 | |
8277276
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.