residency-interview-prep

Mock interview preparation tool for residency Match interviews. Generates.

Quality

45%

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/residency-interview-prep/SKILL.md

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 skill pairs a genuine, runnable script with concrete parameter and output schemas, but the SKILL.md body is dominated by generic template filler and cross-reference placeholders that crowd out residency-specific guidance. Documented commands also drift from the actual script interface.

Suggestions

Remove or relocate the generic boilerplate sections (Risk Assessment, Security Checklist, Evaluation Criteria, Lifecycle Status, Response Template) and the "See ## X above" placeholders to tighten the body.

Correct the usage examples to match main.py's actual interface, e.g. `python scripts/main.py behavioral`, and drop the non-existent `--help` flag and the misleading `demo` argument.

Link the reference bundle specifically, e.g. "See [references/guidelines.md](references/guidelines.md) for the NRMP/AAMC resource list and STAR-method guidance," instead of pointing only at the `references/` directory.

Dimension	Reasoning	Score
Conciseness	The body is padded with generic boilerplate (Risk Assessment, Security Checklist, Evaluation Criteria, Lifecycle Status, Response Template) and "See ## X above" cross-reference placeholders that add tokens without residency-specific value.	2 / 5
Actionability	Concrete commands and a real script are present, but documented usage (`--help`, `demo`) does not match main.py, which takes a positional question_type argument and silently falls back to behavioral on unknown values.	3 / 5
Workflow Clarity	A 5-step workflow with a fallback path and early-stop exists, but checkpoints are abstract ("validate that the request matches the documented scope") rather than concrete validation commands woven into the sequence.	3 / 5
Progressive Disclosure	A real bundle exists (references/guidelines.md, scripts/main.py) and is referenced by path with clear headers, but references are signaled only at the directory level (no specific file links) and large amounts of generic boilerplate are inlined rather than split out.	3 / 5
	Total	11 / 20 Passed

Description

48%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 names a specific niche but is undermined by a truncated "Generates." fragment and a total absence of trigger guidance. It reads as an incomplete template field rather than a polished skill description.

Suggestions

Complete the "Generates." fragment into concrete actions, e.g. "Generates behavioral, clinical, program-specific, and ethical interview questions with STAR-format guidance and response feedback."

Add an explicit "Use when..." trigger clause naming natural phrases users would say, e.g. "Use when preparing for residency Match interviews, NRMP interviews, or mock interview practice."

Include common synonyms and the process name (NRMP, Match, interview practice) to broaden trigger-term coverage.

Dimension	Reasoning	Score
Specificity	The domain is clearly named ("mock interview preparation tool for residency Match interviews"), but the only action verb is the truncated fragment "Generates." with no object, so the concrete action is minimal and incomplete rather than comprehensive.	2 / 5
Completeness	It clearly states what the tool does but provides no "Use when..." trigger clause, so per the missing-trigger-guidance cap completeness cannot exceed 3.	3 / 5
Trigger Term Quality	"Mock interview", "residency Match", and "interviews" are natural user terms, but common variations like "NRMP", "interview practice", and "residency interview questions" are missing.	3 / 5
Distinctiveness Conflict Risk	"residency Match interviews" carves a clear niche with minimal conflict risk, though the generic "mock interview preparation tool" phrasing leaves minor overlap with general interview-prep skills.	4 / 5
	Total	12 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
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/residency-interview-prep/SKILL.md
Commit: 63c61d3

Reviewed: 5 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.