residency-interview-prep
Mock interview preparation tool for residency Match interviews. Generates.
39
Quality
24%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/Academic Writing/residency-interview-prep/SKILL.mdQuality
Discovery
22%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This description is critically incomplete, ending mid-sentence with 'Generates.' which renders it nearly unusable for skill selection. While it identifies a specific domain (residency Match interviews), it fails to explain what actions the skill performs or when Claude should use it. The truncation suggests this may be an error rather than an intentional description.
Suggestions
Complete the truncated sentence to specify what the skill generates (e.g., 'Generates practice questions, behavioral scenarios, and feedback for residency interview responses').
Add an explicit 'Use when...' clause with trigger terms like 'residency interview', 'Match prep', 'medical school interview practice', 'ERAS', or 'interview questions'.
List 2-3 specific concrete actions the skill performs (e.g., 'simulates interviewer questions, evaluates responses, provides improvement suggestions').
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description is incomplete (ends with 'Generates.') and only vaguely mentions 'mock interview preparation' without listing concrete actions like generating questions, providing feedback, or simulating scenarios. | 1 / 3 |
Completeness | The description is truncated mid-sentence ('Generates.'), fails to explain what it generates, and has no 'Use when...' clause or explicit trigger guidance whatsoever. | 1 / 3 |
Trigger Term Quality | Contains some relevant keywords like 'mock interview', 'residency', and 'Match interviews' that users might naturally say, but the incomplete sentence and lack of variations (e.g., 'practice interview', 'interview prep', 'medical residency') limits coverage. | 2 / 3 |
Distinctiveness Conflict Risk | The 'residency Match interviews' niche is fairly specific to medical education, but the incomplete description and generic 'mock interview preparation' phrasing could overlap with general interview prep skills. | 2 / 3 |
Total | 6 / 12 Passed |
Implementation
27%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill suffers from severe template bloat - it appears to be a generic skill template with minimal domain-specific customization for residency interview prep. The actual valuable content (question types, STAR format, specialty-specific questions) is minimal and buried under excessive boilerplate. The skill prioritizes process documentation over actionable interview preparation guidance.
Suggestions
Remove all generic boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Response Template) and focus on interview-specific content - example questions, STAR format guidance, and specialty-specific tips
Add concrete examples of generated interview questions with sample responses and feedback, rather than just describing that the feature exists
Restructure to lead with the Features section and Input Parameters, moving the actual interview prep content to the top
Replace circular 'See X above' references with actual inline content or remove them entirely - they currently point to nothing useful
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose with excessive boilerplate, redundant sections (multiple 'See X above' references that point nowhere useful), and template-like filler content. The actual domain-specific content (interview prep features, question types) is buried under generic scaffolding that doesn't add value. | 1 / 3 |
Actionability | Provides some concrete elements like input parameters table, output JSON schema, and bash commands, but the core functionality (generating interview questions, providing feedback) lacks executable examples. The 'scripts/main.py' is referenced but no actual interview question generation code or examples are shown. | 2 / 3 |
Workflow Clarity | Has numbered workflow steps but they are generic boilerplate ('Confirm the user objective...') rather than specific to interview preparation. Missing validation checkpoints specific to the domain - no guidance on how to validate question quality or appropriateness for specialty. | 2 / 3 |
Progressive Disclosure | Poor organization with circular references ('See ## Features above', 'See ## Prerequisites above') that don't provide useful navigation. Content is monolithic with no clear hierarchy - the actual interview prep features are buried mid-document after generic boilerplate sections. | 1 / 3 |
Total | 6 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
- Repository
- aipoch/medical-research-skills
- Commit
4a48721
- 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.