CtrlK
BlogDocsLog inGet started
Tessl Logo

medical-email-polisher

Transforms rough email drafts into polished, professional medical correspondence.

25

Quality

16%

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/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 common trigger term variations that users might naturally use.

Suggestions

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

List additional specific actions beyond 'transforms', such as 'adjusts tone, corrects medical terminology, formats salutations and sign-offs, ensures HIPAA-appropriate language.'

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

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, tone adjustment, terminology correction, 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 relevant keywords like 'email', 'drafts', 'medical correspondence', and 'professional', but misses common variations users might say such as 'clinical letter', 'patient communication', 'doctor email', 'healthcare', 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 domain-specific content about medical email polishing. The few relevant details (recipient types, HIPAA awareness, tone adjustment, context templates) are mentioned as bullet points without any concrete examples, templates, or executable demonstrations. The document is bloated with sections like Risk Assessment, Security Checklist, Lifecycle Status, and Response Template that provide no value for the stated task.

Suggestions

Replace boilerplate sections with 2-3 concrete before/after email examples showing transformations for different recipient types (mentor, editor, patient) with specific tone adjustments.

Add actual email templates or transformation rules that demonstrate HIPAA-aware patient communication, formal vs semi-formal tone differences, and opening/closing optimization patterns.

Remove generic sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Response Template) that don't contain task-specific guidance and are wasting token budget.

Eliminate circular self-references ('See ## Features above') and consolidate the three workflow-like sections into a single, concrete step-by-step process specific to email polishing.

DimensionReasoningScore

Conciseness

Extremely verbose and padded with boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) that add no actionable value for Claude. Contains self-referential loops like 'See ## Features above for related details' and 'See ## Prerequisites above for related details' that waste tokens. The actual domain-specific content (email polishing with templates, tone adjustment, HIPAA awareness) is buried under generic scaffolding that Claude already knows.

1 / 3

Actionability

Despite being about transforming email drafts, there are zero concrete examples of input drafts or polished outputs. No actual email templates, no tone adjustment examples, no demonstration of how different recipient types change the output. The 'executable' guidance is just generic 'python scripts/main.py' commands with no real email polishing logic shown. The input/output format table is helpful but insufficient without examples.

1 / 3

Workflow Clarity

The workflow section is entirely generic ('Confirm the user objective', 'Validate that the request matches the documented scope') with no steps specific to email polishing. There are no validation checkpoints for the actual task (e.g., checking tone appropriateness, HIPAA compliance verification for patient emails). Multiple workflow-like sections exist (Example Usage, Implementation Details, Workflow) creating confusion about which to follow.

1 / 3

Progressive Disclosure

References to 'references/' directory and 'scripts/main.py' exist but no bundle files are provided, making these dead references. The document contains circular self-references ('See ## Features above', 'See ## Prerequisites above') which is worse than no references. Content is a monolithic wall of boilerplate sections with no meaningful organization hierarchy.

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.