CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

method-writing

Write and revise the Methods section of research papers to ensure reproducibility; use when preparing an IMRAD manuscript or responding to journal/reporting-guideline requirements (e.g., CONSORT/STROBE/PRISMA).

Quality

81%

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

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

The instructional core is excellent: a concrete, domain-specific algorithm and a complete worked example make the skill highly actionable, and reference files are real and well-integrated. Weaknesses are a generic boilerplate tail (~36% of the body) that wastes tokens, and abstract validation steps where a concrete completeness checklist would serve better.

Suggestions

Delete the generic template sections (Required Inputs, Recommended Workflow, Output Contract, Failure Handling, Input Validation, Quick Validation, User Checkpoints); they restate what Claude already does by default and consume roughly a third of the token budget without skill-specific value.

Replace the abstract final validation pass with a concrete Methods-completeness checklist (e.g., verify every applicable CONSORT/STROBE/PRISMA item is addressed, statistical reporting includes effect sizes with 95% CIs and missing-data strategy, and Methods content matches what Results reports).

Move the full worked-example Methods draft into a reference file (e.g., references/example_rct_methods.md) and keep a short excerpt plus pointer in SKILL.md to reduce inline weight.

DimensionReasoningScore

Conciseness

The core sections (When to Use, Implementation Details, worked example) are dense and domain-specific, but roughly a third of the body is generic template boilerplate ('Required Inputs', 'Output Contract', 'Failure Handling', 'Quick Validation' containing only 'No local script validation step is required', 'User Checkpoints') that adds no skill-specific value. Not 2: the majority of tokens earn their place; not 4: the padded tail is more than minor over-explanation.

3 / 5

Actionability

The 10-step algorithm specifies executable, concrete details (block randomization size 4, Shapiro-Wilk, Holm correction, Cohen's d with 95% CI, IUPAC nomenclature, gene-symbol italics), and the worked example provides a complete input-to-output manuscript draft that is directly adaptable. Per the scoring notes, an instruction-only skill with guidance this concrete and a full example covering the flagship case (RCT) merits the top score. Not 4: no material execution gaps exist for the primary use case.

5 / 5

Workflow Clarity

The Methods-section algorithm is clearly sequenced (identify study type, map checklist, write prose, specify details, statistics, bias control, ethics, data, terminology, journal adaptation), but validation checkpoints are abstract ('Run a final validation pass for completeness, consistency, and safety') and the Recommended Workflow section is generic filler. Not 4: no concrete verification step or checklist of what to check is written; not 2: a real, coherent 10-step sequence is present.

3 / 5

Progressive Disclosure

Three real, one-level-deep reference files (imrad_structure.md, reporting_guidelines.md, writing_principles.md) are clearly signaled both in a reference list and inline in the algorithm steps. Not 5: the full ~40-line sample Methods draft is inlined in SKILL.md rather than split into an examples reference, keeping the main file heavier than an overview needs to be.

4 / 5

Total

15

/

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, concise description that explicitly states what the skill does and when to use it, with domain-specific trigger terms (IMRAD, CONSORT/STROBE/PRISMA) that make it highly discoverable and distinct from generic writing skills. Minor keyword synonyms could be added for broader trigger coverage.

DimensionReasoningScore

Specificity

Concrete actions are named ('Write and revise the Methods section of research papers to ensure reproducibility') with specific guideline anchors (CONSORT/STROBE/PRISMA), but coverage of capabilities is not fully comprehensive. Not 5: it doesn't enumerate the range of writing actions (statistical reporting, ethics declarations) hinted at in the body; not 3: it lists more than 1-2 concrete actions with a clearly named domain.

4 / 5

Completeness

Explicitly answers both questions: what ('Write and revise the Methods section of research papers to ensure reproducibility') and when ('use when preparing an IMRAD manuscript or responding to journal/reporting-guideline requirements'), with concrete trigger phrases matching the anchor-5 example structure. Not 4: the 'when' clause is not merely present but specific and multi-triggered.

5 / 5

Trigger Term Quality

Natural domain terms users would say are present: 'Methods section', 'research papers', 'reproducibility', 'IMRAD', 'CONSORT/STROBE/PRISMA', 'journal'. Not 5: a few natural synonyms are missing (e.g., 'materials and methods', standalone 'manuscript'); not 3: keyword coverage goes well beyond the minimum with named guideline acronyms researchers actually use.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Methods-section writing for scientific manuscripts) with distinct triggers (IMRAD, CONSORT/STROBE/PRISMA) that virtually no other skill would claim; minimal conflict risk with generic writing or document skills. Not 4: the guideline acronyms make the triggers distinct, not just mostly distinct.

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

scientific-skills/Academic Writing/method-writing/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.