CtrlK
BlogDocsLog inGet started
Tessl Logo

journal-club-presenter

Generate journal club slides with background, critique, and discussion.

35

Quality

20%

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/journal-club-presenter/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 identifies a specific use case (journal club slides) and mentions key components (background, critique, discussion), which gives it some distinctiveness. However, it lacks a 'Use when...' clause, misses natural trigger term variations, and doesn't provide enough concrete detail about what actions the skill performs beyond generating slides.

Suggestions

Add a 'Use when...' clause with trigger terms like 'journal club', 'paper review', 'research article presentation', 'literature discussion', 'paper critique slides'.

Expand the specificity of actions, e.g., 'Summarizes research papers, generates structured journal club presentations with background context, methods critique, strengths/weaknesses analysis, and discussion questions.'

Include file type or format references if applicable, such as '.pptx', 'PowerPoint', or 'Google Slides' to improve trigger term coverage.

DimensionReasoningScore

Specificity

Names the domain (journal club slides) and lists some actions (background, critique, discussion), but doesn't elaborate on concrete actions like analyzing papers, summarizing methods, generating specific slide layouts, etc.

2 / 3

Completeness

Describes what it does (generate journal club slides) but has no 'Use when...' clause or equivalent explicit trigger guidance, which per the rubric should cap completeness at 2, and the 'what' is also fairly thin, placing this at 1.

1 / 3

Trigger Term Quality

Includes 'journal club' and 'slides' which are relevant trigger terms, but misses common variations like 'paper review', 'article discussion', 'research presentation', 'literature review slides', or 'paper critique'.

2 / 3

Distinctiveness Conflict Risk

'Journal club slides' is a fairly specific niche, but could overlap with general presentation creation skills or academic paper analysis skills. The description doesn't clearly delineate its boundaries from broader slide-generation tools.

2 / 3

Total

7

/

12

Passed

Implementation

7%

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 minimal domain-specific content about journal club presentations. The actual useful information (use cases, parameters, returns) occupies perhaps 15 lines out of 150+, while the rest is template scaffolding that could apply to any skill. It fails to provide any concrete guidance on how to structure a journal club presentation, critique a paper, or generate meaningful slide content.

Suggestions

Replace generic boilerplate with domain-specific content: include a concrete example of a journal club slide outline with actual content (e.g., background slide structure, methods critique framework, discussion question templates).

Add actionable guidance for each slide type: what makes a good 'Background' slide, how to structure a 'Methods Critique' slide, what key figures to highlight and how to explain them.

Remove or drastically compress the Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Response Template, and other generic sections that add no journal-club-specific value.

Provide a complete worked example showing input (a paper summary) and output (the actual slide outline with content) so Claude knows exactly what quality output looks like.

DimensionReasoningScore

Conciseness

Extremely verbose and padded with boilerplate sections that add no value. The skill contains a risk assessment table, security checklist, lifecycle status, evaluation criteria, response template, and numerous generic sections that Claude already knows how to handle. The actual domain-specific content (journal club slides) is buried under layers of generic scaffolding. Self-referential links like 'See ## Prerequisites above' and 'See ## Workflow above' add noise.

1 / 3

Actionability

Despite its length, the skill provides almost no concrete guidance on how to actually generate journal club slides. There's no example of slide content, no template for critique structure, no sample output, and the 'Example' section just says '20-min presentation with 8 slides' with no actual example. The commands shown are generic (py_compile, --help) and the workflow steps are abstract process descriptions, not domain-specific instructions.

1 / 3

Workflow Clarity

The workflow section contains only generic steps ('Confirm the user objective', 'Validate that the request matches the documented scope') with no journal-club-specific sequencing. There are no validation checkpoints for the actual content generation process (e.g., verifying paper parsing, checking slide structure). The 'Example run plan' is similarly generic and doesn't describe how to actually produce quality journal club slides.

1 / 3

Progressive Disclosure

There is some structure with references to external files (references/audit-reference.md, scripts/main.py) and the content is organized into sections. However, the sections are poorly organized with redundancy (Quick Check and Audit-Ready Commands overlap, multiple sections reference each other circularly), and the actual useful content is not separated from boilerplate.

2 / 3

Total

5

/

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.