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.

56

Quality

63%

Does it follow best practices?

Impact

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 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.

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, 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.

DimensionReasoningScore

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.

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.