Agent skill

Nature-Style Scientific Writing

by Yuan1z0825 in Yuan1z0825/nature-skills

Drafts or restructures manuscript sections, arguments and first-submission materials from author-provided evidence, routed by task, paper type, section, language and journal.

Apache-2.0Auto-check passedResearch & Science

Install Nature-Style Scientific Writing

skills CLI
$ npx skills add Yuan1z0825/nature-skills --skill nature-writing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Yuan1z0825/nature-skills nature-writing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Yuan1z0825/nature-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/nature-writing .claude/skills/nature-writing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
nature-writing
GitHub stars
47k
Token cost
~2k tokens
SKILL.md length
923 words
Files
89 (incl. references)
Skills in repo
23
Repo updated
First seen
Licence
Apache-2.0

At a glance

Drafts or restructures manuscript sections, arguments and first-submission materials from author-provided evidence, routed by task, paper type, section, language and journal.

  • Works in 5 steps: Load the manifest and the core layer → Detect the axis values for this request → Load the matching fragments → …
  • Drafting a section of a research manuscript from your results
  • SKILL.md covers Routing protocol and Submission boundary
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The skill is a router. It reads manifest.yaml, which declares the axes task (manuscript or submission package), paper type (research, methods, hypothesis, algorithmic or review), section, language (English or Chinese-to-English) and journal (Nature, Nature family, Nature Communications, Nature Machine Intelligence or generic), plus the always-loaded core files on stance, writing workflow and output format. It states the detected values in one line, then loads only the matching fragments.

Drafting applies the loaded material in order: core stance and intake, which surface missing claims, evidence and boundaries before any writing, then the paper-type playbook, section-specific rules and journal and language material. The folder holds many reference files, including guides for the abstract, article architecture and conclusion, a Chinese-author workflow, and example templates. Language-only edits belong to nature-polishing, and post-decision correspondence to nature-response.

When your agent uses it

  • Drafting a section of a research manuscript from your results
  • Rebuilding the argument of a paper that reads as a list of findings
  • Preparing first-submission materials for a journal
  • Condensing a long manuscript body

Example prompts

  • “Draft the introduction for my methods paper from these notes and results.”
  • “Restructure the discussion so each claim is tied to its evidence and boundary.”
  • “Prepare first-submission materials for Nature Machine Intelligence from the attached manuscript.”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Load the manifest and the core layer
  2. Detect the axis values for this request
  3. Load the matching fragments
  4. Draft using the loaded material
  5. Reach for references only when needed

What it can do on your machine

Read from SKILL.md and the folder at commit e605b35. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nature-Style Scientific Writing loads about 2k tokens when it runs, and up to ~34k if it reads all its reference files. Until then it costs about 74 tokens; SKILL.md has 923 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~74
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~34k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Yuan1z0825/nature-skills at commit e605b35, republished under its Apache-2.0 licence (© Yuan1z0825). 923 words, ~2,044 tokens.

