scientific-writing
Use when writing or revising scientific manuscripts, abstracts, figures, or references for journal submission and you need full-paragraph prose, scientific structure, citation-style guidance, or reporting-guideline support.
Boom5426 · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add Boom5426/Nature-Paper-Skills --skill scientific-writing技能说明
name: scientific-writing description: Use when writing or revising scientific manuscripts, abstracts, figures, or references for journal submission and you need full-paragraph prose, scientific structure, citation-style guidance, or reporting-guideline support.
Scientific Writing
Overview
This is the core journal-writing skill in this repository. Use it to turn a stable scientific story into clear, well-structured manuscript prose while keeping citations, figures, and reporting standards aligned.
Scientific writing is a process for communicating research with precision and clarity. Write manuscripts using IMRAD structure, citations (APA/AMA/Vancouver), figures/tables, and reporting guidelines (CONSORT/STROBE/PRISMA). Apply this skill for research papers and journal submissions.
Critical Principle: Always write in full paragraphs with flowing prose. Never submit bullet points in the final manuscript. Use a two-stage process: first create section outlines with key points from verified notes, literature, and results, then convert those outlines into complete paragraphs.
For revision-heavy journal manuscripts, do not jump from stale prose directly to polishing. First stabilize the section with a reverse outline and a claim-evidence map, then rewrite the paragraphs.
When to Use This Skill
This skill should be used when:
- Writing or revising any section of a scientific manuscript (abstract, introduction, methods, results, discussion)
- Structuring a research paper using IMRAD or other standard formats
- Formatting citations and references in specific styles (APA, AMA, Vancouver, Chicago, IEEE)
- Creating, formatting, or improving figures, tables, and data visualizations
- Applying study-specific reporting guidelines (CONSORT for trials, STROBE for observational studies, PRISMA for reviews)
- Drafting abstracts that meet journal requirements (structured or unstructured)
- Preparing manuscripts for submission to specific journals
- Improving writing clarity, conciseness, and precision
- Ensuring proper use of field-specific terminology and nomenclature
- Addressing reviewer comments and revising manuscripts
For title, abstract, cover-letter, or top-level logic decisions, read references/editor-first-impression.md.
Visual Enhancement with Scientific Figures
When a manuscript would benefit from a schematic, workflow diagram, or conceptual figure, use this repository's nature-figure skill, which ships an OpenRouter AI-schematic route. It is not in the default recommended set because it needs a plotting backend or an OPENROUTER_API_KEY; install it from the Figure Stack (see the installation docs).
Before finalizing any document:
- Add at least one figure when it materially improves comprehension.
- Prefer 2-3 figures for longer papers (methods flowchart, results visualization, conceptual diagram).
How to generate figures:
- Use the
nature-figureskill's OpenRouter route to generate publication-style schematics. - Write prompts that specify academic style, white background, clean labels, colorblind-friendly colors, and high contrast.
- Save outputs under a local
figures/directory in the current project.
Example command (via the nature-figure skill, once installed):
export OPENROUTER_API_KEY="sk-or-..."
python ~/.codex/skills/nature-figure/scripts/generate_openrouter_schematic.py \
--title "Your method" \
--panel-map "left: problem; center: proposed mechanism; right: validated outcome" \
--outdir figures --basename schematic --resolution 2K
# Claude Code (global install): replace ~/.codex/skills with ~/.claude/skills
# Claude Code (project-local install): replace ~/.codex/skills with .claude/skills
Requires OPENROUTER_API_KEY. Iterate on the panel map and title until the figure is publication-ready. See nature-figure's references/openrouter-image-generation.md for full options.
When to add figures:
- Study design and methodology flowcharts (CONSORT, PRISMA, STROBE)
- Conceptual framework diagrams
- Experimental workflow illustrations
- Data analysis pipeline diagrams
- Biological pathway or mechanism diagrams
- System architecture visualizations
- Any complex concept that benefits from visualization
For detailed guidance on creating figures, refer to the nature-figure skill.
Core Capabilities
1. Manuscript Structure and Organization
IMRAD Format: Guide papers through the standard Introduction, Methods, Results, And Discussion structure used across most scientific disciplines. This includes:
- Introduction: Establish research context, identify gaps, state objectives
- Methods: Detail study design, populations, procedures, and analysis approaches
- Results: Present findings objectively without interpretation
- Discussion: Interpret results, acknowledge limitations, propose future directions
For detailed guidance on IMRAD structure, refer to references/imrad_structure.md.
Alternative Structures: Support discipline-specific formats including:
- Review articles (narrative, systematic, scoping)
- Case reports and case series
- Meta-analyses and pooled analyses
- Theoretical/modeling papers
- Methods papers and protocols
2. Section-Specific Writing Guidance
Editor-First Front Door: Make the title, abstract, introduction, Results, discussion, and cover letter answer the same four questions in the same order:
- why did the study need to be done
- what did you do
- what did you find
- how does the study advance the field
If these sections answer different versions of the story, the manuscript will feel fragmented even when the prose is locally strong.
Abstract Composition: Craft concise, standalone summaries (100-250 words) that capture the paper's purpose, methods, results, and conclusions. Support both structured abstracts (with labeled sections) and unstructured single-paragraph formats. Make the abstract state the problem, the aim/method, the key result, an
阅读完整来源 ↗