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

59%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

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

Quality

Content

31%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 content is undermined by verbatim description repetition, boilerplate sections, code examples that do not match the bundled script, and a broken reference file. The genuinely useful, skill-specific material (structure percentages, character limits, pitfalls) is buried and partly non-actionable.

Suggestions

Remove the verbatim description repeats in 'When to Use' and 'Key Features' and cut the generic boilerplate sections (Implementation Details, Audit-Ready Commands, Output Requirements, Response Template) that add no skill-specific value.

Fix the code examples to match the bundled script: either implement the PersonalStatementWriter API with write/create_outline/optimize_length/adjust_tone in scripts/main.py, or replace the examples with the actual PersonalStatement.generate signature and parameters.

Resolve the broken reference to references/personal-statement-examples.md by either creating that file or removing the pointer, and move the inlined reference material (character-limit table, STAR method, checklist) into references/guidelines.md.

Dimension	Reasoning	Score
Conciseness	The body repeats the full frontmatter description verbatim twice (When to Use and Key Features) and carries heavy templated boilerplate (Implementation Details, Audit-Ready Commands, Output Requirements, Response Template) that pads rather than informs.	2 / 5
Actionability	Code examples reference a non-existent module 'scripts.personal_statement_writer.PersonalStatementWriter' while the bundled scripts/main.py defines class 'PersonalStatement.generate'; the advertised methods (write, create_outline, optimize_length, adjust_tone) do not exist, so the concrete-looking guidance is non-executable.	2 / 5
Workflow Clarity	A numbered Workflow and a Quick Check (py_compile) with a fallback path are present, but validation is limited to a compile check with no output-quality verification and the steps are partly generic.	3 / 5
Progressive Disclosure	The body points to 'references/personal-statement-examples.md' which does not exist in the bundle (only guidelines.md is present), and substantial reference-worthy material (character-limit table, STAR method, checklist, pitfalls) is inlined rather than split out.	2 / 5
	Total	9 / 20 Passed

Description

87%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 is well-constructed: it states explicit trigger conditions, a clear capability statement, and occupies a distinct, low-conflict niche. Minor gains are possible by adding common synonyms and a slightly broader action list.

Dimension	Reasoning	Score
Specificity	Names several concrete actions across multiple document types ('Crafts compelling narratives highlighting clinical experiences, research achievements, and career motivations'), but the core verb set is narrower than a full 5-anchor action list.	4 / 5
Completeness	Explicitly answers both 'when' ('Use when writing...') and 'what' ('Crafts compelling narratives...') with concrete trigger phrases, matching the top anchor.	5 / 5
Trigger Term Quality	Strong natural coverage across 'medical school personal statements, residency application essays, fellowship statements, graduate school admissions essays', but a few common variations (med school, statement of purpose, secondary essays) are absent.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (healthcare education admissions essays) with distinct triggers, so conflict with unrelated skills is minimal.	5 / 5
	Total	18 / 20 Passed

Validation

87%

Warnings & errors only

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

Criteria	Description	Result
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
Commit: 63c61d3

Reviewed: 10 hours ago

Table of Contents

Discovery Implementation Validation

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.