# Sci Writing

> Use when choosing the Science (AAAS) format (Research Article vs Report) and holding its length and structure budgets — main-text word caps, figure caps, argument-ordered Results, and deciding what belongs in the main text versus Supplementary Materials.

- Skill: `thedixitjain/sci-writing` (Agent Skill)
- Install (CLI): `npx skillmds add thedixitjain/sci-writing`
- Raw SKILL.md: https://api.skillmd.com/api/skills/thedixitjain/sci-writing/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: thedixitjain (https://skillmd.com/u/thedixitjain)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/thedixitjain/sci-writing

---



# Main-Text Writing & Format (sci-writing)

## When to trigger

- Unsure whether the work is a **Report** or a **Research Article**.
- The main text is over length, or Methods are bloating the body.
- The structure wanders (lab-notebook order instead of argument order).
- Co-authors keep adding paragraphs and the paper is creeping past budget.

## Pick the format first

| Format               | Use when                                                | Main-text target | Display items |
|----------------------|---------------------------------------------------------|------------------|---------------|
| **Report**           | A single, decisive advance told quickly                 | ~2,500 words     | ≤ 4 (figs+tables) |
| **Research Article** | A larger study needing more development/multiple results | ~4,500 words     | ≤ 6 (figs+tables) |

> Numbers are working targets; confirm current caps in the author guidelines. The principle is fixed: **Science main texts are short**, and most detail lives in Supplementary Materials.

## What goes where

- **Main text (Report)**: no section headers beyond the flow; combined results-and-discussion narrative. **Methods are NOT in the main text** — they go to Supplementary Materials (Materials and Methods).
- **Main text (Research Article)**: may use brief headers; still lean. Extended methods → Supplementary.
- **Supplementary Materials**: full Materials and Methods, supplementary figures/tables, supplementary text, captions, and additional data. This is where rigor lives without bloating the body.

## Structure as argument, not chronology

Order the Results by the **logic of the claim**, not the order experiments were run:

1. Establish the phenomenon (the headline result).
2. Rule out the obvious alternative explanations.
3. Show the mechanism / generality.
4. Demonstrate the broad implication.

Each Results paragraph: **claim sentence first**, then the evidence (figure callout + numbers), then the inference.

## Length discipline tactics

- One idea per paragraph; lead sentence is the claim.
- Move any sentence that a general reader can skip → Supplementary.
- Methods detail, validation, controls → Supplementary (cited as "fig. S3", "table S1").
- Cut "In order to" → "To"; cut "It is worth noting that"; cut throat-clearing.

## Before/after: compressing to the Science register

Science prose earns its word budget sentence by sentence. Typical compressions:

| Draft (lab-report register) | Science register |
|-----------------------------|------------------|
| "In order to investigate whether X affects Y, we performed a series of experiments in which…" | "To test whether X affects Y, we…" |
| "It is worth noting that the observed effect was statistically significant (p < 0.05)." | "The effect was robust (Δ = 12 ± 2%, P = 0.003, n = 14)." |
| "As can be seen in Fig. 2, there appears to be a trend toward increased activity." | "Activity increased threefold (Fig. 2)." |
| "These results may suggest a possible role for Z in this process." | "Z is required for this process (fig. S4)." |

The pattern: verbs over nominalizations, numbers over adjectives, one hedge maximum per claim, and every figure callout attached to a quantitative statement rather than "as shown in".

## What Science referees expect from the body text

- Each Results paragraph is checkable: a referee can match the claim sentence to a specific panel and a specific statistic without hunting.
- Alternative explanations are ruled out **in the main text**, even if the ruling-out data live in the SM ("this was not due to A or B; figs. S5 and S6").
- The final paragraph states scope and limits in one or two sentences — referees at a general-science weekly flag manuscripts whose conclusions quietly exceed the shown systems or conditions.
- No forward references to unpublished work as load-bearing evidence.

## Reference and supplement cross-refs

- Main figures: "Fig. 1"; supplementary: "fig. S1" (lowercase f); tables: "Table 1" / "table S1".
- Supplementary Materials are cited in the main text and listed at the end.

## Output format

```
【Format】 Report (~2,500w / ≤4 items) or Research Article (~4,500w / ≤6 items)
【Current main-text word count】 N → over/under budget by M
【Methods location】 main text (FIX → move to SM) / Supplementary (ok)
【Results order】 argument-ordered? yes/no
【Items in main vs SM】 main: [...] / SM: [...]
【Next】 sci-figures
```

## Anti-patterns

- **Do not** keep a full Methods section in a Report's main text.
- **Do not** structure Results chronologically when a logical order is clearer.
- **Do not** treat the word cap as negotiable by shrinking font in figures — move content to SM instead.
- **Do not** add a standalone Discussion that repeats Results; integrate the interpretation.

---

**Source:** [`brycewang-stanford/Awesome-Journal-Skills`](https://github.com/brycewang-stanford/Awesome-Journal-Skills) → `Science-Skills/skills/sci-writing/SKILL.md`