CtrlK
BlogDocsLog inGet started
Tessl Logo

medical-email-polisher

Transforms rough email drafts into polished, professional medical correspondence.

37

Quality

35%

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

Content

12%

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

This skill is overwhelmingly generic boilerplate with almost no domain-specific content about medical email polishing. The actual useful information (context templates, tone adjustment, HIPAA-aware communication, input/output format) comprises maybe 15% of the document and lacks any concrete examples or transformation rules. The majority of the content is reusable scaffolding (risk assessment, security checklist, lifecycle status, response templates) that wastes tokens without teaching Claude how to actually polish medical emails.

Suggestions

Replace the generic boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) with concrete email transformation examples showing before/after for each recipient type (mentor, editor, colleague, patient).

Add specific tone adjustment rules and examples—show what 'formal' vs 'semi-formal' looks like in medical correspondence, with concrete phrasing patterns.

Include HIPAA-specific guidance with examples of what to avoid in patient communications and how to rephrase common patterns.

Fix the circular 'See above' references and restructure so the most actionable content (Features, Input Parameters, Output Format, examples) appears first, with administrative sections removed or minimized.

DimensionReasoningScore

Conciseness

Extremely verbose and padded with boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) that add no actionable value for Claude. Multiple self-referential 'See above' links point to sections that appear later. The actual domain-specific content (email polishing with templates, tone adjustment, HIPAA awareness) is buried under generic scaffolding. Most sections explain things Claude already knows or repeat generic project management patterns.

1 / 3

Actionability

Despite being about transforming email drafts, there are zero concrete examples of input drafts, polished outputs, or transformation rules. The code examples are limited to `py_compile` and `--help` commands. No actual email polishing logic, template examples, or tone adjustment guidance is provided—just vague references to scripts and a generic workflow.

1 / 3

Workflow Clarity

There is a numbered workflow with steps for confirming inputs, validating scope, executing, and handling failures. Error handling and input validation sections provide some fallback guidance. However, the workflow is entirely generic and not specific to email polishing. There are no validation checkpoints specific to the output quality (e.g., checking tone, HIPAA compliance, grammar).

2 / 3

Progressive Disclosure

Multiple sections contain circular 'See above' references (e.g., 'See `## Features` above' when Features appears below, 'See `## Prerequisites` above' when Prerequisites appears below). References to `scripts/main.py` and `references/` directory exist but no bundle files are provided, making these dead references. The document is a monolithic wall of boilerplate with poor organization—domain-specific content like Features and Input Parameters is buried deep.

1 / 3

Total

5

/

12

Passed

Description

57%

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 clearly identifies a specific niche—polishing medical email drafts—which gives it strong distinctiveness. However, it lacks an explicit 'Use when...' clause and could benefit from listing more concrete actions and natural trigger terms that users might employ when seeking this skill.

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 more specific actions such as 'adjusts tone, corrects medical terminology, formats salutations and sign-offs, ensures HIPAA-appropriate language' to improve specificity.

Include additional natural trigger terms like 'clinical letter', 'patient email', 'doctor correspondence', 'healthcare email' to improve keyword coverage.

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

The 'what' is reasonably clear (transforms rough drafts into polished medical emails), but there is no explicit 'Use when...' clause or equivalent trigger guidance, which caps this at 2 per the rubric.

2 / 3

Trigger Term Quality

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

2 / 3

Distinctiveness Conflict Risk

The combination of 'medical correspondence' and 'email drafts' creates a clear niche that is unlikely to conflict with general writing, general email, or general medical skills. It occupies a distinct intersection.

3 / 3

Total

9

/

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.