Skill Tracer
Skills › Scientific Agent Skills › scientific-writing › imrad_structure.md

imrad_structure.md

114 lines · skills/scientific-writing/references/imrad_structure.md at 5f2bc03

Open on GitHub

Most marks come from matching words in the file, so treat them as pointers.

1# Manuscript Structure and Consistency
2
3IMRAD is a useful default for many original-research reports, but the study design,
4reporting guideline, article type, and current journal instructions control the final
5structure [SW-S01, SW-S06].
6

Manuscript Structure and Consistency

IMRAD is a useful default for many original-research reports, but the study design, reporting guideline, article type, and current journal instructions control the final structure [SW-S01, SW-S06].

Raw lines 1 to 6
7## Title and abstract
8
9The title should identify the work accurately without adding novelty, causality, design,
10or population claims that the manuscript does not support.
12Draft the abstract after the main text. Mirror, do not reinterpret:
14- objective or question;
15- design, setting, population or material, and key methods;
16- analysis population and prespecified primary result;
17- estimate, uncertainty, denominator, and harms where relevant;
18- conclusion limited to the reported evidence.
20Structured versus unstructured format is a venue decision. Do not apply a universal
21format. Any number in the abstract must match the same concept and analysis set in the
22main text and consistency registry.

Title and abstract

The title should identify the work accurately without adding novelty, causality, design, or population claims that the manuscript does not support.

Draft the abstract after the main text. Mirror, do not reinterpret:

  • objective or question;
  • design, setting, population or material, and key methods;
  • analysis population and prespecified primary result;
  • estimate, uncertainty, denominator, and harms where relevant;
  • conclusion limited to the reported evidence.

Structured versus unstructured format is a venue decision. Do not apply a universal format. Any number in the abstract must match the same concept and analysis set in the main text and consistency registry.

Raw lines 7 to 23
24## Introduction
26Build a short evidence chain:
281. verified context;
292. what is known and uncertain;
303. the specific gap;
314. the objective, question, or prespecified hypothesis.
33Do not claim that no prior work exists unless a suitable search verifies that claim.
34Avoid previewing unsupported results or inflating significance.

Introduction

Build a short evidence chain:

  1. verified context;
  2. what is known and uncertain;
  3. the specific gap;
  4. the objective, question, or prespecified hypothesis.

Do not claim that no prior work exists unless a suitable search verifies that claim. Avoid previewing unsupported results or inflating significance.

Raw lines 24 to 35
36## Methods
38Methods should permit evaluation and, where feasible, reproduction. Cover the elements
39applicable to the design:
41- design, setting, dates, and protocol or registration;
42- participants, specimens, datasets, or source population;
43- eligibility, selection, sampling, exclusions, and analysis populations;
44- interventions, exposures, comparators, materials, instruments, and versions;
45- outcomes, predictors, thresholds, time points, and measurement methods;
46- bias controls, randomization, allocation, and masking where applicable;
47- sample-size rationale;
48- missing data, transformations, covariates, multiplicity, sensitivity analyses, and
49 statistical or computational methods;
50- confirmatory, exploratory, and descriptive status;
51- ethics, consent, privacy, data governance, and approvals only when verified;
52- data, code, materials, and protocol access conditions.
54Record deviations and timing. Never reconstruct a method from a result merely to make
55the paper appear consistent.

Methods

Methods should permit evaluation and, where feasible, reproduction. Cover the elements applicable to the design:

  • design, setting, dates, and protocol or registration;
  • participants, specimens, datasets, or source population;
  • eligibility, selection, sampling, exclusions, and analysis populations;
  • interventions, exposures, comparators, materials, instruments, and versions;
  • outcomes, predictors, thresholds, time points, and measurement methods;
  • bias controls, randomization, allocation, and masking where applicable;
  • sample-size rationale;
  • missing data, transformations, covariates, multiplicity, sensitivity analyses, and statistical or computational methods;
  • confirmatory, exploratory, and descriptive status;
  • ethics, consent, privacy, data governance, and approvals only when verified;
  • data, code, materials, and protocol access conditions.

Record deviations and timing. Never reconstruct a method from a result merely to make the paper appear consistent.

