CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

research-hotspot-analysis

Analyze research hotspots for a disease or topic and recommend representative literature. Use when users need to identify trending directions, topic clusters, or generate hotspot review reports. Input is a disease name or research topic; output is a structured hotspot analysis report and representative literature list.

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./scientific-skills/Evidence Insight/research-hotspot-analysis/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%Weight 40%Scale 1-5

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

A well-structured, executable instruction skill: the workflow references real script functions, includes failure handling, user checkpoints, and a validation checklist. Weaknesses are redundant output specifications across three sections, boilerplate filler sections, and no invocation/parameter examples for the script functions.

Suggestions

Consolidate the output specification into a single source of truth — remove the duplicated output requirements from Workflow step 6 and the Output Contract section, keeping only the Output Format template.

Delete the generic "Input Validation" boilerplate section ("accepts requests that match the documented purpose...") since it adds no actionable check beyond the existing Required Inputs and Quick Validation sections.

Add a short usage example for scripts/analysis_ops.py (e.g., one import-and-call snippet showing search_pubmed and word_frequency with typical arguments) so the workflow steps are copy-paste executable without opening the script.

DimensionReasoningScore

Conciseness

Mostly efficient with no basic-concept padding, but output requirements are stated three times (Output Format template, Workflow step 6, Output Contract) and the "Input Validation" section ("accepts requests that match the documented purpose... enough context to complete the workflow safely") is boilerplate that conveys nothing actionable — anchor 3 rather than 4's only minor trims.

3 / 5

Actionability

The workflow names concrete, verified functions ("search_pubmed", "word_frequency", "match_keywords", "sort_by_jif_and_select") that exist in scripts/analysis_ops.py with a purpose per step, giving mostly executable guidance; minor gaps remain in that no invocation example or parameter guidance is given — anchor 4, not 3, since the guidance is genuinely executable against the real bundle rather than pseudocode.

4 / 5

Workflow Clarity

A clear 6-step sequence is paired with failure handling and recovery loops (broaden time range/relax keywords, mark PARTIAL, keep PMID as pending), user checkpoints, and a Quick Validation checklist — anchor 4; not 5 because checkpoints like the PARTIAL coverage check are stated in the Output Contract rather than embedded as explicit validation steps in the workflow itself.

4 / 5

Progressive Disclosure

Good structure: both bundle files (scripts/analysis_ops.py, references/prompt_templates.md) are real, one level deep, and listed with clear purpose; the full multi-table Output Format template is inlined and front-loaded before the skill's own title and When to Use section, which is a minor organization gap — anchor 4, not 5.

4 / 5

Total

15

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, third-person description with explicit what/when structure, concrete trigger phrases, and input/output specification. Its main weakness is incomplete coverage of the skill's full capability set and a small overlap risk with general literature-search skills.

DimensionReasoningScore

Specificity

The description lists several concrete actions ("Analyze research hotspots", "recommend representative literature", "identify trending directions, topic clusters, or generate hotspot review reports") but omits capabilities the skill actually delivers, such as research-gap identification and entry-direction recommendations — minor gaps, so anchor 4 rather than 5, and clearly above anchor 3's limited 1-2 actions.

4 / 5

Completeness

It explicitly answers both what ("Analyze research hotspots for a disease or topic and recommend representative literature") and when ("Use when users need to identify trending directions, topic clusters, or generate hotspot review reports") with concrete trigger phrases, plus explicit input/output specification — matches anchor 5; it is not anchor 4 since the when clause is already specific and trigger-anchored.

5 / 5

Trigger Term Quality

Good natural trigger terms ("research hotspots", "trending directions", "topic clusters", "hotspot review reports") that users would plausibly say, but common synonyms such as "literature trends", "bibliometric analysis", or "topic selection" are missing — anchor 4, not 5's comprehensive coverage with synonyms, and well above anchor 3.

4 / 5

Distinctiveness Conflict Risk

A clear niche (research hotspot analysis with representative literature for a disease/topic) with distinct triggers, but "recommend representative literature" carries minor overlap risk with generic literature-search or review-writing skills — anchor 4, not 5's minimal conflict risk.

4 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

aipoch/medical-research-skills

Path

scientific-skills/Evidence Insight/research-hotspot-analysis/SKILL.md

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.