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

75%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Fix and improve this skill with Tessl

tessl review fix ./scientific-skills/Academic Writing/personal-statement/SKILL.md

Quality

Content

50%

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

The content is structurally organized and includes concrete code, but it is undermined by redundancy (the description is pasted verbatim into multiple sections), a Quick Start that imports a non-existent module contradicting the real `main.py`, and a broken reference to `references/personal-statement-examples.md`. These issues place it in the middle band across all dimensions.

Suggestions

Fix the Quick Start code examples to match the actual `scripts/main.py` API (`PersonalStatement.generate(purpose, experiences, goals)`) instead of the non-existent `PersonalStatementWriter.write/create_outline/frame_experience` methods, so examples are copy-paste executable.

Remove the verbatim re-pastes of the frontmatter description from the 'When to Use' and 'Key Features' sections, and deduplicate the repeated `python -m py_compile scripts/main.py` command across 'Quick Check', 'Audit-Ready Commands', and 'Example Usage'.

Resolve the broken reference: either create `references/personal-statement-examples.md` or change the 'Common Patterns' pointer to the existing `references/guidelines.md`.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient but padded with redundant boilerplate — the frontmatter description is pasted verbatim into both 'When to Use' and 'Key Features', and the same `python -m py_compile scripts/main.py` command is repeated across 'Quick Check', 'Audit-Ready Commands', and 'Example Usage'. Not the lean top anchor, but not a verbose concept-explaining wall of text either.	2 / 3
Actionability	Concrete code examples exist, but the 'Quick Start' imports `from scripts.personal_statement_writer import PersonalStatementWriter` and calls `writer.write(...)` / `writer.create_outline(...)` / `writer.frame_experience(...)` which do not match the actual bundled `scripts/main.py` (which defines `PersonalStatement.generate(...)` with a different signature). The flagship examples are therefore not copy-paste executable as written.	2 / 3
Workflow Clarity	A numbered Workflow is present and 'Error Handling' covers fallbacks, but the steps are generic boilerplate ('Validate that the request matches the documented scope') rather than a sequenced, checkpoint-driven process tied to the actual statement-writing task; no validate-fix-retry loop specific to drafting/optimizing a statement.	2 / 3
Progressive Disclosure	Sections are organized and `references/` is signaled, but the body points to `references/personal-statement-examples.md` which does not exist — the only bundle file is `references/guidelines.md`. A broken reference and inline content that could live in references keep it below the top anchor.	2 / 3
	Total	8 / 12 Passed

Description

100%

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 strong: it states concrete capabilities, includes a natural 'Use when...' trigger covering the main application types, answers both what and when, and occupies a distinctive niche. Third person voice is used throughout, satisfying the voice guideline.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions and artifacts — 'writing medical school personal statements, residency application essays, fellowship statements, or graduate school admissions essays' plus 'Crafts compelling narratives highlighting clinical experiences, research achievements, and career motivations' — matching the multiple-specific-actions anchor.	3 / 3
Completeness	Explicitly answers both what ('Crafts compelling narratives highlighting clinical experiences...') and when ('Use when writing medical school personal statements...'), matching the clear both-what-and-when anchor; the 'Use when...' trigger is present so it is not capped at 2.	3 / 3
Trigger Term Quality	Covers natural terms a user would say — 'medical school personal statements', 'residency application essays', 'fellowship statements', 'graduate school admissions essays' — giving good coverage of common variations, matching the top anchor.	3 / 3
Distinctiveness Conflict Risk	Targets a clear niche (healthcare education admissions essays) with distinct triggers unlikely to fire for unrelated skills, matching the clear-niche anchor.	3 / 3
	Total	12 / 12 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
Commit: 7cc5680

Reviewed: 3 days 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.