Generates professional cover letters for journal submissions and job.
43
30%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/Academic Writing/cover-letter-drafter/SKILL.mdQuality
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'.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
0b96148
Table of Contents
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.