New to Claude Skills? Learn how to install them →

yuan1z0825 on GitHub

Nature-Style Academic Polishing

Free

Refine your academic writing for Nature journals.

Get this skill

Free · Opens the source repo

What Nature-Style Academic Polishing does

Nature-Style Academic Polishing is designed for researchers and academics who need to enhance their manuscripts, abstracts, and sections to meet the high standards of Nature and Nature Communications. This skill leverages a structured approach to polish academic prose, ensuring clarity, coherence, and adherence to specific journal requirements. It incorporates writing strategies, curated patterns from Nature articles, and guidance from the Academic Phrasebank to transform drafts into publication-ready documents.

The skill operates through a two-layer system. The static layer contains reusable content fragments that cover core principles, paper types, and section-specific guidance, while the dynamic layer functions as a routing protocol that detects the user's request and loads only the relevant fragments. This ensures that the polishing process is efficient and tailored to the specific needs of the manuscript. Users can invoke the skill for various sections of their papers, including the introduction, methods, results, and discussions, or even for translating Chinese academic drafts into polished English.

In addition to text polishing, the skill addresses common LaTeX layout issues, such as poorly arranged figures, stray section headings, and empty supplementary information. This is particularly useful for users who are preparing their manuscripts for submission and want to ensure that both the content and formatting meet the expectations of their target journals.

Overall, Nature-Style Academic Polishing is an essential tool for academics aiming to improve their writing quality and presentation. Whether you're drafting a research paper or revising a manuscript for submission, this skill provides the necessary resources and guidance to enhance your work effectively.

When to use it

Use this skill when you need to polish academic manuscripts or sections for clarity and adherence to specific journal styles.

When not to use it

This skill may not be suitable for non-academic writing or for documents that do not require adherence to Nature's style guidelines.

What you can build with it

Polishing a Research Manuscript

Use this skill to refine your research manuscript section by section, ensuring clarity and adherence to Nature's style.

Fixing LaTeX Layout Issues

Invoke the skill to address common LaTeX formatting problems before submitting your manuscript for review.

Translating and Polishing a Chinese Draft

Utilize this skill to translate and enhance a Chinese academic draft into high-quality English suitable for publication.

How to install Nature-Style Academic Polishing

View source

1. Install with the skills CLI

npx skills add yuan1z0825/nature-skills/nature-polishing --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by yuan1z0825

Nature-Style Academic Polishing — Router

This skill is split into two layers:

  • A static layer under static/ that holds versioned, reusable content fragments (core principles, paper-type playbooks, per-section guidance, language-specific rules, per-journal style).
  • A dynamic layer (this file plus manifest.yaml) that detects the request's axes and loads only the fragments needed for the current job.

Do not try to apply the polishing logic from memory or from this router. Always load fragments from disk as described below.

Routing protocol

Follow these five steps every time the skill is invoked.

1. Load the manifest and the core layer

Read manifest.yaml. It declares the axes (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, failure-mode diagnosis, ethics, and output format that apply to every polish 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:

  • paper_type — research / methods / hypothesis / algorithmic / review. Default: research.
  • section — abstract / intro / results / discussion / conclusion / title / methods. May be multiple. Ask the user if it is ambiguous and matters for the polish.
  • language — en or zh-to-en. Detect from the draft itself.
  • journal — nature / nat-comms / generic. Default: generic. If the user names a Nature subjournal, treat it as nature.

State the detected axis values in one short line to the user before proceeding, so they can correct you cheaply.

3. Load the matching fragments

For each axis value, Read the file mapped in the manifest. Skip the section axis only if the user has supplied free-floating prose with no section context.

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

4. Polish using the loaded material

Apply the loaded fragments in this priority order, matching the paper type -> section job -> paragraph logic -> claim/evidence/boundary -> sentence polish rule from core/failure-modes.md:

  1. Paper-type playbook (architecture, writing order).
  2. Section-specific job and failure modes.
  3. Journal-specific framing and constraints.
  4. Language-specific sentence and paragraph rules (apply last).
  5. Core stance and ethics throughout.

If a paragraph's structural problem cannot be fixed without inventing content, flag it instead of papering over it.

5. Reach for references only when needed

The files under references/ are deep references, not defaults. Open them on demand per the references.on_demand table in the manifest, for example when the user explicitly asks for phrasebank-style alternatives or a stricter style audit.

When the job is a whole manuscript rather than a passage, or the text has already been through more than one round of editing, also load ../nature-shared/core/consistency-sweep.md. Polishing passage by passage cannot see accumulated drift: one experimental factor under several names, the same quantity in two units, a metric at two precisions, or a superlative the paper's own table contradicts. Sweep for those before working on sentences, and repeat the sweep until a pass finds nothing new.

Layout/typesetting (排版) requests are different. If the user asks to fix placement rather than wording — loose/sparse pages, stranded headings, figures that don't fill the page or split across pages, "Float too large", multi-panel arrangement, sparse Supplementary Information — skip the prose axes (paper_type, section, language, journal) and load references/latex-layout.md directly. That file is self-contained: it carries the diagnosis workflow (render → contact-sheet → read the log), the float-glue and [H]/\clearpage/placeins patterns, and the "regenerate wide figures taller at the source" rule. Always compile and visually inspect rendered pages before and after — never judge layout from the .tex alone.

Why this split

  • The static layer is versioned and reviewable. Adding a new journal style or paper type is one new file plus one manifest line.
  • The dynamic layer keeps each invocation cheap: only the fragments relevant to this draft enter context, instead of the full 1000-line monolith.
  • The router itself is short on purpose. Update fragments, not this file, when adding scope.

Frequently asked questions about Nature-Style Academic Polishing

Similar skills