CtrlK
BlogDocsLog inGet started
Tessl Logo

two-sample-mr-exposure-screening-reference-grounded

Generates complete two-sample Mendelian randomization research designs from a user-provided outcome, exposure or exposure family, and robustness direction. Use when a study centers on summary-statistics causal inference with instrument selection, harmonization, IVW-primary estimation, complementary estimators, sensitivity analyses, optional multivariable upgrades, and conservative evidence interpretation. Covers five study patterns and always outputs Lite / Standard / Advanced / Publication+ with a recommended primary plan, stepwise workflow, figure plan, validation hierarchy, minimal executable version, publication upgrade path, and strictly verified literature retrieval.

68

Quality

85%

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

73%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 instruction skill with an excellent validated workflow: ordered steps, an explicit dependency-check gate with failure handling, and concrete output specifications. Its weaknesses are redundancy — the 22 Hard Rules substantially restate section mandates — and three orphaned bundle files that no document links to.

Suggestions

Deduplicate the Hard Rules: drop rules that verbatim restate Step 4.5 and Sections C.5/G/I/J (e.g., rules 11–12, 16, 19–22) and keep a single canonical statement of each mandate, cutting 30–40 lines.

Link analysis-modules.md, method-library.md, and workflow-step-template.md from the relevant body sections (e.g., method-library from Step 6, workflow-step-template from Section D) so every bundle file is reachable from the overview.

Inline one worked example of a workflow step (per workflow-step-template.md) and one sample formal reference entry with identifier, so the output format is concrete without opening the reference files.

DimensionReasoningScore

Conciseness

The body is instruction-dense rather than padded with background concepts Claude already knows, but the 22-item Hard Rules section heavily restates content already stated in the body — rules 11–12 repeat Step 4.5's citation rules, rule 16 restates Section G's subset requirement, and rules 19–22 restate the C.5/I/J 'mandatory in every output' declarations. This matches the score-3 anchor ('mostly efficient but includes some unnecessary explanation or could be tightened') — above score 2, since there is no concept-teaching padding, but below score 4, since the rule/section duplication is systematic rather than minor.

3 / 5

Actionability

As an instruction-only skill, the guidance is highly concrete: exact output sections A–J with required contents, exact redirect and Dataset Disclaimer text to reproduce verbatim, input examples, minimum retrieval counts ('2–4 outcome/exposure background references... 1 explicit evidence-gap note'), and a worked dependency-formula list. It stays at score 4 rather than 5 because a few instructions remain process-level without a worked example inline (e.g., 'provide the full workflow using the required stepwise format' delegates the format entirely to a reference file, and no sample workflow step or sample reference entry is shown in the body).

4 / 5

Workflow Clarity

The seven steps are explicitly ordered ('always run in order'), and Step 5 is a genuine validation gate before output: a dependency consistency checklist ('Do causal claims appear without explicit instrument-selection and harmonization logic?'), forbidden-claim rules, and explicit failure handling ('If dependency fails, remove or downgrade the downstream claim rather than silently keeping it'). Insufficient-detail handling ('infer a reasonable default and state assumptions explicitly') and the six-element self-critical risk review add error-recovery feedback. This matches the score-5 anchor (clear sequence with explicit validation steps and feedback loops).

5 / 5

Progressive Disclosure

The body is a well-organized overview with clearly signaled one-level-deep references ('→ Detailed pattern logic: [references/study-patterns.md]'), and all five linked reference files exist with no nested second-level references. However, three of the eight bundle files — analysis-modules.md, method-library.md, and workflow-step-template.md — are linked from neither SKILL.md nor any other reference file, making them undiscoverable. Good structure with a real navigation gap places this at score 4 rather than 5; it is above score 3 because the linked references are clear and the overview/detail split is appropriate.

4 / 5

Total

16

/

20

Passed

Description

92%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.

The description is a strong example: third-person voice, explicit 'Use when' clause, comprehensive concrete capabilities, and a clearly distinct niche. The only weakness is that some trigger phrasing is methodology jargon rather than the natural language a user would type, which slightly limits keyword coverage.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'instrument selection, harmonization, IVW-primary estimation, complementary estimators, sensitivity analyses, optional multivariable upgrades' — plus concrete deliverables ('recommended primary plan, stepwise workflow, figure plan, validation hierarchy, minimal executable version, publication upgrade path'), giving comprehensive coverage with no padding. This matches the score-5 anchor ('lists multiple specific concrete actions; comprehensive coverage') and not score 4, since there are no meaningful coverage gaps.

5 / 5

Completeness

Both questions are explicitly answered: the 'what' ('Generates complete two-sample Mendelian randomization research designs from a user-provided outcome, exposure or exposure family...') and an explicit 'Use when' clause ('Use when a study centers on summary-statistics causal inference with instrument selection...'). This exactly matches the score-5 anchor with concrete trigger phrases, and clearly exceeds score 4 where the 'when' is less specific.

5 / 5

Trigger Term Quality

Strong natural domain terms users would actually say: 'two-sample Mendelian randomization', 'exposure', 'outcome', 'IVW', 'sensitivity analyses'. However, phrases like 'complementary estimators', 'optional multivariable upgrades', and 'conservative evidence interpretation' lean toward methodology jargon, and common user variations like 'MR study', 'GWAS summary statistics', or 'causal inference' as standalone triggers are thin. This sits above the score-3 anchor (some relevant keywords but missing variations) but below score 5 (comprehensive coverage including synonyms).

4 / 5

Distinctiveness Conflict Risk

The two-sample MR exposure-screening niche is highly specific with distinct triggers ('IVW-primary estimation', 'MVMR', 'pleiotropy'), so it would not be confused with general research-planning, statistics, or literature-review skills. Clear niche with minimal conflict risk, matching the score-5 anchor rather than score 4, which presumes overlap with closely related skills.

5 / 5

Total

19

/

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
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.