agsy-writing-style
GitHub专为农业系统期刊优化写作风格，面向系统科学受众。聚焦摘要、亮点及图表摘要的撰写，规范引言以突出系统贡献与模型逻辑，精简篇幅至约8000字，并严格遵循Elsevier格式要求，提升文章清晰度与可读性。
Trigger Scenarios
Install
npx skills add brycewang-stanford/Awesome-Journal-Skills --skill agsy-writing-style -g -y
SKILL.md
Frontmatter
{
"name": "agsy-writing-style",
"description": "Use when drafting or polishing an Agricultural Systems (AgSy) manuscript so it reads clearly for a systems-science audience, follows the journal's format, and meets front-matter requirements (abstract <= 250 words, Highlights, graphical abstract). Research papers run to about 8,000 words (no hard cap). Tightens prose and format; it does not invent content."
}
Writing Style (agsy-writing-style)
An AgSy paper must be readable by a broad systems-science audience — agronomists, modellers, economists, and environmental scientists — and prepared with the journal's front matter. This skill is about communicating a systems analysis clearly and meeting Elsevier's format, not about generating claims.
When to trigger
- Drafting the introduction, framing the contribution, or final polish
- Writing the ≤ 250-word abstract, the Highlights, or the graphical abstract
- Tightening a long methods/results section toward the ~8,000-word guideline
- Aligning references and format to the journal's style before submission
Reach the systems-science audience
- Front-load the systems contribution. By the end of the introduction the reader knows the system, the interaction/trade-off in question, the modelling approach, and why the result matters. Don't make a reader dig for the "so what."
- Define the system early. State boundary, components, and hierarchical level so a non-specialist
in your exact subsystem can follow (see
agsy-systems-framing-and-modeling). - Explain the model in plain terms first, then in detail. A reader should grasp what the model does before meeting its equations.
- Argument-first prose. Lead with the systems insight; use model output and statistics to support it. Avoid "the model shows…" without saying what it shows about the system and why it matters.
- Signpost. Clear IMRaD-style structure so a reader can navigate framing → model → evaluation → trade-offs → implications.
Format & front matter (source map refreshed 2026-06-20)
- Abstract: ≤ 250 words, stating purpose, principal results, and major conclusions.
- Highlights: 3-5 short bullet points, each no more than 85 characters including spaces.
- Graphical abstract: a separate figure file summarizing the work for an interdisciplinary audience — often a conceptual system diagram or a trade-off result; live-check current size/format specs.
- References: format to the journal's style; manage with Zotero/Mendeley/BibTeX (Elsevier
elsarticlefor LaTeX). - Declarations: CRediT roles, declaration of competing interest, funding, and AI-use disclosure
where applicable (see
agsy-submission).
Length discipline (research paper ~8,000 words; no hard cap)
- Move full calibration tables, parameter lists, and exhaustive scenario grids to supplementary material.
- Cut throat-clearing and literature dumps; engage the systems debate, not every paper.
- Prefer one decisive trade-off figure to three redundant tables.
Anti-patterns
- An intro that never states the systems contribution or the trade-off at stake
- An abstract over 250 words, or one that hides the result; missing Highlights / graphical abstract
- Dropping a model's equations on the reader before explaining what it does
- Describing a single factor as if it were a system; burying the interaction
- Mixed reference styles or missing declarations
Section-by-section moves for a systems paper
Write each section to answer the question a systems referee raises there. Title: name the system and the trade-off, not just the crop. Abstract: lead with the interaction, end on the decision (≤250 words). Introduction: state boundary, interaction, model, and stakes by the last paragraph. Methods: plain-language model first, equations second. Results/Discussion: lead with the trade-off, then tie it to the decision and match claims to uncertainty.
Worked micro-example: tightening one abstract sentence (illustrative)
Before (buries the system): "Simulations were run for several management options and yields compared across scenarios." — passive, no interaction, no trade-off, no decision.
After (systems-first): "A whole-farm bioeconomic model shows that shifting 30% of area to a legume intercrop raises modelled gross margin ~8% but increases nitrogen surplus ~14%, sharpening a margin–environment trade-off advisers must weigh when targeting rotation subsidies." — interaction, quantified trade-off (illustrative), and decision in one sentence.
Referee pushback on writing → the AgSy-specific fix
- "I could not tell what the system was." → Add a boundary-and-components sentence plus a conceptual diagram early; define the hierarchical level explicitly.
- "The contribution reads as single-discipline." → Reframe the intro around the systems debate and
engage both the domain and modelling literatures (see
agsy-literature-positioning). - "The model arrives as a wall of equations." → Lead with plain English on what it does.
Calibration anchors (hedged where uncertain)
- The ≤250-word abstract, Highlights, and graphical abstract are standing Elsevier front-matter expectations; confirm exact requirements on the current author guidelines.
- The ~8,000-word figure is a guideline, not a hard cap — judgment plus current guidance governs length.
Output format
【Systems contribution stated by end of intro?】[Y/N]
【System defined early?】boundary + components + level? [Y/N]
【Abstract】word count (≤250)
【Highlights + graphical abstract】prepared? [Y/N]
【Length】near ~8,000 words; extras moved to supplementary? [Y/N]
【References + declarations】styled + CRediT/COI/funding/AI disclosure ready? [Y/N]
【Next】agsy-impact-and-implications
Supplementary resources
../../resources/external_tools.md— reference managers and Elsevier typesetting tools../../resources/official-source-map.md— abstract cap, Highlights, graphical abstract, declarations
Version History
- 1839142 Current 2026-07-05 12:16
