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

53 stars

Best use case

methods-section-writer is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

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

Teams using methods-section-writer should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/methods-section-writer/SKILL.md --create-dirs "https://raw.githubusercontent.com/aipoch/medical-research-skills/main/awesome-med-research-skills/Academic Writing/methods-section-writer/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/methods-section-writer/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How methods-section-writer Compares

Feature / Agentmethods-section-writerStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

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

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

> **Source**: [https://github.com/aipoch/medical-research-skills](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 type | Guideline | Key unique requirements |
|---|---|---|
| RCT | CONSORT | Sequence generation, allocation concealment, blinding details, flow diagram |
| Observational (cohort/case-control/cross-sectional) | STROBE | Source population, exposure ascertainment, bias sources, confounding control |
| Systematic review / meta-analysis | PRISMA | Eligibility criteria, information sources, search strategy, selection process, data extraction, synthesis methods |
| Prediction model | TRIPOD | Outcome definition, predictor handling, missing data, model performance metrics |
| Diagnostic accuracy | STARD | Index test, reference standard, blinding, test interpretation, indeterminate results |
| Animal study | ARRIVE | Animal 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](references/imrad_structure.md)
→ Reporting guidelines detail: [references/reporting_guidelines.md](references/reporting_guidelines.md)
→ Writing principles: [references/writing_principles.md](references/writing_principles.md)

Related Skills

meta-protocol-writer

53
from aipoch/medical-research-skills

Generates a PROSPERO-compliant Meta-analysis protocol based on Title and PICOS. Use when the user wants to write a protocol for a systematic review or meta-analysis.

soft-article-writer

53
from aipoch/medical-research-skills

Generates high-quality promotional soft articles with structured outlines, tailored introductions, and optimized titles based on product info and hot topics. Use when you need to write promotional content, "soft articles" (), or marketing copy that integrates product highlights with current trends, news, or industry insights.

multi-source-news-writer

53
from aipoch/medical-research-skills

Integrates multiple news sources into a single, cohesive press release using an inverted pyramid structure and AP style. Use when you have raw news content and a topic, and need a professional press release.

meta-analysis-methods-generator

53
from aipoch/medical-research-skills

Generates the Methods section for a meta-analysis paper, including search strategy, screening, quality assessment, data extraction, and statistical analysis.

lay-press-release-writer

53
from aipoch/medical-research-skills

Transform academic papers into university press releases for general.

discussion-section-architect

53
from aipoch/medical-research-skills

Structures and writes discussion sections for academic papers and research reports. Use when writing a discussion section, interpreting research results, connecting findings to existing literature, addressing study limitations, synthesizing conclusions, or drafting any part of an academic discussion. Helps researchers organize arguments, contextualize data, and produce clear, publication-ready discussion prose.

discharge-summary-writer

53
from aipoch/medical-research-skills

Generate hospital discharge summaries from admission data, hospital course.

methods-reverse-engineer

53
from aipoch/medical-research-skills

Reverse-engineers the methods section of a biomedical paper into a structured, reproducible workflow. Use this skill when a user wants to understand how a study was actually executed, extract data sources, inclusion/exclusion logic, preprocessing, analytical sequence, software/tools, validation path, and critical parameters, or build a replication checklist from a paper, abstract, DOI, PMID, title, screenshot, or partial methods text. Do not treat this as generic summarization. Focus on reconstructing the operational method pipeline, surfacing missing reproducibility details, and distinguishing explicitly reported steps from inferred or unresolved ones. Never fabricate references, methods details, identifiers, software versions, parameters, datasets, or validation steps.

table-narrative-writer

53
from aipoch/medical-research-skills

Converts biomedical table content into clear manuscript or presentation narrative by prioritizing meaningful patterns, contrasts, and interpretation boundaries rather than restating every number.

results-section-writer

53
from aipoch/medical-research-skills

Writes the full Results section of a biomedical manuscript from a sufficiently clear result structure, figure inventory, or analysis summary while preserving evidence boundaries and result hierarchy.

results-section-structurer

53
from aipoch/medical-research-skills

Organizes biomedical figures, analyses, and result blocks into a clear Results section structure with disciplined narrative ordering and evidence-aware presentation.

limitation-and-risk-writer

53
from aipoch/medical-research-skills

Acknowledges limitations in sample, design, measurement, and validation in a professional way that improves credibility without undermining the whole paper. Use when writing the limitations paragraph of a Discussion section, preparing a grant risk assessment, responding to reviewers about study weaknesses, or framing scope boundaries for a paper. Also triggers on "write my limitations", "how should I address the limitation of", "reviewer said my sample is too small", or "help me word this limitation".