CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

methods-section-writer

Turns your protocol and analysis workflow into publication-ready Methods text. Use when writing or revising the Methods section of a biomedical manuscript, ensuring it complies with reporting guidelines (CONSORT, STROBE, PRISMA, TRIPOD), matches what is in the Results section, and satisfies journal-specific word limits and declarations. Also triggers on "write my methods", "revise my methods section", "how to report my statistics", "what do I need to include in methods for [study type]", or "make my methods CONSORT-compliant".

Quality

89%

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

75%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-only skill: lean, specific, and sequenced with input-validation and post-draft guideline checks, supported by real one-level-deep reference files. It falls just short of top marks on conciseness (duplicated guideline mapping), actionability (no sample output prose), workflow closure (no explicit fix-after-check step), and disclosure placement (end-loaded references).

Suggestions

Deduplicate the guideline mapping: keep it in one place (either Step 1's 'Applicable reporting guideline' line or the Quick Reference table, with the other linking to references/reporting_guidelines.md), and drop the quoted '> "Method Writing produces..."' line.

Add one short worked example in Step 3 — a single model Methods paragraph showing past tense, first-use abbreviation definition, and placeholder usage — so the required prose register is demonstrable rather than only described.

Close the feedback loop in Step 4: after 'Identify any required item that is missing or incomplete', add an explicit instruction to revise the draft to address fixable gaps and re-check before Step 5 delivery, and inline-link references/reporting_guidelines.md at that point of use.

DimensionReasoningScore

Conciseness

The body is dense and additive — per-study-type required inputs, a subsection-by-subsection output structure, and hard rules with exact placeholder syntax — with no explaining of concepts Claude already knows. Two minor trims keep it below anchor 5: the guideline-to-study-type mapping appears twice (Step 1 'Applicable reporting guideline: CONSORT (RCT), STROBE (observational)...' and again in the Quick Reference table), and the quoted line '> "Method Writing produces Methods section text..."' adds little. Well above anchor 3, which requires unnecessary explanation.

4 / 5

Actionability

Highly concrete for an instruction-only skill: the eight IMRAD subsections each specify their required contents, the hard rule gives exact placeholder syntax '[AUTHOR TO SPECIFY: randomization method]', and Step 5 gives a verbatim deliverable format ('CONSORT items covered: [list]. Items not addressed (need from author): [list]'). Below anchor 5 only because there is no worked example of the target output prose (e.g., one model Methods paragraph demonstrating register, tense, and abbreviation style) — a minor gap per the instruction-only guidance in the rubric's scoring notes.

4 / 5

Workflow Clarity

Five clearly sequenced steps with real checkpoints: 'If the study type is unclear, ask one focused question before proceeding', 'If critical items are missing, ask for them before writing', and a post-draft Step 4 guideline check. Below anchor 5 because the feedback loop is not fully closed: Step 4 says to 'Identify any required item that is missing or incomplete' and flag items, but never explicitly instructs revising the draft to close those gaps before delivery — a minor validation gap versus the anchor-5 'fix and re-validate' pattern. Not a destructive/batch operation, so the cap-at-3 rule does not apply.

4 / 5

Progressive Disclosure

Appropriate split: the ~120-line SKILL.md keeps workflow and rules inline while three substantial detail files (imrad_structure.md, reporting_guidelines.md, writing_principles.md — 615/748/786 lines, verified to exist with no nested references) carry the deep material, one level deep and clearly labeled. Two minor gaps versus anchor 5: the Quick Reference table duplicates content that belongs in reporting_guidelines.md, and the references are grouped in a terminal list rather than linked at point of use (e.g., Step 4 does not point to reporting_guidelines.md when it runs the guideline check).

4 / 5

Total

16

/

20

Passed

Description

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

An exemplary description: third-person concrete capabilities, an explicit 'Use when' clause, verbatim user-phrasable trigger quotes, and a well-delineated niche. It closely models the rubric's good examples with no over-claims or padding.

DimensionReasoningScore

Specificity

Lists multiple concrete actions covering the domain comprehensively: 'Turns your protocol and analysis workflow into publication-ready Methods text', 'ensuring it complies with reporting guidelines (CONSORT, STROBE, PRISMA, TRIPOD)', 'matches what is in the Results section', 'satisfies journal-specific word limits and declarations'. Anchor 5 fits because capability coverage has no noticeable gaps; anchor 4 ('several specific actions; minor gaps') understates it. Voice is third person ('Turns') — 'your protocol' is a possessive object, not a second-person construction like 'You can use this', so no voice penalty applies.

5 / 5

Completeness

Explicitly answers both questions: what ('Turns your protocol and analysis workflow into publication-ready Methods text... ensuring it complies with reporting guidelines...') and when ('Use when writing or revising the Methods section of a biomedical manuscript', plus literal trigger phrases). This matches the anchor-5 good example structure exactly; the 'when' is not merely implied as in anchor 3.

5 / 5

Trigger Term Quality

Explicitly enumerates natural phrases users would actually say: '"write my methods"', '"revise my methods section"', '"how to report my statistics"', '"make my methods CONSORT-compliant"', alongside guideline acronyms and 'Methods section of a biomedical manuscript'. This is comprehensive synonym coverage per the anchor-5 pattern (no file extensions exist for this domain, so none are expected); anchor 4 ('a few natural terms missing') does not apply.

5 / 5

Distinctiveness Conflict Risk

A clear niche — biomedical manuscript Methods sections with named reporting guidelines (CONSORT, STROBE, PRISMA, TRIPOD) — with distinct triggers ('make my methods CONSORT-compliant') unlikely to fire for generic writing or document skills. Anchor 4 ('minor overlap risk with closely related skills') would require some plausible confusion with adjacent skills, which the explicit Methods-section scoping prevents.

5 / 5

Total

20

/

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/Academic Writing/methods-section-writer/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.