scientific-manuscript-writing
Scientific manuscript writing: IMRAD, citation styles (APA/AMA/Vancouver/IEEE), figures/tables, reporting guidelines (CONSORT/STROBE/PRISMA/ARRIVE), writing principles (clarity/conciseness/accuracy), venue-specific style. For LaTeX see companion assets.
Install / Use
npx skills add jaechang-hits/SciAgent-Skills --skill scientific-manuscript-writingInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Content & MediaSupported Platforms
Tags
Our assessment of scientific-manuscript-writing
scientific-manuscript-writing scores 87/100 on our quality scale, 638th of 1,181 Content & Media skills we index.
Its SKILL.md is 19 KB long, well organised into 17 sections with 1 code example: a thorough specification that gives an agent plenty to work with.
It has 367 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated 37 days ago, so scientific-manuscript-writing is actively maintained.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-10-05. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
scientific-manuscript-writing compared with similar skills
All 4 of these similar skills score higher than scientific-manuscript-writing; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| scientific-manuscript-writing (this skill)by jaechang-hits | 87 | 367 | 37d ago | SKILL.md |
| siyuanby siyuan-note | 100 | 46.6k | today | MCP Server |
| algorithmic-artby anthropics | 100 | 177.9k | 12d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 12d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 130.2k | 13d ago | SKILL.md |
Frequently asked questions
- How do I install scientific-manuscript-writing?
- Run
npx skills add jaechang-hits/SciAgent-Skills --skill scientific-manuscript-writing. The install tabs above show the steps for each supported agent. - Which AI agents does scientific-manuscript-writing work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is scientific-manuscript-writing safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is scientific-manuscript-writing still maintained?
- The repository was last updated 37 days ago, so scientific-manuscript-writing is actively maintained.
Skill content
View source on GitHubname: "scientific-manuscript-writing" description: "Scientific manuscript writing: IMRAD, citation styles (APA/AMA/Vancouver/IEEE), figures/tables, reporting guidelines (CONSORT/STROBE/PRISMA/ARRIVE), writing principles (clarity/conciseness/accuracy), venue-specific style. For LaTeX see companion assets." license: "CC-BY-4.0"
Scientific Manuscript Writing
Overview
Scientific manuscript writing is the discipline of communicating research findings with precision, clarity, and reproducibility. This knowhow covers the complete lifecycle of manuscript preparation: from planning and structuring a paper using IMRAD format, through applying correct citation styles and designing effective figures, to ensuring compliance with study-specific reporting guidelines. It applies across biomedical, social science, engineering, and computational fields.
This entry consolidates writing principles, manuscript structure, citation systems, figure/table design, and reporting standards into a unified reference for producing publication-ready scientific documents.
Key Concepts
Writing Principles: Clarity, Conciseness, Accuracy
The three pillars of scientific writing govern all manuscript text:
- Clarity: Use precise, unambiguous language. Define technical terms at first use. Maintain logical flow within and between paragraphs. Use active voice when it improves understanding; passive voice is acceptable in Methods when the action matters more than the actor.
- Conciseness: Express ideas in the fewest words necessary. Eliminate redundant phrases ("due to the fact that" becomes "because"; "in order to" becomes "to"). Favor shorter sentences (15-20 words average). Use strong verbs instead of noun-verb combinations ("analyze" not "perform an analysis").
- Accuracy: Report exact values with appropriate precision matched to measurement capability. Use consistent terminology throughout. Distinguish observations from interpretations. Verify that numbers in text match tables and figures.
Additional principles include objectivity (present results without bias, acknowledge conflicting evidence), consistency (same term for same concept, uniform notation), and logical organization (clear "red thread" connecting sections). See references/writing_principles_style.md for detailed guidance with examples.
IMRAD Structure
IMRAD (Introduction, Methods, Results, And Discussion) is the standard organizational structure for original research articles, adopted across most scientific disciplines since the 1970s. It mirrors the scientific method:
| Section | Question Answered | Primary Tense | Typical Length | |---------|-------------------|---------------|----------------| | Title | What is this about? | N/A | 10-15 words | | Abstract | Complete summary | Mixed | 100-250 words | | Introduction | Why did you study this? | Present/past | 4-5 paragraphs | | Methods | How did you do it? | Past | 2-4 pages | | Results | What did you find? | Past | 2-4 pages | | Discussion | What does it mean? | Past/present | 3-5 pages | | Conclusion | Take-home message | Present | 1-2 paragraphs |
The Introduction follows a funnel structure: broad context, narrowing literature review, gap identification, and study objectives. Methods must provide sufficient detail for replication. Results present findings objectively without interpretation. Discussion interprets findings, compares with prior work, acknowledges limitations, and proposes future directions.
Venue variations: Nature/Science use modified IMRAD with methods in supplement. ML conferences (NeurIPS/ICML) use Introduction-Method-Experiments-Conclusion with numbered contributions and ablation studies. See references/manuscript_structure.md for section-by-section guidance.
Citation Systems
Five major citation styles serve different disciplines:
| Style | Format | Primary Disciplines | |-------|--------|---------------------| | AMA | Superscript numbers | Medicine, health sciences | | Vancouver | Numbers in brackets [1] | Biomedical sciences | | APA | Author-date (Smith, 2023) | Psychology, social sciences | | Chicago | Notes-bibliography or author-date | Humanities, some sciences | | IEEE | Numbers in brackets [1] | Engineering, computer science |
Best practices across all styles: Cite primary sources when possible. Include recent literature (within 5-10 years for active fields, 2-3 years for ML). Balance citation distribution across Introduction and Discussion. Verify all citations against original sources. Keep self-citations below 20%. Always check the target journal's author guidelines for the required style.
See references/citation_guide.md for complete format specifications, journal-specific requirements, and DOI formatting rules.
Figure and Table Design Principles
Figures and tables are the backbone of a scientific paper; many readers examine them before reading the text.
Decision rule: Can the information be conveyed in 1-2 sentences? If yes, use text only. If no and precise values are needed, use a table. If no and patterns/trends matter most, use a figure.
Core design principles:
- Self-explanatory: Each display item must stand alone with a complete caption defining all abbreviations, units, sample sizes, and statistical annotations
- No redundancy: Text highlights key findings from displays; it does not repeat all data
- Consistency: Uniform formatting, color schemes, and terminology across all display items
- Optimal quantity: Approximately one display item per 1,000 words of manuscript
- Accessibility: Color-blind safe palettes (blue-orange, viridis); designs that work in grayscale
Error bar rule: Always state which measure is shown (SD for data spread, SEM for measurement precision, 95% CI for significance assessment). 95% CI is generally preferred because non-overlapping CIs indicate significant differences.
See references/figures_tables_guide.md for figure type selection, table formatting, statistical presentation, and journal-specific requirements.
Decision Framework
What type of scientific document are you writing?
|
+-- Original research article
| |
| +-- Clinical trial --> IMRAD + CONSORT reporting guideline
| +-- Observational study --> IMRAD + STROBE reporting guideline
| +-- Animal study --> IMRAD + ARRIVE reporting guideline
| +-- Diagnostic accuracy --> IMRAD + STARD reporting guideline
| +-- Prediction model --> IMRAD + TRIPOD reporting guideline
| +-- ML/CS research --> Intro-Method-Experiments-Conclusion
|
+-- Review / synthesis
| +-- Systematic review --> PRISMA reporting guideline
| +-- Narrative review --> Thematic structure
| +-- Meta-analysis --> PRISMA + forest plots
|
+-- Case report --> CARE guideline
|
+-- Study protocol --> SPIRIT guideline
|
+-- Quality improvement --> SQUIRE guideline
|
+-- Economic evaluation --> CHEERS guideline
|
+-- Professional report / white paper --> scientific_report.sty (see assets/)
| Venue Type | Structure | Citation Style | Key Adaptation | |-----------|-----------|---------------|----------------| | Nature/Science | Modified IMRAD, methods in supplement | Numbered superscript | Accessible language, broad significance, story-driven | | Medical journals (NEJM, JAMA) | Strict IMRAD | Vancouver/AMA | Structured abstracts, clinical focus, CONSORT/STROBE | | Field-specific journals | Standard IMRAD | Varies by field | Full technical detail, field terminology | | ML conferences (NeurIPS, ICML) | Intro-Method-Experiments-Conclusion | Numbered or author-year | Numbered contributions, ablations, pseudocode | | Professional reports | Chapter-based | N/A | Use scientific_report.sty for formatting |
Best Practices
- Write the abstract last: After completing all sections, synthesize the key message into 100-250 words. Include quantitative results with statistical measures.
- Plan figures before writing: Design figures and tables as the data story backbone. Write Methods first, then Results describing the displays, then Discussion interpreting them, then Introduction framing the question.
- One idea per paragraph: Start with a topic sentence, develop with supporting evidence, end with a transition to the next idea. Target 3-7 sentences per paragraph.
- Define abbreviations strategically: Define at first use in both abstract and main text. Only abbreviate terms used 3+ times. Limit to 3-4 new abbreviations per paper. Standard abbreviations (DNA, RNA, PCR) need no definition.
- Use verb tense correctly: Past tense for completed actions (Methods, Results, prior studies). Present tense for established facts and your interpretations. Present perfect for recent developments with current relevance ("Recent studies have demonstrated...").
- Report statistics completely: For each comparison, include point estimate, variability measure (SD/SEM/CI), sample size, test statistic, exact p-value (not just "p < 0.05"), and effect size with confidence interval.
- Follow reporting guidelines from the start: Identify the appropriate guideline during study design, not after manuscript completion. Use the checklist during drafting to ensure all required elements are captured.
- Match writing style to venue: Review 3-5 recent papers from your target journal. Adapt sentence length, vocabulary level, hedging style, and section proportions to match venue expectations.
- Verify citation-reference correspondence: Every in-text citation must have a reference list entry and vice versa. Check author names, years, titles, and DOIs before submission.
- Design for accessibility: Use color-blind safe palettes. Ensure figures work in grayscale. Maintain minimum 8-10 pt font at final print size. Use vector formats (PDF, EPS) for graphs.
Common Pitfalls
-
Overstating conclusions beyond the evidence: Claiming causation from observational data or generalizing beyond the study population.
- How to avoid: Use appropriate hedging language ("suggests," "is associated with"). Match claim strength to study design.
-
Inconsistent terminology: Using different words for the same concept (switching between "medication," "drug," and "pharmaceutical").
- How to avoid: Choose one term per concept and use it throughout. Create a terminology list before drafting.
-
Mixing verb tenses inappropriately: Using present tense for your specific results or past tense for established facts.
- How to avoid: Follow the section-specific tense rules. Review each section for tense consistency during revision.
-
Insufficient methods detail for reproducibility: Omitting sample sizes, software versions, statistical test justifications, or ethical approval.
- How to avoid: Use the relevant reporting guideline checklist. Have a colleague assess whether they could replicate the study from your Methods section alone.
-
Redundant data presentation: Repeating all table values in the text, or duplicating information between figures and tables.
- How to avoid: Text should highlight and interpret key findings from displays, not restate all numbers. Each data point appears in only one format.
-
Missing or poorly designed error bars: Omitting error bars entirely, or not specifying whether they represent SD, SEM, or CI.
- How to avoid: Include error bars on all quantitative figures. Define the measure in every caption ("Error bars represent 95% CI").
-
Abbreviation overload: Defining too many abbreviations, or abbreviating terms used only once or twice.
- How to avoid: Only abbreviate terms used 3+ times. Limit new abbreviations to 3-4 per paper. Never abbreviate in the title.
-
Ignoring journal-specific requirements: Submitting with wrong citation style, exceeding word limits, or using incorrect figure formats.
- How to avoid: Read author guidelines befor
Truncated for display — read the full file on GitHub.
Related Skills
siyuan
46.6kAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
130.2kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
