CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

medical-research-gap-to-study-planner

Converts an audited medical research gap into a complete, structured, gap-traceable study design. Always use this skill whenever a user already has one or more candidate research gaps and wants to transform them into an executable biomedical research plan rather than re-run broad topic ideation. Covers six gap-to-design patterns (evidence-completion, mechanism-resolution, cell-state/context-mapping, translation-bridge, causality-upgrade, population/stage-specific) and always outputs one recommended primary protocol, a gap-to-design dependency map, step-by-step workflow, figure plan, validation strategy, minimal executable version, publication upgrade path, and verified design-support literature rules. Never fabricate references. Preserve claim-evidence discipline and do not replace a topic-specific gap with a generic workflow.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

85%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, highly actionable skill body: an ordered 7-step workflow with a mandatory pre-output validation checkpoint, concrete tables, templates, and numeric rules, and exemplary one-level-deep reference splitting. The only real weakness is redundancy — several rules (DESeq2/limma, never-fabricate, gap-traceability) are repeated across the Steps, Hard Rules, and the anti-section, inflating token cost without adding information.

Suggestions

State each rule once: the DESeq2/limma rule, the never-fabricate rule, and the gap-traceability rule each appear 2–3 times across Step 3.5/Step 7, Hard Rules, and 'What This Skill Should Not Do' — keep the step-level statement and cut the verbatim Hard Rule repetitions.

Merge 'What This Skill Should Not Do' into the out-of-scope and Hard Rules sections (or cut it to the 2–3 items not already covered), since nearly every bullet restates an existing rule.

DimensionReasoningScore

Conciseness

Mostly efficient — no padding explaining concepts Claude already knows — but several rules are stated two or three times: the DESeq2/limma rule appears in Step 7 ("count data → DESeq2 preferred") and again verbatim in Hard Rule 11; "Never fabricate" appears in Step 3.5, Hard Rule 8, and "What This Skill Should Not Do"; the "What This Skill Should Not Do" section largely restates the out-of-scope list and hard rules. Not 4 because the duplication is more than minor trims; not 2 because there is no conceptual over-explanation.

3 / 5

Actionability

For an instruction-only skill the guidance is fully actionable: a pattern-selection table with concrete "When to Use" conditions, numeric retrieval minimums ("2–4 gap-background / disease-context references", "1–2 core method / design-support references"), a copy-paste redirect template with [restatement] placeholders, concrete method mappings, and a fully specified A–J output skeleton with per-section content definitions.

5 / 5

Workflow Clarity

"Execution — 7 Steps (always run in order)" gives an explicit sequence, Step 4 is a mandatory pre-output validation checklist ("Does the proposed study directly answer the stated gap, or did it drift into a generic workflow?"), and there is an explicit feedback loop ("If any inconsistency is found, revise the plan before outputting") — matching the anchor-5 'explicit validation steps; feedback loops; checklists' example.

5 / 5

Progressive Disclosure

The body is an overview that splits detail across nine reference files, each signaled at its point of use with a "→ ...: [references/...](references/...)" pointer (e.g., "→ Detailed pattern logic: references/gap-to-design-patterns.md"). All nine referenced files exist in references/ and none contain nested references, so navigation is one level deep — matching the anchor-5 structure.

5 / 5

Total

18

/

20

Passed

Description

87%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 description with explicit what/when structure, comprehensive concrete outputs, and a well-delimited niche. The main weaknesses are the imperative (implied second-person) trailing sentences, which cost specificity, and reliance on skill-internal pattern jargon where natural user phrasings would serve trigger matching better.

Suggestions

Rewrite the trailing imperative sentences ("Preserve claim-evidence discipline and do not replace a topic-specific gap with a generic workflow") in third person (e.g., "Preserves claim-evidence discipline and keeps the design topic-specific") to stay purely capability-descriptive and avoid the voice penalty.

Add one or two natural user phrasings as triggers — e.g., "turn this gap into a study protocol" or "design a study from a research gap" — since the six pattern names are skill-internal jargon users would never say.

DimensionReasoningScore

Specificity

"Converts an audited medical research gap into a complete, structured, gap-traceable study design" plus the outputs list ("one recommended primary protocol, a gap-to-design dependency map, step-by-step workflow, figure plan, validation strategy, minimal executable version, publication upgrade path") matches the anchor-5 comprehensive concrete-actions example. However, the trailing sentences "Preserve claim-evidence discipline and do not replace a topic-specific gap with a generic workflow" shift from third-person capability description to imperative (implied second person), which the guidelines penalize by 1. Not 3 because the action coverage itself is comprehensive, not merely '1-2 concrete actions'.

4 / 5

Completeness

What: "Converts an audited medical research gap into a complete, structured, gap-traceable study design" with a full outputs enumeration. When: "Always use this skill whenever a user already has one or more candidate research gaps and wants to transform them into an executable biomedical research plan rather than re-run broad topic ideation" — an explicit 'Use when' clause with concrete trigger conditions, matching the anchor-5 example structure exactly.

5 / 5

Trigger Term Quality

Natural phrases users would say are present — "research gap", "candidate research gaps", "study design", "executable biomedical research plan" — but the pattern enumeration ("evidence-completion, mechanism-resolution, cell-state/context-mapping, translation-bridge, causality-upgrade, population/stage-specific") is skill-internal jargon no user would utter, and common phrasings like "design a study", "study protocol", or "research proposal" are absent. Not 3 (key terms are well covered, not just 'some relevant keywords'); not 5 (synonym coverage is thin).

4 / 5

Distinctiveness Conflict Risk

Clear niche: post-gap-discovery study planning, explicitly delimited against adjacent skills via "rather than re-run broad topic ideation". Triggers ("candidate research gaps", "transform them into an executable biomedical research plan") are unlikely to fire for gap-discovery, literature-review, or clinical skills, matching the anchor-5 'clear niche with distinct triggers'.

5 / 5

Total

18

/

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

awesome-med-research-skills/Protocol Design/medical-research-gap-to-study-planner/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.