Raw lines 36 to 56
57## Results
59Follow the declared objectives and outcomes. Report:
61- participant, sample, or record flow;
62- exclusions, missingness, attrition, and analysis populations;
63- descriptive information needed for interpretation;
64- prespecified primary and secondary results;
65- estimates with units, denominators, sample sizes, and uncertainty;
66- exploratory, sensitivity, subgroup, negative, null, adverse, unexpected, and
67 inconclusive findings with correct labels;
68- protocol or analysis deviations that affect interpretation.
70Describe results before interpretation unless the venue combines Results and
71Discussion. Do not equate a threshold crossing with scientific or practical importance.

Results

Follow the declared objectives and outcomes. Report:

  • participant, sample, or record flow;
  • exclusions, missingness, attrition, and analysis populations;
  • descriptive information needed for interpretation;
  • prespecified primary and secondary results;
  • estimates with units, denominators, sample sizes, and uncertainty;
  • exploratory, sensitivity, subgroup, negative, null, adverse, unexpected, and inconclusive findings with correct labels;
  • protocol or analysis deviations that affect interpretation.

Describe results before interpretation unless the venue combines Results and Discussion. Do not equate a threshold crossing with scientific or practical importance.

Raw lines 57 to 72
73## Discussion
75Start from the verified findings, then:
77- answer the objective at the supported level of certainty;
78- compare with verified prior evidence;
79- consider alternative explanations;
80- distinguish statistical, scientific, clinical, and practical interpretation;
81- explain limitations and likely consequences;
82- bound generalizability to the studied population, material, setting, and period;
83- identify implications without prescribing action beyond the evidence.
85Do not introduce new results, methods, approvals, or citations that bypass verification.

Discussion

Start from the verified findings, then:

  • answer the objective at the supported level of certainty;
  • compare with verified prior evidence;
  • consider alternative explanations;
  • distinguish statistical, scientific, clinical, and practical interpretation;
  • explain limitations and likely consequences;
  • bound generalizability to the studied population, material, setting, and period;
  • identify implications without prescribing action beyond the evidence.

Do not introduce new results, methods, approvals, or citations that bypass verification.

Raw lines 73 to 86
87## Declarations and end matter
89Treat each statement as data, not boilerplate:
91- author contributions and accountability;
92- acknowledgments and permissions;
93- funding and the funder's role;
94- competing interests;
95- ethics, consent, and registration;
96- data, code, materials, and protocol availability;
97- AI-use disclosure;
98- references, figure legends, tables, and supplements.
100Use verified or explicit not-applicable states. Never generate an approval identifier,
101grant number, registration, author role, conflict declaration, or availability promise.

Declarations and end matter

Treat each statement as data, not boilerplate:

  • author contributions and accountability;
  • acknowledgments and permissions;
  • funding and the funder's role;
  • competing interests;
  • ethics, consent, and registration;
  • data, code, materials, and protocol availability;
  • AI-use disclosure;
  • references, figure legends, tables, and supplements.

Use verified or explicit not-applicable states. Never generate an approval identifier, grant number, registration, author role, conflict declaration, or availability promise.

Raw lines 87 to 102
103## Cross-section audit
105Before submission, compare:
107- objective ↔ outcome ↔ result ↔ conclusion;
108- methods ↔ results;
109- abstract ↔ main text ↔ tables ↔ figures ↔ supplement;
110- units, denominators, sample sizes, labels, and time points;
111- registration and protocol ↔ manuscript;
112- in-text citations ↔ source manifest ↔ reference list.
114Run `scripts/check_consistency.py` and complete a manual scientific review.

Cross-section audit

Before submission, compare:

  • objective ↔ outcome ↔ result ↔ conclusion;
  • methods ↔ results;
  • abstract ↔ main text ↔ tables ↔ figures ↔ supplement;
  • units, denominators, sample sizes, labels, and time points;
  • registration and protocol ↔ manuscript;
  • in-text citations ↔ source manifest ↔ reference list.

Run scripts/check_consistency.py and complete a manual scientific review.

Raw lines 103 to 114
Runs code scripts/check_consistency.py :114