Nature Writing

# `nature-writing` skill

A Nature-style manuscript writing skill for drafting or rebuilding sections from
author-provided claims, figures, results, notes, or Chinese drafts.

## What it does

`nature-writing` helps write:

- titles
- abstracts
- introductions
- results narratives
- discussions
- conclusions
- significance paragraphs
- manuscript outlines

It is for argument construction and section drafting. For sentence-level polish
of an existing draft, use `nature-polishing`.

## Built from

Close reading of curated Nature and Nature Communications research articles
across materials, energy systems, construction decarbonization and machine
learning, combined with the existing writing-strategy rules in this repository.

Section-level writing and reviewer-facing self-review guidance is also adapted
from Prof. Peng Sida's open research-writing notes:

- https://pengsida.notion.site/c1a22465a0fa4b15a12985223916048e
- https://github.com/pengsida/learning_research

## File structure

```text
nature-writing/
├── README.md
├── SKILL.md
└── references/
    ├── abstract.md
    ├── article-architecture.md
    ├── chinese-author-workflow.md
    ├── conclusion.md
    ├── experiments.md
    ├── introduction.md
    ├── method.md
    ├── paper-review.md
    ├── paragraph-flow.md
    ├── related-work.md
    └── examples/
```

## Key rules

| Domain | Core rule |
|---|---|
| Evidence first | Do not invent data, mechanisms, statistics, sample sizes or novelty |
| Abstract | Context, gap, approach, key result, implication, boundary |
| Introduction | Field scale, bottleneck, prior attempts, unresolved gap, present study |
| Method | Explain module motivation, design, forward process, and technical advantage |
| Results | Build an evidence ladder, not a chronological lab diary |
| Experiments | Tie every major claim to comparison, ablation, metric, or stress-test evidence |
| Discussion | Explain meaning, prior-work relation, constraints and future use |
| Review | Run adversarial self-review before submission |
| Chinese notes | Translate intent and argument, not clause order |


---
name: nature-writing
description: Draft, restructure, or plan Nature-style manuscript sections from author-provided claims, results, figures, notes, or Chinese drafts. Use when the user wants to write or rebuild an abstract, introduction, results narrative, discussion, conclusion, title, or full manuscript argument rather than only polish finished prose.
version: 0.2.0
author: Community contribution based on curated Nature/Nature Communications writing patterns and open research-writing notes
---

# Nature-Style Scientific Writing

Use this skill when the user needs help creating or rebuilding manuscript prose,
not merely polishing existing sentences.

## Core stance

- Author evidence comes first. Do not invent results, mechanisms, references,
  methods, novelty, sample sizes, statistics or limitations.
- Write the argument before writing the sentences.
- Make the paper easy to judge: relevance, novelty, trust, reuse and meaning.
- Use ambitious but bounded claims.
- If essential evidence is missing, write a placeholder or ask for the missing
  input instead of filling the gap.

## When to open extra files

| File | Open when |
|---|---|
| [references/article-architecture.md](references/article-architecture.md) | You need section-level structure, argument order, or published-article writing patterns |
| [references/abstract.md](references/abstract.md) | Drafting or revising an abstract, especially challenge-contribution and challenge-insight-contribution forms |
| [references/introduction.md](references/introduction.md) | Drafting or revising an Introduction, task framing, technical challenge, contribution framing, or teaser/pipeline logic |
| [references/related-work.md](references/related-work.md) | Rebuilding Related Work as topic synthesis instead of a paper-by-paper list |
| [references/method.md](references/method.md) | Writing Method sections, pipeline mo