Download SKILL.mdSave it as .claude/skills/nature-writing/SKILL.md (or your agent's skills folder). This skill also uses 88 other files; get the full folder from GitHub.
name
nature-writing
description
Draft or restructure scientific manuscript arguments, sections, and initial-submission materials from author-provided evidence. Use for 论文写作、章节起草、论证重构、正文压缩、首次投稿材料. Use nature-polishing for language-only edits to existing prose and nature-response for post-decision correspondence.

Nature-Style Scientific Writing — Router

Routing protocol

For a new drafting task, follow the routing below. For follow-up edits, reuse established task choices and already loaded guidance; read additional fragments only when the requested scope changes.

1. Load the manifest and the core layer

Read manifest.yaml. It declares the axes (task, paper_type, section, language, journal), the allowed values, and the file paths each value maps to.

Also read every file listed under always_load. These hold the default stance, writing workflow, and output format that apply to every drafting job.

2. Detect the axis values for this request

For each axis in the manifest, decide the value using the manifest's detect: hint and the user's input:

  • task — manuscript / submission-package. Use submission-package for first-submission materials, never for revision correspondence.
  • paper_type — research / methods / hypothesis / algorithmic / review. Default: research.
  • section — abstract / intro / related-work / method / experiments / discussion / conclusion / title. May be multiple. Ask the user if it is ambiguous and matters for the draft.
  • language — en or zh-to-en. Detect from the user's notes themselves.
  • journal — nature / nature-family / nat-comms / nat-mach-intell / generic. Default: generic. Use nature only for the flagship journal Nature, nat-comms for Nature Communications, nat-mach-intell for Nature Machine Intelligence (NMI), and nature-family for other Nature Portfolio titles or an unspecified Nature-family request.

State the detected axis values in one short line to the user before drafting, so they can correct you cheaply. This is a progress update, not an approval gate; continue unless a necessary decision remains unresolved.

3. Load the matching fragments

For each axis value, Read the file mapped in the manifest. Skip the section axis when the task is submission-package or when the user explicitly asks for a free-floating argument paragraph with no section context.

Do not read every fragment in static/. Load only what step 2 selected.

4. Draft using the loaded material

Apply the loaded fragments in this priority order:

  1. Core stance + intake (core/stance.md) — surface missing claim / evidence / boundary before drafting.
  2. Paper-type playbook — argument chain, drafting order.
  3. Section-specific drafting rules and structure.
  4. Task-specific submission rules when task=submission-package.
  5. Journal-specific framing and constraints.
  6. Language-specific sentence and paragraph rules (apply last).

For task=manuscript, use core/workflow.md at the requested scale. Plan the argument for a new section or substantial restructuring; a title, single paragraph, or local follow-up needs only the applicable evidence, wording, and consistency checks. Complete the requested prose unless a material unresolved decision blocks it or the user requested an outline for approval first.

When drafting or restructuring Results, or compressing a full manuscript's main text, also load ../nature-shared/core/main-text-discipline.md before building the paragraph map. Classify every result by function, allocate it across main text, captions, Methods/source data, and SI, then draft the shortest sufficient evidence chain. Do not equate a complete analysis record with a complete main text.

When the target is flagship Nature, Nature Communications, Nature Machine Intelligence, or another Nature Portfolio title, load the matching shared Nature-style corpus guidance for the section being drafted:

  • Results or Discussion → ../nature-shared/core/nature-results-discussion.md
  • Introduction or whole-manuscript narrative → ../nature-shared/core/nature-introduction.md
  • Abstract → ../nature-shared/core/nature-abstract.md

Use these files for claim escalation, question-chain alignment, discovery-centred compression, and synthesis. They were initially distilled from published NMI papers and generalized as Nature-style defaults; do not present them as official policy, and let the target journal's current rules override them.

For any Discussion drafting, restructuring, or section audit, also load ../nature-shared/core/discussion-argument-language.md. Use it to select the opening anchor, control the reverse-funnel expansion, distinguish literature positioning from citation decoration, calibrate modal strength to evidence, and turn limitations and future work into claim-specific reasoning. This is general writing guidance rather than an official journal rule.

For task=submission-package, follow static/fragments/task/submission-package.md and references/submission-package.md instead. Build the deliverable matrix and readiness audit; do not force manuscript paragraph architecture onto administrative submission materials.

If essential evidence or boundary is missing, write a placeholder and list it under Assumptions or missing inputs: instead of inventing content.

Show full SKILL.md (283 more words)Show less
5. Reach for references only when needed

The files under references/ are deep references and the example library, not defaults. Open them on demand per the references.on_demand table in the manifest. Typical triggers:

  • The user asks for a concrete example or template → references/examples/index.md.
  • A section's draft has structural problems that the section fragment alone does not explain → the matching references/<section>.md.
  • The user needs a broad-audience Nature abstract opening or asks about a summary paragraph → references/nature-summary-paragraph.md.
  • The user asks "does this paragraph flow?" → references/paragraph-flow.md.
  • The user asks for a self-review or rejection-risk audit → references/paper-review.md.
  • The user asks what belongs in the main text, captions, or SI; wants a shorter Results section; or is adding reviewer-driven explanation → ../nature-shared/core/main-text-discipline.md.
  • The user requests a complete first-submission package, templates, or a submission-readiness audit → references/submission-package.md.
  • The target is the flagship journal Nature and exact submission or formatting requirements matter → ../nature-shared/journal-formats/nature.md.
  • The target is Nature Machine Intelligence and exact content-type, submission, data/code or production requirements matter → ../nature-shared/journal-formats/nature-machine-intelligence.md.
  • Any Nature / Nature Portfolio target needs Results claim progression, evidence-bound interpretation, robustness placement, or Discussion synthesis → ../nature-shared/core/nature-results-discussion.md.
  • Any target needs a Discussion function chain, evidence-calibrated modal language, claim-specific limitations, non-redundant literature positioning, or uncertainty-driven future work → ../nature-shared/core/discussion-argument-language.md.
  • Any Nature / Nature Portfolio target needs an Introduction funnel, exact gap, literature logic, question-first novelty, study roadmap, or alignment with Results → ../nature-shared/core/nature-introduction.md.
  • Any Nature / Nature Portfolio target needs abstract evidence-chain, main/supporting-claim, numeric-result, or final-payoff decisions → ../nature-shared/core/nature-abstract.md.
  • The work involves regulated or specialist research compliance → ../nature-shared/core/research-compliance.md.

Submission boundary

  • nature-writing owns initial submission materials prepared before peer review.
  • nature-response owns revision cover letters, rebuttals, point-by-point responses, marked manuscripts, appeals, and other post-decision correspondence.
  • Route graphical abstracts and TOC graphics to nature-figure; route simulated pre-submission peer review to nature-reviewer.

© Yuan1z0825, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 88 other files (references) in skills/nature-writing of Yuan1z0825/nature-skills.

  • SKILL.md
  • README.md
  • README_EN.md
  • agents/openai.yaml
  • manifest.yaml
  • references/abstract.md
  • references/article-architecture.md
  • references/chinese-author-workflow.md
  • references/conclusion.md
  • references/examples/abstract-examples.md
  • references/examples/abstract/template-a.md
  • references/examples/abstract/template-b.md
  • references/examples/abstract/template-c.md
  • references/examples/index.md
  • references/examples/introduction-examples.md
  • references/examples/introduction/novel-task-challenge-decomposition.md
  • … and 73 more

Open the folder on GitHubat commit e605b35

Compare with similar skills

Nature-Style Scientific Writing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nature-Style Scientific Writing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nature-Style Scientific Writing this skillYuan1z0825/nature-skills47k—~2kAutomated safety check: PassApache-2.0
Championship Mode Paper ReviewWuXinbo-bo/Math-model-skills111—~437Automated safety check: PassMIT
Citation Verification GuideGalaxy-Dawn/claude-scholar5.7k2 repos~1.9kAutomated safety check: PassMIT
Academic Paper Writing PipelineImbad0202/academic-research-skills51k—~16kAutomated safety check: PassCustom licence
Academic Paper ReviewerImbad0202/academic-research-skills51k—~11kAutomated safety check: PassCustom licence
Academic HumanizerAIScientists-Dev/academic-humanizer1.9k1 repos~4.2kAutomated safety check: PassMIT

Similar skills

  • Championship Mode Paper Review

    WuXinbo-bo/Math-model-skills

    Runs several independent review rounds on a finished math-modeling competition paper and rewrites it until it clears a fixed score and defect bar.

    111 GitHub stars~437 tokensUpdated 20 days ago
    Research & ScienceAuto-check passed
  • Citation Verification Guide

    Galaxy-Dawn/claude-scholar

    Reference guidance for checking every citation in academic writing against canonical sources such as DOI, arXiv, CrossRef and Semantic Scholar, to catch fake or wrong references.

    5.7k GitHub starsUsed in 2 repos~1.9k tokens
    Research & ScienceAuto-check passed
  • Academic Paper Writing Pipeline

    Imbad0202/academic-research-skills

    Runs a 12-agent pipeline that plans, drafts, cites, reviews and formats academic papers, with modes for revision, rebuttals, abstracts and citation checks.

    51k GitHub stars~16k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Academic Paper Reviewer

    Imbad0202/academic-research-skills

    Simulates a journal peer review of a manuscript with a five-seat reviewer panel, an editorial synthesizer and several review modes.

    51k GitHub stars~11k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Academic Humanizer

    AIScientists-Dev/academic-humanizer

    Improve the clarity and voice of AI-assisted academic writing (papers, theses, rebuttals) and funding proposals (NSF Project Summary/Description, NIH Specific Aims): preserve scholarly conventions…

    1.9k GitHub starsUsed in 1 repo~4.2k tokens
    Research & ScienceAuto-check passed
  • Academic Research Pipeline

    Imbad0202/academic-research-skills

    Orchestrates a ten-stage academic workflow from research to finished manuscript, including integrity checks, two rounds of peer review and revision.

    51k GitHub stars~15k tokensUpdated yesterday
    Research & ScienceAuto-check passed

More from Yuan1z0825/nature-skills

All 23 skills in this repo
  • Nature Paper Card

    Yuan1z0825/nature-skills

    Builds a structured deep-reading card for one scientific paper, covering methods, how experiments support claims, limitations and research ideas, with a script to prepare the source.

    47k GitHub starsUsed in 2 repos~2.1k tokens
    Auto-check passed
  • Nature-Style Scientific Figures

    Yuan1z0825/nature-skills

    Creates, revises, audits and exports manuscript-ready scientific figures in Python or R, and routes AI-generated graphical abstracts to a separate workflow.

    47k GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • Paper to Chinese Patent Drafter

    Yuan1z0825/nature-skills

    Drafts Chinese invention patent applications and technical disclosures from research papers or inventor materials, tying each claim feature to source evidence.

    47k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Researchwrite Proposal Pipeline

    Yuan1z0825/nature-skills

    Composes, revises or audits research proposals and opening reports through an evidence-first state machine with argument maps, section contracts and dynamic expert reviewers.

    47k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Nature Literature Downloader

    Yuan1z0825/nature-skills

    Routes literature requests to lawful full-text sources: open access, publisher APIs, CNKI and institutional browser access, with a supporting-information gate.

    47k GitHub starsUsed in 2 repos~6k tokens
    Auto-check passed
  • Image to Editable PPTX

    Yuan1z0825/nature-skills

    Rebuilds slide images, screenshots, scanned PDFs or image-only PPTX files as PowerPoint with editable objects, using a local CLI with per-page manifests and QA.

    47k GitHub stars~2.5k tokensUpdated today
    Auto-check passed

Questions about Nature-Style Scientific Writing

What does Nature-Style Scientific Writing do?

Drafts or restructures manuscript sections, arguments and first-submission materials from author-provided evidence, routed by task, paper type, section, language and journal. The skill is a router.yaml, which declares the axes task (manuscript or submission package), paper type (research, methods, hypothesis, algorithmic or review), section, language (English or Chinese-to-English) and journal (Nature, Nature family, Nature Communications, Nature Machine Intelligence or generic), plus the always-loaded core files on stance, writing workflow and output format.

When should I use Nature-Style Scientific Writing?

Nature-Style Scientific Writing fits situations like: drafting a section of a research manuscript from your results; rebuilding the argument of a paper that reads as a list of findings; preparing first-submission materials for a journal; condensing a long manuscript body.

How do I install Nature-Style Scientific Writing in Claude Code?

Run `npx skills add Yuan1z0825/nature-skills --skill nature-writing -a claude-code`. Or copy the skill folder (skills/nature-writing in Yuan1z0825/nature-skills) into .claude/skills/nature-writing in your project. Claude Code loads it when a task matches its description.

How do I install Nature-Style Scientific Writing in Codex?

Run `npx skills add Yuan1z0825/nature-skills --skill nature-writing -a codex`. Or copy the skill folder (skills/nature-writing in Yuan1z0825/nature-skills) into .agents/skills/nature-writing in your project. Codex loads it when a task matches its description.

Can I use Nature-Style Scientific Writing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Yuan1z0825/nature-skills --skill nature-writing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nature-writing, .gemini/skills/nature-writing, .github/skills/nature-writing and .opencode/skills/nature-writing in your project.

What does Nature-Style Scientific Writing need to run?

SKILL.md names no scripts, command-line tools or credentials: Nature-Style Scientific Writing is instructions for the agent only.

Does Nature-Style Scientific Writing access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Nature-Style Scientific Writing safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Nature-Style Scientific Writing use?

Nature-Style Scientific Writing is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nature-Style Scientific Writing use?

About 2k tokens (SKILL.md is roughly 8.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 32k tokens, read only when the agent opens those files.

What are the alternatives to Nature-Style Scientific Writing?

Skills that share tags, products or a category with Nature-Style Scientific Writing: Championship Mode Paper Review (WuXinbo-bo/Math-model-skills, 111 stars), Citation Verification Guide (Galaxy-Dawn/claude-scholar, 5.7k stars), Academic Paper Writing Pipeline (Imbad0202/academic-research-skills, 51k stars) and Academic Paper Reviewer (Imbad0202/academic-research-skills, 51k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nature-Style Scientific Writing?

Yuan1z0825 (a GitHub user) maintains it in Yuan1z0825/nature-skills, which has 47,222 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 11, 2026.

Source: Yuan1z0825/nature-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.