CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cover-letter-drafter

Generates professional cover letters for journal submissions and job.

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./scientific-skills/Academic Writing/cover-letter-drafter/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%Weight 40%Scale 1-5

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

The body delivers genuinely actionable material — a full parameter table, executable per-mode commands, and a defined output format — but wraps it in substantial duplicated boilerplate and circular self-references that waste context. The bundled reference file is effectively dead weight: never linked by name and nearly empty.

Suggestions

Collapse the duplicated command sections (Quick Check, Audit-Ready Commands, and the compile check inside Example Usage) into one verification section, and delete the circular "See `## X` above for related details" lines.

Replace the generic "`references/` contains supporting rules" mentions with a direct link (e.g., "See [guidelines.md](references/guidelines.md) for letter conventions") and populate that file with real guidance instead of three placeholder bullets.

Fix the `cd "20260318/scientific-skills/..."` path to the actual package location (or make it relative) and show a short sample of the expected JSON output for at least one mode.

DimensionReasoningScore

Conciseness

The body is noticeably padded: circular pointers like "See `## Features` above for related details" (repeated for Prerequisites, Usage, and Workflow), the same `python -m py_compile scripts/main.py` check duplicated across Example Usage, Quick Check, AND Audit-Ready Commands, plus boilerplate Risk Assessment, Security Checklist, Evaluation Criteria, and Lifecycle Status sections that add little actionable value. It is not anchor 1 because it does not explain concepts Claude already knows and its Parameters/Usage/Output sections carry real content.

2 / 5

Actionability

The Usage section gives copy-paste-ready commands for all three modes (e.g., `python scripts/main.py --purpose journal --recipient "Nature Medicine" --key-points "Novel findings,Clinical relevance" ...`), backed by a complete Parameters table and an explicit Output Format spec. It falls short of anchor 5 because the `cd "20260318/scientific-skills/Academic Writing/cover-letter-drafter"` path does not match the actual package layout and expected outputs are never shown.

4 / 5

Workflow Clarity

The Workflow section sequences the process (confirm inputs, validate scope, run the packaged script, return a structured result, fall back on failure) and includes a concrete pre-flight checkpoint (`python -m py_compile scripts/main.py`) plus an explicit fallback path. It is not anchor 5 because the validation steps are largely abstract ("Validate that the request matches the documented scope") and the sequence is duplicated across Workflow, Example run plan, and Implementation Details rather than stated once.

4 / 5

Progressive Disclosure

The bundle provides `references/guidelines.md`, but the body only gestures at it generically ("Reference material available in `references/`" / "`references/` contains supporting rules, prompts, or checklists") without naming or linking the file, and the file itself contains only three vague bullets ("Journal submission cover letter best practices") with no actual guidance. References are present but not clearly signaled, matching anchor 3 rather than anchor 4's "references mostly clear".

3 / 5

Total

13

/

20

Passed

Description

61%Weight 40%Scale 1-5

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 states a clear, concrete capability in a distinct niche with natural trigger terms, but it omits any "when to use" guidance and misses part of the skill's actual scope (fellowship letters). Adding an explicit trigger clause and the full range of letter types would lift it substantially.

Suggestions

Add a "Use when..." clause, e.g., "Use when the user asks for a cover letter for a journal submission, academic or medical job application, or fellowship (e.g., NIH K99)."

Include the fellowship use case and natural variations like "job application letter" or "manuscript submission letter" to broaden trigger-term coverage.

Clarify the deliverable form (e.g., that it produces a formatted letter plus subject line via a packaged script) to sharpen the "what" beyond a single verb.

DimensionReasoningScore

Specificity

"Generates professional cover letters for journal submissions and job" names the domain and one concrete action (generating cover letters) but is not comprehensive — fellowship letters, a documented feature in the body, are absent from the description. It matches anchor 3 (domain plus 1-2 concrete actions) and not anchor 4, which requires several specific actions.

3 / 5

Completeness

The description gives a clear "what" ("Generates professional cover letters for journal submissions and job") but has no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not anchor 4 because the "when" is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

"cover letters", "journal submissions", and "job" are natural phrases users would say when needing this skill. It falls short of anchor 5 because common variations and synonyms are missing (e.g., "job application", "fellowship", "application letter"), but exceeds anchor 3 because the core natural terms are all present.

4 / 5

Distinctiveness Conflict Risk

Cover-letter drafting for journal submissions and job applications is a fairly distinct niche with minor overlap risk against broader academic-writing or general writing skills. It matches anchor 4 (mostly distinct, minor overlap risk) rather than anchor 5 because the short description lacks explicit trigger phrases that would fully disambiguate it from adjacent writing-assistance skills.

4 / 5

Total

14

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

aipoch/medical-research-skills

Path

scientific-skills/Academic Writing/cover-letter-drafter/SKILL.md

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.