CtrlK
BlogDocsLog inGet started
Tessl Logo

cover-letter-drafter

Generates professional cover letters for journal submissions and job.

43

Quality

30%

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/cover-letter-drafter/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 is incomplete and appears truncated ('job' seems to be missing a following word like 'applications'). It identifies a reasonable niche but lacks explicit trigger guidance, specific actions, and sufficient keyword coverage to reliably distinguish it from other writing-related skills.

Suggestions

Complete the truncated sentence (e.g., 'job applications') and add a 'Use when...' clause such as 'Use when the user asks for help writing a cover letter, application letter, or submission letter for academic journals or job applications.'

Add specific concrete actions like 'drafts, formats, and tailors cover letters to specific job postings or journal guidelines'.

Include more natural trigger terms such as 'application letter', 'manuscript submission', 'job application', 'hiring manager', and 'submission letter'.

DimensionReasoningScore

Specificity

Names the domain (cover letters) and two contexts (journal submissions and job), but doesn't list specific concrete actions like drafting, formatting, tailoring to job descriptions, or customizing for specific journals.

2 / 3

Completeness

Describes what it does (generates cover letters) but has no 'Use when...' clause or equivalent explicit trigger guidance, which per the rubric caps completeness at 2, and the 'what' itself is also incomplete (the sentence appears truncated — 'job' seems to be missing a word like 'applications'). The lack of any 'when' guidance drops this to 1.

1 / 3

Trigger Term Quality

Includes 'cover letters', 'journal submissions', and 'job' which are relevant keywords, but misses common variations like 'application letter', 'job application', 'manuscript submission', 'cover page', or 'hiring manager'.

2 / 3

Distinctiveness Conflict Risk

Cover letters for journal submissions is a fairly specific niche, but the vague 'job' term could overlap with resume/CV skills or general writing skills. More specificity would reduce conflict risk.

2 / 3

Total

7

/

12

Passed

Implementation

27%

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

This skill is heavily padded with generic boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Response Template) that are not specific to cover letter drafting and waste significant token budget. The useful content—parameter definitions, usage examples, and output format—is buried among repetitive and circular cross-references. The skill would benefit enormously from stripping away generic scaffolding and focusing on the specific domain knowledge needed to generate quality cover letters.

Suggestions

Remove all generic boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Response Template, Output Requirements) that don't contain cover-letter-specific guidance—these waste tokens on information Claude already knows or that belongs in project-level documentation.

Eliminate circular self-references like 'See ## Features above' and 'See ## Usage above' which add confusion and token overhead without providing any value.

Add domain-specific guidance on what makes a good cover letter for each type (journal, job, fellowship)—e.g., key structural elements, tone expectations, common pitfalls—rather than relying entirely on the opaque scripts/main.py.

Consolidate the duplicated workflow sections (Example Usage run plan + Workflow section) into a single clear sequence with an explicit validation step for the generated cover letter content quality.

DimensionReasoningScore

Conciseness

Extremely verbose and repetitive. Multiple sections reference each other circularly ('See ## Features above', 'See ## Usage above', 'See ## Prerequisites above'). Boilerplate sections like Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, and Response Template add significant token overhead without providing actionable value for generating cover letters. Much content is generic scaffolding not specific to this skill.

1 / 3

Actionability

The Usage section provides concrete, executable command examples with specific flags for journal, job, and fellowship cover letters, and the Parameters table is well-defined. However, the actual cover letter generation logic is opaque (delegated entirely to scripts/main.py), and much of the 'workflow' content is generic process boilerplate rather than specific guidance on how to draft quality cover letters.

2 / 3

Workflow Clarity

There is a numbered workflow and an example run plan with steps, but the workflow is generic and not specific to cover letter drafting. Validation is limited to 'py_compile' syntax checking rather than output quality validation. The error handling section mentions fallbacks but doesn't provide concrete recovery steps. No validation checkpoint for the generated cover letter content itself.

2 / 3

Progressive Disclosure

The document is a monolithic wall of text with numerous sections that could be separated or eliminated. Circular self-references ('See ## Features above') are confusing and add no value. The content mixes quick-start guidance with security checklists, lifecycle metadata, evaluation criteria, and response templates all in one file with no clear navigation hierarchy or external file references.

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