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.

39

Quality

24%

Does it follow best practices?

Impact

Pending

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 fails to communicate concrete capabilities and lacks explicit trigger guidance. The name 'medical cv resume builder' hints at a specific domain, but the description body devolves into abstract process language ('structured execution, explicit assumptions, clear output boundaries') that tells Claude nothing about what the skill actually does or when to select it. It would be very difficult for Claude to reliably choose this skill from a pool of alternatives.

Suggestions

Replace abstract language with specific actions, e.g., 'Builds and formats academic medical CVs including publication lists, clinical experience sections, research grants, and education history.'

Add an explicit 'Use when...' clause with natural trigger terms, e.g., 'Use when the user asks to create or update a medical CV, academic resume, curriculum vitae, or needs to format publications, grants, or clinical rotations.'

Remove vague qualifiers like 'structured execution, explicit assumptions, and clear output boundaries' which describe process philosophy rather than skill functionality.

DimensionReasoningScore

Specificity

The description mentions 'academic writing workflows' and 'structured execution, explicit assumptions, and clear output boundaries' but these are abstract concepts, not concrete actions. No specific capabilities like 'formats CV sections', 'generates publication lists', or 'creates education histories' are listed.

1 / 3

Completeness

The 'what' is extremely vague — it doesn't explain what the skill actually does beyond 'academic writing workflows.' The 'when' clause ('that need structured execution, explicit assumptions, and clear output boundaries') describes abstract process qualities rather than explicit trigger conditions. There is no 'Use when...' clause.

1 / 3

Trigger Term Quality

Contains some relevant keywords like 'medical cv', 'resume', 'builder', and 'academic writing' that users might naturally say. However, it's missing common variations like 'curriculum vitae', 'publications list', 'academic CV', '.docx', or specific medical specialties.

2 / 3

Distinctiveness Conflict Risk

The combination of 'medical cv resume builder' and 'academic writing' provides some niche specificity, but 'academic writing workflows' is broad enough to overlap with general writing, resume, or document formatting skills. The abstract qualifiers don't help distinguish it.

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 is heavily padded with generic boilerplate content that applies to any skill, not specifically to medical CV building. The actual domain-specific guidance (medical CV formatting, section organization, achievement highlighting) is mentioned only as bullet points with no concrete examples or executable details. The circular self-references between sections and the sheer volume of process documentation obscure the small amount of actionable content present.

Suggestions

Remove all generic boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Response Template) and focus on medical-CV-specific guidance with concrete examples of input data and expected CV output.

Provide at least one complete worked example showing sample experiences/education input and the resulting CV markdown output, so Claude knows exactly what format to produce.

Eliminate circular references ('See ## Features above') and consolidate the two overlapping workflow sections (Example Usage run plan and Workflow) into a single clear sequence.

Move security, evaluation, and lifecycle metadata into separate reference files or remove them entirely, keeping SKILL.md focused on the quick-start path for building a medical CV.

DimensionReasoningScore

Conciseness

Extremely verbose and repetitive. Multiple sections reference each other circularly ('See ## Features above', 'See ## Prerequisites above', 'See ## Workflow above'). The skill explains generic concepts Claude already knows (error handling philosophy, security checklists, lifecycle status, evaluation criteria). Much of the content is boilerplate that adds no medical-CV-specific value. The actual domain-specific content (medical CV formatting) is buried under layers of generic process documentation.

1 / 3

Actionability

There are some concrete commands (python -m py_compile, python scripts/main.py --help) and an input parameter table with types. However, the actual medical CV building logic is entirely delegated to scripts/main.py with no visibility into what it does. No example of actual input data or output is provided beyond a minimal JSON schema. The workflow steps are generic process steps, not specific to medical CV creation.

2 / 3

Workflow Clarity

There is a numbered workflow (steps 1-5) and an example run plan (steps 1-4), but they are generic and lack specific validation checkpoints. The error handling section mentions fallback paths but doesn't specify concrete validation commands beyond py_compile. There's no feedback loop for verifying the generated CV content is correct or well-formatted. Two separate workflow-like sections create confusion about which to follow.

2 / 3

Progressive Disclosure

The content is a monolithic wall of text with 15+ sections, many of which are boilerplate (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria). Circular references like 'See ## Features above' and 'See ## Prerequisites above' add confusion rather than navigation. Content that could be in separate files (security checklist, evaluation criteria, response template) is all inline, making the skill overwhelming.

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.

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.