CtrlK
BlogDocsLog inGet started
Tessl Logo

tone-adjuster

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

Quality

63%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./scientific-skills/Academic Writing/tone-adjuster/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
aipoch/medical-research-skills
Reviewed

Table of Contents

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.