CtrlK
BlogDocsLog inGet started
Tessl Logo

medical-email-polisher

Transforms rough email drafts into polished, professional medical correspondence.

32

Quality

16%

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/medical-email-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 clear domain (medical email correspondence) and a core action (polishing rough drafts), which gives it moderate specificity and distinctiveness. However, it lacks an explicit 'Use when...' clause, lists only a single action rather than multiple concrete capabilities, and misses natural trigger term variations that users might employ.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks to polish, rewrite, or improve a medical email, clinical correspondence, or healthcare-related message.'

List more specific concrete actions, e.g., 'Adjusts tone, corrects medical terminology, structures greeting and sign-off, ensures HIPAA-appropriate language.'

Include additional natural trigger terms users might say, such as 'doctor email', 'clinical letter', 'patient correspondence', 'healthcare communication', or 'polish my medical email'.

DimensionReasoningScore

Specificity

It names the domain (medical correspondence) and one action (transforms rough drafts into polished versions), but does not list multiple specific concrete actions like formatting, adding salutations, structuring sections, etc.

2 / 3

Completeness

It describes what the skill does (transforms rough drafts into polished medical correspondence) but has no explicit 'Use when...' clause or equivalent trigger guidance, which per the rubric should cap completeness at 2, and since the 'when' is entirely missing, it scores a 1.

1 / 3

Trigger Term Quality

Includes some relevant keywords like 'email drafts', 'medical correspondence', and 'professional', but misses common variations users might say such as 'doctor letter', 'clinical email', 'patient communication', 'healthcare email', or 'polish my email'.

2 / 3

Distinctiveness Conflict Risk

The combination of 'medical' and 'email drafts' provides some specificity, but it could overlap with general email polishing skills or general medical writing skills without clearer boundaries.

2 / 3

Total

7

/

12

Passed

Implementation

0%

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

This skill is almost entirely generic boilerplate with minimal content specific to medical email polishing. The actual domain-relevant sections (Features, Input Parameters, Output Format) are brief and buried under extensive template filler including risk assessments, security checklists, lifecycle status, and abstract workflow steps. There are no concrete examples of email transformations, no demonstration of tone adjustments, and no actionable guidance on how to actually polish medical correspondence.

Suggestions

Replace the abstract workflow with concrete email transformation examples showing before/after for each recipient type (mentor, editor, colleague, patient) with specific tone and formatting changes.

Remove all generic boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) that don't provide skill-specific guidance and are wasting token budget.

Add concrete examples of HIPAA-aware patient communication transformations, tone adjustment demonstrations, and opening/closing optimization patterns.

Eliminate circular self-references ('See ## Features above') and reorganize so the most actionable content (features, examples, input/output format) appears first.

DimensionReasoningScore

Conciseness

Extremely verbose and padded with boilerplate sections that add no value for this specific skill. Contains redundant cross-references to sections within the same document ('See ## Features above'), generic risk assessments, security checklists, lifecycle status, and evaluation criteria that are template filler rather than actionable content. The actual skill-specific content (email polishing) is buried under layers of generic project management boilerplate.

1 / 3

Actionability

Despite being about transforming email drafts, there are zero concrete examples of input drafts or polished outputs. The 'Example Usage' section only shows how to run a Python script, not how to actually polish an email. No example transformations, no tone adjustment demonstrations, no template examples for different recipient types. The workflow steps are entirely abstract.

1 / 3

Workflow Clarity

The workflow section contains only generic, abstract steps like 'Confirm the user objective' and 'Validate that the request matches the documented scope' with no specifics about the email polishing process. There are no concrete steps for how to transform a draft email, no validation of the polished output quality, and no feedback loops for iterating on tone or content. The actual email transformation process is completely undefined.

1 / 3

Progressive Disclosure

The document is a monolithic wall of text with 15+ sections, many of which are redundant or contain cross-references to other sections within the same file ('See ## Features above', 'See ## Prerequisites above', 'See ## Workflow above'). These circular self-references add confusion rather than structure. Content is poorly organized with the most relevant sections (Features, Input Parameters, Output Format) buried deep in the document.

1 / 3

Total

4

/

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.