CtrlK
BlogDocsLog inGet started
Tessl Logo

lay-summary-gen

Converts complex medical abstracts into plain language summaries for.

34

Quality

30%

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/lay-summary-gen/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 and incomplete, ending with 'for.' which suggests missing content. While it identifies a specific domain (medical abstracts) and a concrete action (plain language conversion), it lacks a 'Use when...' clause, natural trigger term variations, and is grammatically broken. The incomplete nature significantly undermines its utility for skill selection.

Suggestions

Complete the truncated sentence and add a 'Use when...' clause, e.g., 'Use when the user asks to simplify, summarize, or explain medical research, abstracts, or clinical studies in plain language.'

Add natural trigger terms users would say, such as 'simplify medical jargon,' 'explain research paper,' 'layman's terms,' 'ELI5 medical study,' or 'patient-friendly summary.'

Expand the capability list beyond just conversion, e.g., 'Converts complex medical abstracts into plain language summaries, highlights key findings, and explains medical terminology for non-expert audiences.'

DimensionReasoningScore

Specificity

Names the domain (medical abstracts) and a specific action (converts to plain language summaries), but only describes one action and the description appears truncated ('for.' suggests incomplete text).

2 / 3

Completeness

The 'what' is partially stated but the description is truncated and incomplete ('for.' ends abruptly). There is no 'when' clause or explicit trigger guidance, and the incomplete sentence further weakens completeness.

1 / 3

Trigger Term Quality

Includes relevant keywords like 'medical abstracts' and 'plain language summaries,' but misses common variations users might say such as 'simplify,' 'explain,' 'research paper,' 'layman's terms,' 'ELI5,' or 'jargon-free.'

2 / 3

Distinctiveness Conflict Risk

The medical domain focus provides some distinctiveness, but 'plain language summaries' could overlap with general summarization or simplification skills. The truncated description makes it harder to establish a clear niche.

2 / 3

Total

7

/

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 (risk assessment, security checklist, lifecycle status, evaluation criteria) that provides no task-specific value and wastes significant token budget. The core domain knowledge — how to actually convert medical abstracts into lay summaries — is barely addressed: there are no examples of input/output transformations, no jargon replacement rules, and no reading-level guidance. The circular internal references and repetitive descriptions further degrade quality.

Suggestions

Remove all generic boilerplate sections (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Response Template) and focus token budget on the actual medical summarization task.

Add a concrete example showing an input medical abstract and the expected lay summary output, demonstrating jargon replacement and reading level targeting.

Provide specific rules or a reference list for medical jargon-to-plain-language conversion, and concrete guidance on achieving Grade 6-8 reading level.

Eliminate circular internal references ('See ## Features above') and reorganize so the most actionable content (Features, Input Parameters, Output Format, a worked example) appears first.

DimensionReasoningScore

Conciseness

Extremely verbose and repetitive. Multiple sections reference each other circularly ('See ## Features above', 'See ## Prerequisites above', 'See ## Workflow above'). Contains extensive boilerplate (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) that adds no actionable value for Claude. The skill explains generic concepts Claude already knows (error handling patterns, input validation principles) and repeats the same description ('Converts complex medical abstracts into plain language summaries for') multiple times.

1 / 3

Actionability

Provides some concrete elements like the output JSON schema, input parameters table, and bash commands for running the script. However, the actual medical summarization guidance is vague — there's no example of an input abstract being transformed into a lay summary, no concrete rules for jargon replacement, and no executable demonstration of the core task. The workflow steps are generic process steps rather than task-specific instructions.

2 / 3

Workflow Clarity

The Workflow section provides a numbered sequence and the Error Handling section mentions fallback paths, but the steps are generic and not specific to medical abstract summarization. There's no validation checkpoint for the quality of the lay summary (e.g., checking reading level, verifying jargon was replaced). The 'Quick Check' only validates Python syntax, not output quality.

2 / 3

Progressive Disclosure

References to 'references/' directory and 'scripts/main.py' exist but no bundle files are provided, making these dead references. Multiple sections circularly reference each other ('See ## Features above', 'See ## Prerequisites above') which is confusing and adds no navigational value. The document is a monolithic wall of boilerplate with poor organization — the actual useful content (Features, Input Parameters, Output Format) is buried deep below generic 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.

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.