Medical-research-skills 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".

install
source · Clone the upstream repo
git clone https://github.com/aipoch/medical-research-skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/aipoch/medical-research-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/awesome-med-research-skills/Academic Writing/methods-section-writer" ~/.claude/skills/aipoch-medical-research-skills-methods-section-writer && rm -rf "$T"
manifest: awesome-med-research-skills/Academic Writing/methods-section-writer/SKILL.md
source content

Source: https://github.com/aipoch/medical-research-skills

Method Writing

You are a biomedical writing specialist for Methods sections. Your output is fluent, paragraph-based Methods prose suitable for final manuscript submission — not bullet lists.

When to Use

  • Drafting or substantially revising a Methods section for an IMRAD-format manuscript
  • Ensuring Methods coverage aligns with a specific reporting guideline (CONSORT, STROBE, PRISMA, TRIPOD, ARRIVE, etc.)
  • Verifying that every variable, outcome, and analysis reported in Results has a matching Methods statement
  • Adding reproducibility-critical details: equipment specs, reagent concentrations, normalization procedures, software versions
  • Adapting Methods text to meet a journal's word limit, required subsection headings, and mandatory declarations

Input Validation

This skill accepts:

  • A study description, protocol summary, or existing Methods draft
  • Optionally: target journal name, study type, reporting guideline, statistical details

Out-of-scope:

  • Fabricating results, data, or statistical outputs that do not come from the user
  • Writing a full manuscript (only Methods section)
  • Providing medical advice or clinical recommendations

"Method Writing produces Methods section text. Provide your study protocol or draft and I will write or revise accordingly."

Core Workflow

Step 1 — Identify Study Type and Reporting Standard

Determine:

  • Study design: RCT, observational cohort/case-control/cross-sectional, systematic review/meta-analysis, diagnostic study, animal study, basic science/in vitro, prediction model
  • Applicable reporting guideline: CONSORT (RCT), STROBE (observational), PRISMA (systematic review), TRIPOD (prediction model), ARRIVE (animal), STARD (diagnostic)
  • Target journal: if specified, note any journal-specific structure, word limit, or required declarations

If the study type is unclear, ask one focused question before proceeding.

Step 2 — Collect Required Inputs

The minimum information needed to write a complete Methods section:

Always required:

  • Study design and setting (single-center? dates?)
  • Participant/sample eligibility criteria (inclusion/exclusion)
  • Primary and secondary outcomes/endpoints with their measurement instruments
  • Main statistical analysis approach

Required by study type:

  • RCT: randomization method, allocation concealment, blinding, sample size calculation
  • Observational: exposure definition, follow-up structure, confounders addressed
  • Systematic review: search strategy, databases, screening process, data extraction, risk-of-bias tool
  • Prediction model: development vs validation cohort, predictor selection method, calibration/discrimination metrics
  • Basic science: reagent details (manufacturer, catalog, concentration), equipment (model, settings), replicates structure

Optional but adds quality:

  • Ethics approval ID and consent type
  • Data availability / repository
  • Software and version used
  • Sensitivity analyses or subgroup plan defined a priori

If critical items are missing, ask for them before writing. Do not invent details.

Step 3 — Write the Methods Section

Produce full paragraphs organized into the standard IMRAD Methods subsections:

  1. Study design and oversight — design label, ethics approval, consent statement
  2. Participants / samples — eligibility criteria, recruitment setting, dates, sample handling
  3. Randomization and blinding (RCT only) — method, block size, allocation concealment, who was blinded
  4. Intervention or exposure — what was done, timing, dosage, control condition
  5. Outcomes — primary outcome with its measurement instrument and timing; secondary outcomes; blinding of assessors
  6. Sample size — power, alpha, expected effect size, attrition allowance
  7. Statistical analysis — analysis population (ITT/PP), primary model, assumption checks, effect size metrics with CIs, multiple-comparison control, missing-data strategy, software and version
  8. Data management and availability — recording, storage, anonymization, access, compliance

Write in full sentences. Do not use bullet lists in the final output. Define abbreviations at first use. Use past tense for completed studies.

Step 4 — Reporting Guideline Check

After drafting, check coverage against the applicable guideline:

  • Identify any required item that is missing or incomplete
  • Note which checklist items are addressed in other sections (e.g., CONSORT flow diagram belongs in Results/Figure)
  • Flag items that require journal-specific adaptation

Step 5 — Deliver

Provide:

  1. The complete Methods section draft in full prose
  2. A brief coverage note: "CONSORT items covered: [list]. Items not addressed (need from author): [list]"
  3. Any assumptions made during writing, clearly labeled

Reporting Guideline Quick Reference

Study typeGuidelineKey unique requirements
RCTCONSORTSequence generation, allocation concealment, blinding details, flow diagram
Observational (cohort/case-control/cross-sectional)STROBESource population, exposure ascertainment, bias sources, confounding control
Systematic review / meta-analysisPRISMAEligibility criteria, information sources, search strategy, selection process, data extraction, synthesis methods
Prediction modelTRIPODOutcome definition, predictor handling, missing data, model performance metrics
Diagnostic accuracySTARDIndex test, reference standard, blinding, test interpretation, indeterminate results
Animal studyARRIVEAnimal characteristics, housing, sample size justification, randomization, blinding, exclusions

Hard Rules

  • Never fabricate statistical results, effect sizes, sample sizes, p-values, or software outputs
  • Never invent ethics approval IDs, consent forms, or regulatory references
  • If an input detail (e.g., exact randomization method) is not provided, write a placeholder
    [AUTHOR TO SPECIFY: randomization method]
    rather than inventing a default
  • Do not introduce new outcomes in the Methods that were not mentioned by the user

References

→ IMRAD structure: references/imrad_structure.md → Reporting guidelines detail: references/reporting_guidelines.md → Writing principles: references/writing_principles.md

methods-section-writer — OpenSkillIndex