skills/scientific-writing/references/writing_principles.md
The accountable human authors are responsible for accuracy, integrity, originality, attribution, and disclosure, including material prepared with AI assistance [SW-S01, SW-S03]. Do not improve prose by changing scientific meaning.
Apply these rules:
Label analyses according to their actual provenance.
Do not relabel a post hoc analysis as prespecified. Explain amendments, timing, and rationale. Keep exploratory results useful but visibly exploratory.
Retain findings regardless of direction:
Selective omission can distort the record. Corrections should be prompt, transparent, and linked to the affected version [SW-S01, SW-S27].
Every reported number needs:
Keep precision justified by measurement and analysis. Distinguish zero from missing, below detection, not measured, and not applicable. Run the consistency checker after every substantive edit.
Methods describe what was actually done, not what would have been ideal. Results must not introduce an undeclared method. For each result, verify:
Name concrete sources of bias, imprecision, missingness, measurement error, model limitations, multiplicity, and limited transportability. Explain likely direction or consequence when evidence supports that explanation. Do not add a generic limitations paragraph merely to satisfy form.
Prefer direct, precise prose, but do not impose arbitrary sentence length, citation density, recency percentage, figure count, or reference count. Those heuristics can encourage unsupported content and vary by field and venue.
Use person-centered or identity-affirming language according to community preference, study context, and current venue policy. Preserve participant self-description when appropriate. Define abbreviations and use one term for one concept.
Bullets, notes, and placeholders are acceptable in an internal outline. They are not submission-ready. Final structure may include lists when the target venue or content benefits from them; there is no universal rule that every scientific section must be continuous prose.