scientific-writing

Name: scientific-writing
Author: Boom5426

63installs28forks

How to install scientific-writing?

boom5426/nature-paper-skills/scientific-writing

$npx -y skills add Boom5426/Nature-Paper-Skills --skill scientific-writing

Installs into the current project.

Summary

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.

Files · 1

View on GitHub

SKILL.md

1	# Scientific Writing
2
3	## Overview
4
5	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.
6
7	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.
8
9	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.
10
11	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.
12
13	## When to Use This Skill
14
15	This skill should be used when:
16	- Writing or revising any section of a scientific manuscript (abstract, introduction, methods, results, discussion)
17	- Structuring a research paper using IMRAD or other standard formats
18	- Formatting citations and references in specific styles (APA, AMA, Vancouver, Chicago, IEEE)
19	- Creating, formatting, or improving figures, tables, and data visualizations
20	- Applying study-specific reporting guidelines (CONSORT for trials, STROBE for observational studies, PRISMA for reviews)
21	- Drafting abstracts that meet journal requirements (structured or unstructured)
22	- Preparing manuscripts for submission to specific journals
23	- Improving writing clarity, conciseness, and precision
24	- Ensuring proper use of field-specific terminology and nomenclature
25	- Addressing reviewer comments and revising manuscripts
26
27	For title, abstract, cover-letter, or top-level logic decisions, read `references/editor-first-impression.md`.
28
29	## Visual Enhancement with Scientific Figures
30
31	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).
32
33	Before finalizing any document:
34	1. Add at least one figure when it materially improves comprehension.
35	2. Prefer 2-3 figures for longer papers (methods flowchart, results visualization, conceptual diagram).
36
37	How to generate figures:
38	- Use the `nature-figure` skill's OpenRouter route to generate publication-style schematics.
39	- Write prompts that specify academic style, white background, clean labels, colorblind-friendly colors, and high contrast.
40	- Save outputs under a local `figures/` directory in the current project.
41
42	Example command (via the `nature-figure` skill, once installed):
43	```bash
44	export OPENROUTER_API_KEY="sk-or-..."
45	python ~/.codex/skills/nature-figure/scripts/generate_openrouter_schematic.py \
46	--title "Your method" \
47	--panel-map "left: problem; center: proposed mechanism; right: validated outcome" \
48	--outdir figures --basename schematic --resolution 2K
49	# Claude Code (global install): replace ~/.codex/skills with ~/.claude/skills
50	# Claude Code (project-local install): replace ~/.codex/skills with .claude/skills
51	```
52
53	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.
54
55	When to add figures:
56	- Study design and methodology flowcharts (CONSORT, PRISMA, STROBE)
57	- Conceptual framework diagrams
58	- Experimental workflow illustrations
59	- Data analysis pipeline diagrams
60	- Biological pathway or mechanism diagrams
61	- System architecture visualizations
62	- Any complex concept that benefits from visualization
63
64	For detailed guidance on creating figures, refer to the `nature-figure` skill.
65
66	---
67
68	## Core Capabilities
69
70	### 1. Manuscript Structure and Organization
71
72	IMRAD Format: Guide papers through the standard Introduction, Methods, Results, And Discussion structure used across most scientific disciplines. This includes:
73	- Introduction: Establish research context, identify gaps, state objectives
74	- Methods: Detail study design, populations, procedures, and analysis approaches
75	- Results: Present findings objectively without interpretation
76	- Discussion: Interpret results, acknowledge limitations, propose future directions
77
78	For detailed guidance on IMRAD structure, refer to `references/imrad_structure.md`.
79
80	**Alternative Structu

People who liked this also viewed

6 picks

Type

scientific-writing

63installs28forks

View on GitHub

How to install scientific-writing?

boom5426/nature-paper-skills/scientific-writing

$npx -y skills add Boom5426/Nature-Paper-Skills --skill scientific-writing

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Scientific Writing
2
3	## Overview
4
5	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.
6
7	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.
8
9	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.
10
11	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.
12
13	## When to Use This Skill
14
15	This skill should be used when:
16	- Writing or revising any section of a scientific manuscript (abstract, introduction, methods, results, discussion)
17	- Structuring a research paper using IMRAD or other standard formats
18	- Formatting citations and references in specific styles (APA, AMA, Vancouver, Chicago, IEEE)
19	- Creating, formatting, or improving figures, tables, and data visualizations
20	- Applying study-specific reporting guidelines (CONSORT for trials, STROBE for observational studies, PRISMA for reviews)
21	- Drafting abstracts that meet journal requirements (structured or unstructured)
22	- Preparing manuscripts for submission to specific journals
23	- Improving writing clarity, conciseness, and precision
24	- Ensuring proper use of field-specific terminology and nomenclature
25	- Addressing reviewer comments and revising manuscripts
26
27	For title, abstract, cover-letter, or top-level logic decisions, read `references/editor-first-impression.md`.
28
29	## Visual Enhancement with Scientific Figures
30
31	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).
32
33	Before finalizing any document:
34	1. Add at least one figure when it materially improves comprehension.
35	2. Prefer 2-3 figures for longer papers (methods flowchart, results visualization, conceptual diagram).
36
37	How to generate figures:
38	- Use the `nature-figure` skill's OpenRouter route to generate publication-style schematics.
39	- Write prompts that specify academic style, white background, clean labels, colorblind-friendly colors, and high contrast.
40	- Save outputs under a local `figures/` directory in the current project.
41
42	Example command (via the `nature-figure` skill, once installed):
43	```bash
44	export OPENROUTER_API_KEY="sk-or-..."
45	python ~/.codex/skills/nature-figure/scripts/generate_openrouter_schematic.py \
46	--title "Your method" \
47	--panel-map "left: problem; center: proposed mechanism; right: validated outcome" \
48	--outdir figures --basename schematic --resolution 2K
49	# Claude Code (global install): replace ~/.codex/skills with ~/.claude/skills
50	# Claude Code (project-local install): replace ~/.codex/skills with .claude/skills
51	```
52
53	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.
54
55	When to add figures:
56	- Study design and methodology flowcharts (CONSORT, PRISMA, STROBE)
57	- Conceptual framework diagrams
58	- Experimental workflow illustrations
59	- Data analysis pipeline diagrams
60	- Biological pathway or mechanism diagrams
61	- System architecture visualizations
62	- Any complex concept that benefits from visualization
63
64	For detailed guidance on creating figures, refer to the `nature-figure` skill.
65
66	---
67
68	## Core Capabilities
69
70	### 1. Manuscript Structure and Organization
71
72	IMRAD Format: Guide papers through the standard Introduction, Methods, Results, And Discussion structure used across most scientific disciplines. This includes:
73	- Introduction: Establish research context, identify gaps, state objectives
74	- Methods: Detail study design, populations, procedures, and analysis approaches
75	- Results: Present findings objectively without interpretation
76	- Discussion: Interpret results, acknowledge limitations, propose future directions
77
78	For detailed guidance on IMRAD structure, refer to `references/imrad_structure.md`.
79
80	**Alternative Structu

People who liked this also viewed

6 picks

Type