AGENT SKILL

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

License 许可
MIT
最近更新
2026-10-12
Stars
★ 2
Forks
0

01 前言 Front Matter

name
methods-section-writer
author
AIPOCH
license
MIT
description
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".

02 资源文件 3

03 SKILL.md 正文

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 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 → Reporting guidelines detail: references/reporting_guidelines.md → Writing principles: references/writing_principles.md

04 同仓库更多 Skills

mrsonord2240
mrsonord2240/openscience-specialists

bio-workflows-metabolomics-pipeline

Orchestrates the untargeted LC-MS metabolomics pipeline end-to-end (xcms 4.x feature extraction, QC/drift/normalization, confidence-stratified annotation, permutation-validated statistics, background-aware pathway mapping), naming what each stage decides and where it silently fails. Use when running a full LC-MS metabolomics study from raw mzML to enriched pathways and needing the honest handoffs between stages. Each stage defers to its component skill for parameters and traps; for stable-isotope flux (a separate branch, not this untargeted flow) see metabolomics/isotope-tracing.

★ 2
mrsonord2240
mrsonord2240/openscience-specialists

bio-metabolomics-xcms-preprocessing

Programmatic untargeted LC-MS feature extraction in R with the modern xcms 4.x MsExperiment/XcmsExperiment API, taking raw mzML to a feature table via CentWave peak detection, retention-time alignment, peak-density correspondence, gap-filling, CAMERA redundancy collapse, and built-in QC feature filtering. Use when converting centroided LC-MS runs into a features-by-samples matrix and deciding centWave/grouping/alignment parameters. For drift correction and QC/CV filtering execution see metabolomics/normalization-qc; for metabolite identification see metabolomics/metabolite-annotation; for the MS-DIAL GUI alternative with MS2Dec deconvolution see metabolomics/msdial-preprocessing; for downstream statistics see metabolomics/statistical-analysis.

★ 2
mrsonord2240
mrsonord2240/openscience-specialists

bio-metabolomics-statistical-analysis

Decision-grade statistical analysis for metabolomics intensity tables. Covers transformation and scaling (Pareto vs unit-variance as a hidden hypothesis), unsupervised structure (PCA/HCA for QC), permutation-validated PLS-DA/OPLS-DA (R2 vs Q2, double CV, VIP as heuristic), univariate testing (Welch/Mann-Whitney/ANOVA/LMM with covariate adjustment), and dependence-aware multiple testing. Use when testing which metabolites differ, building or validating a discriminant model, choosing a scaling, or correcting many correlated tests. For sample-wise normalization/drift correction see metabolomics/normalization-qc; for ML classifiers and selection-inside-CV leakage see machine-learning/biomarker-discovery and machine-learning/model-validation; for pathway interpretation see metabolomics/pathway-mapping; for design/power/multiplicity regime see experimental-design/multiple-testing.

★ 2
mrsonord2240
mrsonord2240/openscience-specialists

bio-metabolomics-pathway-mapping

Maps metabolomics results to biological pathways via over-representation (ORA), metabolite-set enrichment (MSEA/QEA), mummichog/PSEA on raw m/z peaks, and network-diffusion enrichment (FELLA), with correct background-set construction and honest interpretive ceilings. Use when interpreting differential metabolites or an untargeted LC-MS feature table in pathway context, choosing ORA vs MSEA vs mummichog vs topology, or setting the reference/background set. For annotation confidence levels feeding ORA see metabolomics/metabolite-annotation; for gene-set concepts see pathway-analysis/go-enrichment and pathway-analysis/gsea; for joint gene+metabolite pathways see multi-omics-integration/mofa-integration.

★ 2
mrsonord2240
mrsonord2240/openscience-specialists

bio-metabolomics-normalization-qc

Designs QC, corrects signal drift, removes batch effects, filters features, normalizes samples, and imputes missing values for untargeted LC-MS/GC-MS metabolomics, framing each step as a measurement model that can create or erase biological signal. Use when processing a peak/feature table before statistical analysis, choosing a drift-correction or sample-normalization method, deciding QC RSD vs D-ratio filtering, or handling left-censored missing values. The feature table is produced by metabolomics/xcms-preprocessing or metabolomics/msdial-preprocessing; transformation/scaling for modeling defers to metabolomics/statistical-analysis; cross-study design issues link to experimental-design/batch-design.

★ 2
mrsonord2240
mrsonord2240/openscience-specialists

bio-metabolomics-msdial-preprocessing

Runs the MS-DIAL preprocessing workflow (peak picking, MS2Dec spectral deconvolution, alignment, gap-filling) and imports the alignment-result table into R or Python with honest filtering. Use when preprocessing LC-MS DDA/DIA (SWATH) or GC-MS raw data with MS-DIAL, deciding MS-DIAL vs XCMS, configuring the MSDIALCUI console run, or parsing an MS-DIAL export into a clean feature matrix. For programmatic R peak detection and the feature-table-as-artifact framing see metabolomics/xcms-preprocessing; for lipid annotation mode see metabolomics/lipidomics; for MSI-level confidence honesty see metabolomics/metabolite-annotation; for drift correction and QC see metabolomics/normalization-qc.

★ 2