CtrlK
BlogDocsLog inGet started
Tessl Logo

cover-letter-drafter

Generates professional cover letters for journal submissions and job.

30

Quality

23%

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/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 truncated ('job' appears to be missing a completing word like 'applications') and lacks a 'Use when...' clause, making it incomplete. While it identifies a reasonably specific domain (cover letters), it fails to list concrete actions or provide trigger guidance for skill selection. The description needs significant improvement to be effective in a multi-skill environment.

Suggestions

Complete the truncated sentence (e.g., 'job applications') and add specific actions like 'drafts, formats, and tailors cover letters to specific positions or journals'.

Add a 'Use when...' clause with trigger terms like 'cover letter', 'application letter', 'journal submission letter', 'manuscript cover letter', 'job application'.

Include more natural keyword variations users might say, such as 'application letter', 'letter of interest', 'submission letter', or 'hiring manager'.

DimensionReasoningScore

Specificity

Names the domain (cover letters) and two contexts (journal submissions and job), but doesn't list specific 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 explicit trigger guidance, which per the rubric caps completeness at 2, and the 'what' 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 some natural keywords like 'cover letters', 'journal submissions', and 'job', but misses common variations such as 'application letter', 'job application', 'manuscript submission', 'hiring', or 'resume'.

2 / 3

Distinctiveness Conflict Risk

Cover letters are a reasonably specific niche, but the description is vague enough that it could overlap with general writing or resume skills. The truncated 'job' makes the scope unclear.

2 / 3

Total

7

/

12

Passed

Implementation

14%

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 that obscures the useful content (CLI parameters, usage examples, output format). The document suffers from severe repetition with multiple overlapping sections covering the same ground, self-referential cross-references within the same file, and extensive template filler (security checklists, risk assessments, lifecycle status) that add no task-specific value. The actionable core—about 30% of the content—is solid but buried.

Suggestions

Remove all generic boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Response Template) that don't contain task-specific information Claude needs to generate cover letters.

Eliminate redundant self-referencing ('See ## Features above') and consolidate the three overlapping workflow sections (Example Usage run plan, Implementation Details, Workflow) into a single clear sequence.

Add a validation checkpoint after cover letter generation, such as checking word count, verifying all key points were addressed, and confirming the tone matches the purpose (journal vs. job vs. fellowship).

Move the Parameters table, Usage examples, and Output Format to the top of the document as the primary content, since these are the most actionable elements.

DimensionReasoningScore

Conciseness

Extremely verbose and repetitive. Multiple sections restate the same information (e.g., 'See ## Features above' cross-references that add nothing, repeated py_compile commands in multiple sections, generic boilerplate about error handling, security checklists, lifecycle status, and risk assessment that Claude already knows). The actual task-specific content (parameters, usage examples, output format) is buried under layers of generic template filler.

1 / 3

Actionability

The Parameters table, Usage section with concrete CLI examples, and Output Format JSON are genuinely actionable and copy-paste ready. However, much of the workflow guidance is generic and vague ('validate the request, choose the packaged workflow'), and the skill lacks executable code showing how the cover letter generation actually works internally. The concrete CLI examples save it from a 1.

2 / 3

Workflow Clarity

There are multiple competing workflow sections (Example Usage run plan, Implementation Details, Workflow) that overlap and contradict each other in terms of ordering and emphasis. None provide clear validation checkpoints specific to cover letter generation. The workflows are generic templates ('Confirm the user objective') rather than task-specific sequences. No feedback loop for reviewing/iterating on the generated cover letter quality.

1 / 3

Progressive Disclosure

The document contains self-referential cross-references that point to sections within the same file ('See ## Features above', 'See ## Prerequisites above', 'See ## Usage above'), which is confusing and adds no value. References to 'references/' directory are vague with no specifics about what's there. No bundle files are provided, and the monolithic structure dumps everything—including security checklists, lifecycle status, and evaluation criteria—into one long document without meaningful organization.

1 / 3

Total

5

/

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.