Writing Style (gec-writing-style)
A GEC paper must be rigorous and readable across disciplines. Reviewers and readers come from
environmental social science, governance, economics, geography, and the natural sciences, and many read
for policy relevance. Write so each of them can follow the argument — within the length caps.
When to trigger
- Drafting the introduction, abstract, or discussion
- A reviewer said the paper is "hard to follow," "jargon-heavy," or "buries the contribution"
- Cutting to meet the word cap (Research Articles up to 8,000 words; Perspectives up to 3,000 words;
abstract <=250 words)
- Writing the abstract and the plain-language framing
What GEC prose does well
- Front-load the contribution. The introduction states the human/policy problem, the gap, the
framework, and the contribution within the first page — not after a long literature tour.
- Define terms once, use them consistently. Contested concepts (vulnerability, resilience,
governance, transition) get one definition and stick to it.
- Minimize discipline-specific jargon. Explain unavoidable technical terms; an interdisciplinary
reader should not need a glossary. Spell out acronyms on first use.
- Connect to scale and stakes. Remind the reader why the result matters across scales and for
societies — without overclaiming.
- Discussion that earns the conclusion. Interpret results against the framework, state scope
conditions and limitations honestly, and set up the policy implications (
gec-policy-relevance-and-implications).
The abstract (<=250 words)
- State the problem, approach, key finding, and significance for the human/policy dimension.
- Avoid undefined jargon; an editor from another field decides desk-fate partly on the abstract.
Length discipline
- Research Articles up to 8,000 words (including main body text and table/figure captions, excluding
references); cut method minutiae to supplementary material rather than diluting the argument.
- Perspective articles up to 3,000 words (excluding references) must be argument-led; if the paper
needs methods/data-analysis description, route it as a Research Article.
- Every section should advance the contribution; if a paragraph does not, cut or move it.
Anti-patterns
- A long literature review before the reader knows the contribution
- Jargon or acronyms unexplained for an interdisciplinary audience
- Inconsistent use of a key concept across sections
- Overclaiming policy impact the evidence does not support
- Going over the word/abstract cap (front-page issue at submission)
Output format
【Contribution stated by】page/paragraph (front-loaded? Y/N)
【Jargon check】terms defined; acronyms spelled out? [Y/N]
【Abstract】word count (<=250) + states problem/approach/finding/significance?
【Length】within the chosen article-type cap? [Y/N]
【Limitations】stated honestly? [Y/N]
【Next】gec-policy-relevance-and-implications
Supplementary resources
Source: brycewang-stanford/Awesome-Journal-Skills → Global-Environmental-Change-Skills/skills/gec-writing-style/SKILL.md
1---2name: gec-writing-style3description: Use when drafting or polishing the prose of a Global Environmental Change (GEC) manuscript so it reads for an interdisciplinary, policy-relevant audience within the word and abstract caps. GEC values clarity and rigor that travel across disciplines. Polishes the writing; it does not draft the analysis.4---567# Writing Style (gec-writing-style)89A GEC paper must be **rigorous and readable across disciplines**. Reviewers and readers come from10environmental social science, governance, economics, geography, and the natural sciences, and many read11for policy relevance. Write so each of them can follow the argument — within the length caps.1213## When to trigger1415- Drafting the introduction, abstract, or discussion16- A reviewer said the paper is "hard to follow," "jargon-heavy," or "buries the contribution"17- Cutting to meet the word cap (Research Articles up to 8,000 words; Perspectives up to 3,000 words;18 abstract <=250 words)19- Writing the abstract and the plain-language framing2021## What GEC prose does well22231. **Front-load the contribution.** The introduction states the human/policy problem, the gap, the24 framework, and the contribution within the first page — not after a long literature tour.252. **Define terms once, use them consistently.** Contested concepts (vulnerability, resilience,26 governance, transition) get one definition and stick to it.273. **Minimize discipline-specific jargon.** Explain unavoidable technical terms; an interdisciplinary28 reader should not need a glossary. Spell out acronyms on first use.294. **Connect to scale and stakes.** Remind the reader why the result matters across scales and for30 societies — without overclaiming.315. **Discussion that earns the conclusion.** Interpret results against the framework, state scope32 conditions and limitations honestly, and set up the policy implications (`gec-policy-relevance-and-implications`).3334## The abstract (<=250 words)3536- State the **problem, approach, key finding, and significance** for the human/policy dimension.37- Avoid undefined jargon; an editor from another field decides desk-fate partly on the abstract.3839## Length discipline4041- Research Articles **up to 8,000 words** (including main body text and table/figure captions, excluding42 references); cut method minutiae to supplementary material rather than diluting the argument.43- Perspective articles **up to 3,000 words** (excluding references) must be argument-led; if the paper44 needs methods/data-analysis description, route it as a Research Article.45- Every section should advance the contribution; if a paragraph does not, cut or move it.4647## Anti-patterns4849- A long literature review before the reader knows the contribution50- Jargon or acronyms unexplained for an interdisciplinary audience51- Inconsistent use of a key concept across sections52- Overclaiming policy impact the evidence does not support53- Going over the word/abstract cap (front-page issue at submission)5455## Output format5657```58【Contribution stated by】page/paragraph (front-loaded? Y/N)59【Jargon check】terms defined; acronyms spelled out? [Y/N]60【Abstract】word count (<=250) + states problem/approach/finding/significance?61【Length】within the chosen article-type cap? [Y/N]62【Limitations】stated honestly? [Y/N]63【Next】gec-policy-relevance-and-implications64```6566## Supplementary resources6768- [`../../resources/external_tools.md`](../../resources/external_tools.md) — reference managers and typesetting69- [`../../resources/official-source-map.md`](../../resources/official-source-map.md) — word/abstract caps and style notes7071---7273**Source:** [`brycewang-stanford/Awesome-Journal-Skills`](https://github.com/brycewang-stanford/Awesome-Journal-Skills) → `Global-Environmental-Change-Skills/skills/gec-writing-style/SKILL.md`
thedixitjain