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

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

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

Quality

Content

42%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body contains genuinely useful tone-conversion material (conversion rules, example pairs, jargon dictionary, pitfalls), but it is buried under ~50% generic template boilerplate and documents an API and CLI that do not match the bundled scripts/main.py, so a user following Quick Start or the CLI examples would fail. The reference file is never named and reference-worthy content is inlined.

Suggestions

Delete the generic template sections (Output Requirements, Error Handling, Input Validation, Response Template, Implementation Details, and the duplicate description text in When to Use / Key Features) so only tone-adjuster-specific guidance remains.

Rewrite the code and CLI examples against the actual bundle: import ToneAdjuster from scripts/main.py, document its real API 'adjust(text, target_tone, level)' and CLI 'python scripts/main.py "<text>" <tone>', and remove the '--input/--direction/--assess/--help/demo' invocations and scripts/tone_adjuster.py references that don't exist.

Consolidate the overlapping 'Example run plan', 'Workflow', and 'Audit-Ready Commands' sections into one tone-conversion workflow with a concrete output-validation step (e.g., re-check reading level and jargon count after conversion), and move the jargon dictionary/examples tables into references/guidelines.md, linking it by name.

DimensionReasoningScore

Conciseness

Roughly half the body is generic template boilerplate that assumes no competence and adds nothing tone-specific: 'Output Requirements', 'Error Handling', 'Input Validation', 'Response Template', plus circular filler like 'See `## Workflow` above for related details' and the frontmatter description pasted verbatim into 'When to Use' and 'Key Features'. Not 1 because the medical sections (conversion rules, examples table, jargon dictionary, pitfalls) carry real, non-generic content.

2 / 5

Actionability

The guidance looks concrete but is not executable against the actual bundle: Quick Start imports 'from scripts.tone_adjuster import ToneAdjuster' (file does not exist; the real module is scripts/main.py), calls nonexistent methods 'convert()', 'to_patient_friendly()', 'assess_reading_level()', 'translate_jargon()', the CLI block uses 'python scripts/tone_adjuster.py --input ... --direction ...' and 'python scripts/main.py --help' / 'demo' which the real argparse-free CLI does not support, and the to_patient_friendly example contains a broken multi-line string literal. This matches the anchor of concrete-looking guidance that is effectively pseudocode relative to the real implementation.

3 / 5

Workflow Clarity

Steps exist ('Example run plan', 'Workflow', 'Quick Check', 'Audit-Ready Commands') with a py_compile checkpoint, but they are generic process boilerplate ('Confirm the user objective... validate the request... return a structured result') duplicated across two overlapping run-plan sections, none specific to tone conversion, and there is no output validation (how to verify medical accuracy or achieved reading level, per its own Quality Checklist). This lands on the anchor of 'steps listed but checkpoints missing or implicit'.

3 / 5

Progressive Disclosure

Section structure exists, but the body never names or links the actual bundle file references/guidelines.md (only 'Reference material available in `references/` for task-specific guidance'), while content that belongs in a reference file — the jargon dictionary JSON, the academic↔patient examples table, best practices — is inlined (~270-line body). This matches 'references present but not clearly signaled; content that should be separate is inline'.

3 / 5

Total

11

/

20

Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete bidirectional actions, an explicit 'Use when...' clause with multiple natural trigger scenarios, and a clearly bounded medical domain. Its only weaknesses are a few missing synonyms ('plain language', 'simplify', 'lay summary') and slight overlap risk with general plain-language rewriting skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — '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' — plus 'Maintains medical accuracy while adjusting readability level', giving comprehensive coverage of the skill's domain. Not 4 because coverage is broad and bidirectional rather than having minor gaps.

5 / 5

Completeness

Explicitly answers both: what ('converting... tones', 'translating medical jargon', 'maintains medical accuracy while adjusting readability level') and when ('Use when converting... adapting research papers... rewriting clinical notes for patient handouts') with four concrete trigger scenarios. Clearly matches the anchor-5 example structure.

5 / 5

Trigger Term Quality

Good natural-term coverage: 'medical jargon', 'patient handouts', 'clinical notes', 'research papers', 'patient-friendly'. Not 5 because common synonyms users would say — 'plain language', 'simplify', 'lay summary', 'health literacy' — are missing; not 3 because the phrases present are ones users naturally say.

4 / 5

Distinctiveness Conflict Risk

The medical tone-conversion niche ('clinical notes', 'patient handouts', 'medical jargon') is well-delineated with distinct triggers. Not 5 because 'translating medical jargon' and 'adjusting readability' carry minor overlap risk with generic plain-language or writing-assistant skills.

4 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

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.