CtrlK
BlogDocsLog inGet started
Tessl Logo

presentation-hook

Creates engaging opening statements and powerful closings for medical.

25

Quality

16%

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/presentation-hook/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

32%

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 truncated ('for medical' appears cut off), making it incomplete and unclear about the full scope of the skill. It lacks a 'Use when...' clause, reducing its utility for skill selection. While it identifies a somewhat specific niche (medical openings/closings), the incomplete phrasing undermines both specificity and distinctiveness.

Suggestions

Complete the truncated phrase 'for medical' — specify the content type (e.g., 'medical presentations', 'medical papers', 'medical speeches') to clarify the skill's scope.

Add a 'Use when...' clause with trigger terms like 'medical presentation opening', 'speech introduction', 'closing remarks', 'hook', 'conclusion'.

List more specific concrete actions such as 'crafts attention-grabbing hooks, writes call-to-action conclusions, structures persuasive introductions for medical presentations'.

DimensionReasoningScore

Specificity

Names a domain (medical) and two actions (creating opening statements and closings), but the description is incomplete—'for medical' is truncated and lacks detail about what kind of medical content (presentations, papers, speeches?).

2 / 3

Completeness

The description partially addresses 'what' (creating openings and closings) but is truncated and incomplete, and there is no 'when' clause or explicit trigger guidance. The missing 'Use when...' clause caps this at 2, and the truncation further reduces it.

1 / 3

Trigger Term Quality

Includes some relevant terms like 'opening statements', 'closings', and 'medical', but the truncated description misses common variations users might say such as 'introduction', 'conclusion', 'medical presentation', 'speech', or 'paper'.

2 / 3

Distinctiveness Conflict Risk

The combination of 'medical' and 'opening/closing statements' provides some specificity, but the truncated and vague nature of 'for medical' could overlap with general medical writing skills or presentation skills.

2 / 3

Total

7

/

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 generic boilerplate with virtually no domain-specific content about crafting presentation hooks or closings. The actual task—creating engaging openings and powerful closings for medical presentations—receives no concrete guidance, examples, rhetorical techniques, or patterns. The document is bloated with template sections (Risk Assessment, Security Checklist, Lifecycle Status) that consume tokens without adding value.

Suggestions

Replace boilerplate sections with actual domain content: examples of effective medical presentation hooks (e.g., startling statistics, patient stories, provocative questions) with concrete input→output examples showing topic/audience → generated hook.

Remove generic template sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) that add no task-specific value and waste context window.

Eliminate circular internal references ('See ## Features above') and consolidate related content into a single coherent flow.

Add concrete examples: given a topic like 'antibiotic resistance' and audience 'clinical physicians', show 2-3 example hooks with different rhetorical strategies and explain why each works.

DimensionReasoningScore

Conciseness

Extremely verbose and padded with boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) that add no actionable value for this simple task. Multiple sections reference each other circularly ('See ## Features above', 'See ## Prerequisites above'). The actual domain-specific content (how to craft presentation hooks) is buried under generic template filler that Claude already knows.

1 / 3

Actionability

Despite the length, there is virtually no concrete guidance on how to actually craft presentation openings or closings. No examples of good hooks, no patterns, no rhetorical techniques. The 'actionable' content is generic boilerplate about running scripts (`python scripts/main.py`) with no indication of what the script does or how it generates hooks. The output format JSON is specified but no example input→output pair is provided.

1 / 3

Workflow Clarity

The workflow section is entirely generic ('Confirm the user objective', 'Validate that the request matches the documented scope') with no steps specific to crafting presentation hooks. There are no validation checkpoints relevant to the actual task. The 'Example run plan' is also generic boilerplate about running a script with no domain-specific sequencing.

1 / 3

Progressive Disclosure

Multiple sections reference other sections within the same document circularly ('See ## Features above', 'See ## Prerequisites above', 'See ## Workflow above'), creating confusion rather than progressive disclosure. References to `references/` directory and `scripts/main.py` exist but no bundle files are provided, making these dead references. The document is a monolithic wall of boilerplate with poor organization.

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.