CtrlK
BlogDocsLog inGet started
Tessl Logo

medical-cv-resume-builder

Use medical cv resume builder for academic writing workflows that need structured execution, explicit assumptions, and clear output boundaries.

22

Quality

11%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./scientific-skills/Academic Writing/medical-cv-resume-builder/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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 weak across most dimensions. It relies heavily on abstract buzzwords ('structured execution', 'explicit assumptions', 'clear output boundaries') instead of describing concrete capabilities. The domain hint of 'medical cv resume builder' is promising but underdeveloped — it needs specific actions and explicit trigger conditions to be useful for skill selection.

Suggestions

Replace abstract language with concrete actions, e.g., 'Builds and formats academic medical CVs including publications, grants, clinical experience, and teaching sections.'

Add an explicit 'Use when...' clause with natural trigger terms, e.g., 'Use when the user asks to create or update a medical CV, curriculum vitae, academic resume, or faculty application document.'

Remove vague phrases like 'structured execution', 'explicit assumptions', and 'clear output boundaries' which add no discriminative value for skill selection.

DimensionReasoningScore

Specificity

The description lacks concrete actions. Phrases like 'structured execution', 'explicit assumptions', and 'clear output boundaries' are abstract buzzwords that don't describe what the skill actually does. The only hint of domain is 'medical cv resume builder' and 'academic writing', but no specific actions like 'format publications', 'generate CV sections', or 'organize research experience' are mentioned.

1 / 3

Completeness

The 'what' is extremely vague — it doesn't clearly explain what the skill does beyond vague references to 'academic writing workflows'. The 'when' clause ('that need structured execution, explicit assumptions, and clear output boundaries') is not a meaningful trigger condition — it describes abstract qualities rather than concrete situations. There is no explicit 'Use when...' clause.

1 / 3

Trigger Term Quality

Contains some relevant keywords like 'medical', 'cv', 'resume', and 'academic writing' that users might naturally say. However, it's missing common variations like 'curriculum vitae', 'publications list', 'academic CV', '.docx', or 'faculty application'. The phrase 'structured execution' and 'output boundaries' are not terms users would use.

2 / 3

Distinctiveness Conflict Risk

The combination of 'medical' + 'cv' + 'resume' + 'academic writing' provides some niche specificity, but the vague language around 'structured execution' and 'workflows' could overlap with general writing or document formatting skills. It's somewhat distinguishable but not clearly delineated.

2 / 3

Total

6

/

12

Passed

Implementation

0%

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

This skill is almost entirely boilerplate scaffolding with no substantive content about medical CV/resume building. It repeats the same generic description multiple times, contains circular internal references, and lacks any concrete medical CV formatting rules, templates, examples, or domain-specific guidance. The extensive risk assessment, security checklist, lifecycle status, and evaluation criteria sections consume tokens without adding actionable value.

Suggestions

Replace the generic workflow and boilerplate sections with actual medical CV formatting rules, section ordering conventions (e.g., Education → Residency → Fellowship → Board Certifications → Publications), and US academic medicine standards.

Add concrete examples showing sample input data and the expected CV markdown output, including at least one complete section (e.g., a Publications section formatted correctly).

Remove circular cross-references ('See ## Features above'), the Risk Assessment table, Security Checklist, Lifecycle Status, and Evaluation Criteria sections — these consume significant tokens without helping Claude build better CVs.

Either provide the referenced bundle files (scripts/main.py, references/) or remove references to them and make the skill self-contained with inline formatting logic and templates.

DimensionReasoningScore

Conciseness

Extremely verbose and repetitive. Multiple sections reference each other circularly ('See ## Features above', 'See ## Prerequisites above', 'See ## Workflow above'). The skill repeats the same description string verbatim multiple times. Includes extensive boilerplate (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) that adds no actionable value for Claude. Many sections explain things Claude already knows (what input validation means, what error handling is).

1 / 3

Actionability

Despite its length, the skill provides almost no concrete, executable guidance for actually building a medical CV. The 'Example Usage' just shows how to run a script with --help. The workflow steps are entirely abstract ('Confirm the user objective', 'Validate that the request matches'). There's no actual CV formatting logic, template content, or medical-specific formatting rules. The Input Parameters table is skeletal with no examples of what 'experiences' or 'education' lists should contain.

1 / 3

Workflow Clarity

The workflow is vague and generic — it reads like a template that could apply to any skill, not specifically to building medical CVs. Steps like 'Confirm the user objective' and 'Use the packaged script path or the documented reasoning path' are not actionable. There are no validation checkpoints specific to CV content quality, formatting correctness, or medical standards compliance. The circular references ('See ## Workflow above') further confuse navigation.

1 / 3

Progressive Disclosure

The document references 'references/' directory and 'scripts/main.py' but no bundle files are provided, making these dead references. Internal cross-references are circular and confusing ('See ## Features above for related details' placed before the Features section). The document is a monolithic wall of boilerplate with no meaningful content hierarchy — critical information (what makes a medical CV, formatting rules) is entirely absent while generic scaffolding dominates.

1 / 3

Total

4

/

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
aipoch/medical-research-skills
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.