CtrlK
BlogDocsLog inGet started
Tessl Logo

response-tone-polisher

Polishes response letters by transforming defensive or harsh language.

41

Quality

27%

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/response-tone-polisher/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

32%

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

The description identifies a reasonably specific niche—polishing response letters with defensive or harsh tone—but lacks explicit trigger guidance ('Use when...') and could benefit from more concrete actions and natural keyword variations. It is too brief to reliably distinguish itself from general writing or tone-improvement skills.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks to soften, rewrite, or improve the tone of a response letter, complaint reply, or formal correspondence.'

Include more natural trigger terms users might say, such as 'soften tone', 'rewrite reply', 'professional response', 'diplomatic language', 'complaint response'.

List additional specific actions, e.g., 'Replaces accusatory phrasing with neutral alternatives, restructures confrontational sentences, and adjusts tone to be empathetic and professional.'

DimensionReasoningScore

Specificity

Names the domain (response letters) and a general action (transforming defensive/harsh language), but doesn't list multiple specific concrete actions like what the transformation produces or specific techniques used.

2 / 3

Completeness

Describes what it does (polishes response letters by transforming defensive/harsh language) but has no explicit 'Use when...' clause or equivalent trigger guidance, which per the rubric caps completeness at 2, and the 'what' itself is also somewhat thin, bringing it to 1.

1 / 3

Trigger Term Quality

Includes some relevant terms like 'response letters', 'defensive', 'harsh language', and 'polishes', but misses common variations users might say such as 'tone', 'soften', 'rewrite', 'professional', 'diplomatic', or 'complaint response'.

2 / 3

Distinctiveness Conflict Risk

The focus on 'response letters' and 'defensive or harsh language' provides some specificity, but could overlap with general tone-editing, writing improvement, or email polishing skills.

2 / 3

Total

7

/

12

Passed

Implementation

22%

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

This skill contains genuinely useful domain content (tone transformation tables, polite academic expressions, before/after examples) but buries it under massive amounts of generic boilerplate that has nothing to do with tone polishing. The workflow section is entirely generic and fails to describe the actual polishing process. The file is roughly 3x longer than it needs to be, with sections like Risk Assessment, Security Checklist, Lifecycle Status, and Evaluation Criteria adding no value for this specific skill.

Suggestions

Remove all generic boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Output Requirements, Response Template, Input Validation, Error Handling) that are not specific to tone polishing—these waste tokens on content Claude already knows.

Replace the generic 'Workflow' section with a tone-polishing-specific workflow: identify defensive phrases → classify issue type → apply transformation patterns → verify scientific position preserved → output structured result.

Move the extensive expression library and transformation patterns to a referenced file (e.g., references/tone_patterns.md) and keep only 2-3 representative examples inline to demonstrate the pattern.

Fix section ordering so Overview comes first, remove circular/broken cross-references ('See ## Prerequisites above' when it appears below), and consolidate duplicate content (the intro and Overview say the same thing).

DimensionReasoningScore

Conciseness

Extremely verbose and bloated. Contains massive amounts of boilerplate (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Output Requirements, Response Template, Input Validation) that are generic filler not specific to tone polishing. The skill explains concepts Claude already knows and repeats itself across sections (e.g., 'Overview' restates the intro, 'Workflow' is generic project management boilerplate). Easily 3x longer than needed.

1 / 3

Actionability

The transformation table and before/after examples are genuinely useful and concrete. The Python API example and CLI usage are specific. However, much of the 'actionable' content is generic boilerplate (e.g., the workflow section is not specific to tone polishing at all), and it's unclear whether scripts/main.py actually exists or is just aspirational. The core value—the tone patterns and expression library—is actionable but buried in noise.

2 / 3

Workflow Clarity

The 'Workflow' section is entirely generic project management boilerplate ('Confirm the user objective, required inputs...') with no specificity to tone polishing. There is no clear sequence for how to actually polish a response—no steps like 'identify defensive phrases → classify tone → apply transformations → verify position preserved.' The Quality Checklist is useful but disconnected from any workflow. Missing validation/feedback loops for the actual polishing process.

1 / 3

Progressive Disclosure

References to external files (references/polite_expressions.json, references/tone_patterns.md, references/examples/) are present and one-level deep. However, the SKILL.md itself is monolithic with enormous inline content that should be split out (the full expression library, the transformation tables, the security checklist, etc.). Section ordering is poor—'Overview' appears after 'Implementation Details' and 'Quick Check', and there are circular references ('See ## Prerequisites above' when Prerequisites appears below).

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