CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

personal-statement

Use when writing medical school personal statements, residency application essays, fellowship statements, or graduate school admissions essays. Crafts compelling narratives highlighting clinical experiences, research achievements, and career motivations for healthcare education applications.

Quality

65%

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/personal-statement/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

42%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 domain content — structure percentages, STAR framing, the AMCAS/ERAS character-limit table, and cliché pitfalls — is genuinely useful, but it is buried in generic template padding and undermined by a Quick Start that imports an API which does not exist in the bundle. The shipped `scripts/main.py` exposes a completely different, far shallower interface than the documented one, and the main examples reference is a missing file.

Suggestions

Make the code examples match the bundle: either implement `PersonalStatementWriter` with `write/create_outline/frame_experience/optimize_length/adjust_tone` in `scripts/main.py`, or rewrite the Quick Start around the actual `PersonalStatement.generate()` API.

Delete the template boilerplate sections ('Implementation Details', 'Audit-Ready Commands', 'Output Requirements', 'Input Validation', 'Response Template') and the duplicated description text in 'When to Use'/'Key Features'; keep only the domain-specific material to fix conciseness.

Fix the broken reference: either add `references/personal-statement-examples.md` with the promised example categories or point 'Common Patterns' at the existing `references/guidelines.md`, and give that file real content instead of a two-bullet stub.

DimensionReasoningScore

Conciseness

Roughly half the body is generic template filler — 'When to Use' restates the description verbatim twice ('Use this skill when the task needs Use when writing medical school personal statements...'), and 'Implementation Details', 'Audit-Ready Commands', 'Output Requirements', 'Input Validation', and 'Response Template' contain boilerplate that adds nothing specific to this skill. The same py_compile command also appears three times. This matches anchor 2 ('several unnecessary explanations or padded sections') rather than anchor 3's single instance of excess.

2 / 5

Actionability

The body offers concrete-looking guidance (character limit table, STAR method, cliché examples, a runnable py_compile command), but the centerpiece Quick Start and capability snippets call a `PersonalStatementWriter` class with methods like `write()` and `optimize_length()` that do not exist — the actual bundle's `scripts/main.py` defines `PersonalStatement.generate()` with a different signature. Per the rubric's code-example rule these are effectively non-executable against the shipped code, matching anchor 3 ('missing key details / not actually executable') and not anchor 4.

3 / 5

Workflow Clarity

Two competing execution paths are presented — the nonexistent `scripts/personal_statement_writer` API and `scripts/main.py` (whose only invocation shown is a no-argument demo run) — with no reconciliation, and 'See `## Workflow` above for related details' is a circular pointer. A validation step exists (`python -m py_compile scripts/main.py`) but no feedback loop connects the two paths, matching anchor 3 ('sequence present but checkpoints missing or implicit') rather than anchor 4's coherent, mostly-checkpointed sequence.

3 / 5

Progressive Disclosure

The body has section structure and points to `references/`, but the referenced `references/personal-statement-examples.md` ('See references/personal-statement-examples.md for: Medical School (MD/DO) Examples...') does not exist in the bundle — only a two-bullet stub `references/guidelines.md` is present — so the primary reference is broken, and ~90 lines of template boilerplate sit inline in SKILL.md instead of being trimmed or split. This matches anchor 3 ('references present but not clearly signaled; content that should be separate is inline'); it avoids anchor 2 only because headers and a one-level-deep reference intent exist.

3 / 5

Total

11

/

20

Passed

Description

73%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.

A solid description with strong, natural trigger terms covering all four application types and a clearly distinguishable niche. Its main weakness is that the 'what' half rests on the vague phrase 'crafts compelling narratives' instead of enumerating the concrete capabilities (structure generation, STAR framing, length optimization, tone adjustment) the skill actually provides.

Suggestions

Replace 'Crafts compelling narratives' with concrete verbs matching the skill's real capabilities, e.g. 'Drafts, structures, and edits personal statements with experience framing (STAR), character-limit optimization, and tone adjustment'.

Add common applicant vocabulary such as 'med school essay', 'AMCAS/ERAS personal statement' to broaden natural trigger coverage toward anchor 5.

DimensionReasoningScore

Specificity

The description names the domain and one action — "Crafts compelling narratives highlighting clinical experiences, research achievements, and career motivations" — but 'compelling narratives' is soft, generic language and capabilities like outlining, tone adjustment, or length optimization are absent. It matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) and falls short of anchor 4's 'several specific actions' list.

3 / 5

Completeness

Both parts are present: 'Use when writing medical school personal statements, residency application essays...' answers 'when' with concrete triggers, and 'Crafts compelling narratives highlighting clinical experiences, research achievements, and career motivations' answers 'what'. The 'what' clause leans on buzzwords rather than the multiple concrete actions of anchor 5's example, so it sits at anchor 4.

4 / 5

Trigger Term Quality

Phrases like "medical school personal statements", "residency application essays", "fellowship statements", and "graduate school admissions essays" are exactly what an applicant would say, giving good coverage. Minor natural variations (e.g. 'med school essay', 'AMCAS', 'ERAS personal statement') are missing, so it does not reach anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

This is a clear niche — admissions essays for healthcare education — with distinct triggers that would not fire for general writing, editing, or document skills. It matches anchor 5's 'clear niche with distinct triggers; minimal conflict risk'; overlap with a generic essay-writing skill is unlikely given the program-type keywords.

5 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

aipoch/medical-research-skills

Path

scientific-skills/Academic Writing/personal-statement/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.