Scientific Writing
Overview
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 using research-lookup, then convert those outlines into complete 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
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
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.
Introduction Development: Build compelling introductions that:
- Establish the research problem's importance
- Review relevant literature systematically
- Identify knowledge gaps or controversies
- State clear research questions or hypotheses
- Explain the study's novelty and significance
Methods Documentation: Ensure reproducibility through:
- Detailed participant/sample descriptions
- Clear procedural documentation
- Statistical methods with justification
- Equipment and materials specifications
- Ethical approval and consent statements
Results Presentation: Present findings with:
- Logical flow from primary to secondary outcomes
- Integration with figures and tables
- Statistical significance with effect sizes
- Objective reporting without interpretation
Discussion Construction: Synthesize findings by:
- Relating results to research questions
- Comparing with existing literature
- Acknowledging limitations honestly
- Proposing mechanistic explanations
- Suggesting practical implications and future research
3. Citation and Reference Management
Apply citation styles correctly across disciplines. For comprehensive style guides, refer to references/citation_styles.md.
Major Citation Styles:
- AMA (American Medical Association): Numbered superscript citations, common in medicine
- Vancouver: Numbered citations in square brackets, biomedical standard
- APA (American Psychological Association): Author-date in-text citations, common in social sciences
- Chicago: Notes-bibliography or author-date, humanities and sciences
- IEEE: Numbered square brackets, engineering and computer science
Best Practices:
- Cite primary sources when possible
- Include recent literature (last 5-10 years for active fields)
- Balance citation distribution across introduction and discussion
- Verify all citations against original sources
- Use reference management software (Zotero, Mendeley, EndNote)
4. Figures and Tables
Create effective data visualizations that enhance comprehension. For detailed best practices, refer to references/figures_tables.md.
When to Use Tables vs. Figures:
- Tables: Precise numerical data, complex datasets, multiple variables requiring exact values
- Figures: Trends, patterns, relationships, comparisons best understood visually
Design Principles:
- Make each table/figure self-explanatory with complete captions
- Use consistent formatting and terminology across all display items
- Label all axes, columns, and rows with units
- Include sample sizes (n) and statistical annotations
- Follow the "one table/figure per 1000 words" guideline
- Avoid duplicating information between text, tables, and figures
Common Figure Types:
- Bar graphs: Comparing discrete categories
- Line graphs: Showing trends over time
- Scatterplots: Displaying correlations
- Box plots: Showing distributions and outliers
- Heatmaps: Visualizing matrices and patterns
5. Reporting Guidelines by Study Type
Ensure completeness and transparency by following established reporting standards. For comprehensive guideline details, refer to references/reporting_guidelines.md.
Key Guidelines:
- CONSORT: Randomized controlled trials
- STROBE: Observational studies (cohort, case-control, cross-sectional)
- PRISMA: Systematic reviews and meta-analyses
- STARD: Diagnostic accuracy studies
- TRIPOD: Prediction model studies
- ARRIVE: Animal research
- CARE: Case reports
- SQUIRE: Quality improvement studies
- SPIRIT: Study protocols for clinical trials
- CHEERS: Economic evaluations
Each guideline provides checklists ensuring all critical methodological elements are reported.
6. Writing Principles and Style
Apply fundamental scientific writing principles. For detailed guidance, refer to references/writing_principles.md.
Clarity:
- Use precise, unambiguous language
- Define technical terms and abbreviations at first use
- Maintain logical flow within and between paragraphs
- Use active voice when appropriate for clarity
Conciseness:
- Eliminate redundant words and phrases
- Favor shorter sentences (15-20 words average)
- Remove unnecessary qualifiers
- Respect word limits strictly
Accuracy:
- Report exact values with appropriate precision
- Use consistent terminology throughout
- Distinguish between observations and interpretations
- Acknowledge uncertainty appropriately
Objectivity:
- Present results without bias
- Avoid overstating findings or implications
- Acknowledge conflicting evidence
- Maintain professional, neutral tone
7. Writing Process: From Outline to Full Paragraphs
CRITICAL: Always write in full paragraphs, never submit bullet points in scientific papers.
Scientific papers must be written in complete, flowing prose. Use this two-stage approach for effective writing:
Stage 1: Create Section Outlines with Key Points
When starting a new section:
- Use the research-lookup skill to gather relevant literature and data
- Create a structured outline with bullet points marking:
- Main arguments or findings to present
- Key studies to cite
- Data points and statistics to include
- Logical flow and organization
- These bullet points serve as scaffolding—they are NOT the final manuscript
Example outline (Introduction section):
- Background: AI in drug discovery gaining traction
* Cite recent reviews (Smith 2023, Jones 2024)
* Traditional methods are slow and expensive
- Gap: Limited application to rare diseases
* Only 2 prior studies (Lee 2022, Chen 2023)
* Small datasets remain a challenge
- Our approach: Transfer learning from common diseases
* Novel architecture combining X and Y
- Study objectives: Validate on 3 rare disease datasets
Stage 2: Convert Key Points to Full Paragraphs
Once the outline is complete, expand each bullet point into proper prose:
- Transform bullet points into complete sentences with subjects, verbs, and objects
- Add transitions between sentences and ideas (however, moreover, in contrast, subsequently)
- Integrate citations naturally within sentences, not as lists
- Expand with context and explanation that bullet points omit
- Ensure logical flow from one sentence to the next within each paragraph
- Vary sentence structure to maintain reader engagement
Example conversion to prose:
Artificial intelligence approaches have gained significant traction in drug discovery
pipelines over the past decade (Smith, 2023; Jones, 2024). While these computational
methods show promise for accelerating the identification of therapeutic candidates,
traditional experimental approaches remain slow and resource-intensive, often requiring
years of laboratory work and substantial financial investment. However, the application
of AI to rare diseases has been limited, with only two prior studies demonstrating
proof-of-concept results (Lee, 2022; Chen, 2023). The primary obstacle has been the
scarcity of training data for conditions affecting small patient populations.
To address this challenge, we developed a transfer learning approach that leverages
knowledge from well-characterized common diseases to predict therapeutic targets for
rare conditions. Our novel neural architecture combines convolutional layers for
molecular feature extraction with attention mechanisms for protein-ligand interaction
modeling. The objective of this study was to validate our approach across three
independent rare disease datasets, assessing both predictive accuracy and biological
interpretability of the results.
Key Differences Between Outlines and Final Text:
| Outline (Planning Stage) |
Final Manuscript |
| Bullet points and fragments |
Complete sentences and paragraphs |
| Telegraphic notes |
Full explanations with context |
| List of citations |
Citations integrated into prose |
| Abbreviated ideas |
Developed arguments with transitions |
| For your eyes only |
For publication and peer review |
Common Mistakes to Avoid:
- ❌ Never leave bullet points in the final manuscript
- ❌ Never submit lists where paragraphs should be
- ❌ Don't use numbered or bulleted lists in Results or Discussion sections (except for specific cases like study hypotheses or inclusion criteria)
- ❌ Don't write sentence fragments or incomplete thoughts
- ✅ Do use occasional lists only in Methods (e.g., inclusion/exclusion criteria, materials lists)
- ✅ Do ensure every section flows as connected prose
- ✅ Do read paragraphs aloud to check for natural flow
When Lists ARE Acceptable (Limited Cases):
Lists may appear in scientific papers only in specific contexts:
- Methods: Inclusion/exclusion criteria, materials and reagents, participant characteristics
- Supplementary Materials: Extended protocols, equipment lists, detailed parameters
- Never in: Abstract, Introduction, Results, Discussion, Conclusions
Integration with Research Lookup:
The research-lookup skill is essential for Stage 1 (creating outlines):
- Search for relevant papers using research-lookup
- Extract key findings, methods, and data
- Organize findings as bullet points in your outline
- Then convert the outline to full paragraphs in Stage 2
This two-stage process ensures you:
- Gather and organize information systematically
- Create logical structure before writing
- Produce polished, publication-ready prose
- Maintain focus on the narrative flow
8. Journal-Specific Formatting
Adapt manuscripts to journal requirements:
- Follow author guidelines for structure, length, and format
- Apply journal-specific citation styles
- Meet figure/table specifications (resolution, file formats, dimensions)
- Include required statements (funding, conflicts of interest, data availability, ethical approval)
- Adhere to word limits for each section
- Format according to template requirements when provided
9. Field-Specific Language and Terminology
Adapt language, terminology, and conventions to match the specific scientific discipline. Each field has established vocabulary, preferred phrasings, and domain-specific conventions that signal expertise and ensure clarity for the target audience.
Identify Field-Specific Linguistic Conventions:
- Review terminology used in recent high-impact papers in the target journal
- Note field-specific abbreviations, units, and notation systems
- Identify preferred terms (e.g., "participants" vs. "subjects," "compound" vs. "drug," "specimens" vs. "samples")
- Observe how methods, organisms, or techniques are typically described
Biomedical and Clinical Sciences:
- Use precise anatomical and clinical terminology (e.g., "myocardial infarction" not "heart attack" in formal writing)
- Follow standardized disease nomenclature (ICD, DSM, SNOMED-CT)
- Specify drug names using generic names first, brand names in parentheses if needed
- Use "patients" for clinical studies, "participants" for community-based research
- Follow Human Genome Variation Society (HGVS) nomenclature for genetic variants
- Report lab values with standard units (SI units in most international journals)
Molecular Biology and Genetics:
- Use italics for gene symbols (e.g., TP53), regular font for proteins (e.g., p53)
- Follow species-specific gene nomenclature (uppercase for human: BRCA1; sentence case for mouse: Brca1)
- Specify organism names in full at first mention, then use accepted abbreviations (e.g., Escherichia coli, then E. coli)
- Use standard genetic notation (e.g., +/+, +/-, -/- for genotypes)
- Employ established terminology for molecular techniques (e.g., "quantitative PCR" or "qPCR," not "real-time PCR")
Chemistry and Pharmaceutical Sciences:
- Follow IUPAC nomenclature for chemical compounds
- Use systematic names for novel compounds, common names for well-known substances
- Specify chemical structures using standard notation (e.g., SMILES, InChI for databases)
- Report concentrations with appropriate units (mM, μM, nM, or % w/v, v/v)
- Describe synthesis routes using accepted reaction nomenclature
- Use terms like "bioavailability," "pharmacokinetics," "IC50" consistently with field definitions
Ecology and Environmental Sciences:
- Use binomial nomenclature for species (italicized: Homo sapiens)
- Specify taxonomic authorities at first species mention when relevant
- Employ standardized habitat and ecosystem classifications
- Use consistent terminology for ecological metrics (e.g., "species richness," "Shannon diversity index")
- Describe sampling methods with field-standard terms (e.g., "transect," "quadrat," "mark-recapture")
Physics and Engineering:
- Follow SI units consistently unless field conventions dictate otherwise
- Use standard notation for physical quantities (scalars vs. vectors, tensors)
- Employ established terminology for phenomena (e.g., "quantum entanglement," "laminar flow")
- Specify equipment with model numbers and manufacturers when relevant
- Use mathematical notation consistent with field standards (e.g., ℏ for reduced Planck constant)
Neuroscience:
- Use standardized brain region nomenclature (e.g., refer to atlases like Allen Brain Atlas)
- Specify coordinates for brain regions using established stereotaxic systems
- Follow conventions for neural terminology (e.g., "action potential" not "spike" in formal writing)
- Use "neural activity," "neuronal firing," "brain activation" appropriately based on measurement method
- Describe recording techniques with proper specificity (e.g., "whole-cell patch clamp," "extracellular recording")
Social and Behavioral Sciences:
- Use person-first language when appropriate (e.g., "people with schizophrenia" not "schizophrenics")
- Employ standardized psychological constructs and validated assessment names
- Follow APA guidelines for reducing bias in language
- Specify theoretical frameworks using established terminology
- Use "participants" rather than "subjects" for human research
General Principles:
Match Audience Expertise:
- For specialized journals: Use field-specific terminology freely, define only highly specialized or novel terms
- For broad-impact journals (e.g., Nature, Science): Define more technical terms, provide context for specialized concepts
- For interdisciplinary audiences: Balance precision with accessibility, define terms at first use
Define Technical Terms Strategically:
- Define abbreviations at first use: "messenger RNA (mRNA)"
- Provide brief explanations for specialized techniques when writing for broader audiences
- Avoid over-defining terms well-known to the target audience (signals unfamiliarity with field)
- Create a glossary if numerous specialized terms are unavoidable
Maintain Consistency:
- Use the same term for the same concept throughout (don't alternate between "medication," "drug," and "pharmaceutical")
- Follow a consistent system for abbreviations (decide on "PCR" or "polymerase chain reaction" after first definition)
- Apply the same nomenclature system throughout (especially for genes, species, chemicals)
Avoid Field Mixing Errors:
- Don't use clinical terminology for basic science (e.g., don't call mice "patients")
- Avoid colloquialisms or overly general terms in place of precise field terminology
- Don't import terminology from adjacent fields without ensuring proper usage
Verify Terminology Usage:
- Consult field-specific style guides and nomenclature resources
- Check how terms are used in recent papers from the target journal
- Use domain-specific databases and ontologies (e.g., Gene Ontology, MeSH terms)
- When uncertain, cite a key reference that establishes terminology
10. Common Pitfalls to Avoid
Top Rejection Reasons:
- Inappropriate, incomplete, or insufficiently described statistics
- Over-interpretation of results or unsupported conclusions
- Poorly described methods affecting reproducibility
- Small, biased, or inappropriate samples
- Poor writing quality or difficult-to-follow text
- Inadequate literature review or context
- Figures and tables that are unclear or poorly designed
- Failure to follow reporting guidelines
Writing Quality Issues:
- Mixing tenses inappropriately (use past tense for methods/results, present for established facts)
- Excessive jargon or undefined acronyms
- Paragraph breaks that disrupt logical flow
- Missing transitions between sections
- Inconsistent notation or terminology
Workflow for Manuscript Development
Stage 1: Planning
- Identify target journal and review author guidelines
- Determine applicable reporting guideline (CONSORT, STROBE, etc.)
- Outline manuscript structure (usually IMRAD)
- Plan figures and tables as the backbone of the paper
Stage 2: Drafting (Use two-stage writing process for each section)
- Start with figures and tables (the core data story)
- For each section below, follow the two-stage process:
- First: Create outline with bullet points using research-lookup
- Second: Convert bullet points to full paragraphs with flowing prose
- Write Methods (often easiest to draft first)
- Draft Results (describing figures/tables objectively)
- Compose Discussion (interpreting findings)
- Write Introduction (setting up the research question)
- Craft Abstract (synthesizing the complete story)
- Create Title (concise and descriptive)
Remember: Bullet points are for planning only—the final manuscript must be in complete paragraphs.
Stage 3: Revision
- Check logical flow and "red thread" throughout
- Verify consistency in terminology and notation
- Ensure figures/tables are self-explanatory
- Confirm adherence to reporting guidelines
- Verify all citations are accurate and properly formatted
- Check word counts for each section
- Proofread for grammar, spelling, and clarity
Stage 4: Final Preparation
- Format according to journal requirements
- Prepare supplementary materials
- Write cover letter highlighting significance
- Complete submission checklists
- Gather all required statements and forms
Integration with Other Scientific Skills
This skill works effectively with:
- Data analysis skills: For generating results to report
- Statistical analysis: For determining appropriate statistical presentations
- Literature review skills: For contextualizing research
- Figure creation tools: For developing publication-quality visualizations
References
This skill includes comprehensive reference files covering specific aspects of scientific writing:
references/imrad_structure.md: Detailed guide to IMRAD format and section-specific content
references/citation_styles.md: Complete citation style guides (APA, AMA, Vancouver, Chicago, IEEE)
references/figures_tables.md: Best practices for creating effective data visualizations
references/reporting_guidelines.md: Study-specific reporting standards and checklists
references/writing_principles.md: Core principles of effective scientific communication
Load these references as needed when working on specific aspects of scientific writing.
1---2name: scientific-writing3description: "Write scientific manuscripts in full paragraphs (never bullet points). Use two-stage process: (1) create section outlines with key points using research-lookup, (2) convert to flowing prose. IMRAD structure, citations (APA/AMA/Vancouver), figures/tables, reporting guidelines (CONSORT/STROBE/PRISMA), for research papers and journal submissions."4metadata:5 source: https://skillmd.com/skills/jimmc414/scientific-writing6---78# Scientific Writing910## Overview1112Scientific 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.1314**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 using research-lookup, then convert those outlines into complete paragraphs.1516## When to Use This Skill1718This skill should be used when:19- Writing or revising any section of a scientific manuscript (abstract, introduction, methods, results, discussion)20- Structuring a research paper using IMRAD or other standard formats21- Formatting citations and references in specific styles (APA, AMA, Vancouver, Chicago, IEEE)22- Creating, formatting, or improving figures, tables, and data visualizations23- Applying study-specific reporting guidelines (CONSORT for trials, STROBE for observational studies, PRISMA for reviews)24- Drafting abstracts that meet journal requirements (structured or unstructured)25- Preparing manuscripts for submission to specific journals26- Improving writing clarity, conciseness, and precision27- Ensuring proper use of field-specific terminology and nomenclature28- Addressing reviewer comments and revising manuscripts2930## Core Capabilities3132### 1. Manuscript Structure and Organization3334**IMRAD Format**: Guide papers through the standard Introduction, Methods, Results, And Discussion structure used across most scientific disciplines. This includes:35- **Introduction**: Establish research context, identify gaps, state objectives36- **Methods**: Detail study design, populations, procedures, and analysis approaches37- **Results**: Present findings objectively without interpretation38- **Discussion**: Interpret results, acknowledge limitations, propose future directions3940For detailed guidance on IMRAD structure, refer to `references/imrad_structure.md`.4142**Alternative Structures**: Support discipline-specific formats including:43- Review articles (narrative, systematic, scoping)44- Case reports and case series45- Meta-analyses and pooled analyses46- Theoretical/modeling papers47- Methods papers and protocols4849### 2. Section-Specific Writing Guidance5051**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.5253**Introduction Development**: Build compelling introductions that:54- Establish the research problem's importance55- Review relevant literature systematically56- Identify knowledge gaps or controversies57- State clear research questions or hypotheses58- Explain the study's novelty and significance5960**Methods Documentation**: Ensure reproducibility through:61- Detailed participant/sample descriptions62- Clear procedural documentation63- Statistical methods with justification64- Equipment and materials specifications65- Ethical approval and consent statements6667**Results Presentation**: Present findings with:68- Logical flow from primary to secondary outcomes69- Integration with figures and tables70- Statistical significance with effect sizes71- Objective reporting without interpretation7273**Discussion Construction**: Synthesize findings by:74- Relating results to research questions75- Comparing with existing literature76- Acknowledging limitations honestly77- Proposing mechanistic explanations78- Suggesting practical implications and future research7980### 3. Citation and Reference Management8182Apply citation styles correctly across disciplines. For comprehensive style guides, refer to `references/citation_styles.md`.8384**Major Citation Styles:**85- **AMA (American Medical Association)**: Numbered superscript citations, common in medicine86- **Vancouver**: Numbered citations in square brackets, biomedical standard87- **APA (American Psychological Association)**: Author-date in-text citations, common in social sciences88- **Chicago**: Notes-bibliography or author-date, humanities and sciences89- **IEEE**: Numbered square brackets, engineering and computer science9091**Best Practices:**92- Cite primary sources when possible93- Include recent literature (last 5-10 years for active fields)94- Balance citation distribution across introduction and discussion95- Verify all citations against original sources96- Use reference management software (Zotero, Mendeley, EndNote)9798### 4. Figures and Tables99100Create effective data visualizations that enhance comprehension. For detailed best practices, refer to `references/figures_tables.md`.101102**When to Use Tables vs. Figures:**103- **Tables**: Precise numerical data, complex datasets, multiple variables requiring exact values104- **Figures**: Trends, patterns, relationships, comparisons best understood visually105106**Design Principles:**107- Make each table/figure self-explanatory with complete captions108- Use consistent formatting and terminology across all display items109- Label all axes, columns, and rows with units110- Include sample sizes (n) and statistical annotations111- Follow the "one table/figure per 1000 words" guideline112- Avoid duplicating information between text, tables, and figures113114**Common Figure Types:**115- Bar graphs: Comparing discrete categories116- Line graphs: Showing trends over time117- Scatterplots: Displaying correlations118- Box plots: Showing distributions and outliers119- Heatmaps: Visualizing matrices and patterns120121### 5. Reporting Guidelines by Study Type122123Ensure completeness and transparency by following established reporting standards. For comprehensive guideline details, refer to `references/reporting_guidelines.md`.124125**Key Guidelines:**126- **CONSORT**: Randomized controlled trials127- **STROBE**: Observational studies (cohort, case-control, cross-sectional)128- **PRISMA**: Systematic reviews and meta-analyses129- **STARD**: Diagnostic accuracy studies130- **TRIPOD**: Prediction model studies131- **ARRIVE**: Animal research132- **CARE**: Case reports133- **SQUIRE**: Quality improvement studies134- **SPIRIT**: Study protocols for clinical trials135- **CHEERS**: Economic evaluations136137Each guideline provides checklists ensuring all critical methodological elements are reported.138139### 6. Writing Principles and Style140141Apply fundamental scientific writing principles. For detailed guidance, refer to `references/writing_principles.md`.142143**Clarity**:144- Use precise, unambiguous language145- Define technical terms and abbreviations at first use146- Maintain logical flow within and between paragraphs147- Use active voice when appropriate for clarity148149**Conciseness**:150- Eliminate redundant words and phrases151- Favor shorter sentences (15-20 words average)152- Remove unnecessary qualifiers153- Respect word limits strictly154155**Accuracy**:156- Report exact values with appropriate precision157- Use consistent terminology throughout158- Distinguish between observations and interpretations159- Acknowledge uncertainty appropriately160161**Objectivity**:162- Present results without bias163- Avoid overstating findings or implications164- Acknowledge conflicting evidence165- Maintain professional, neutral tone166167### 7. Writing Process: From Outline to Full Paragraphs168169**CRITICAL: Always write in full paragraphs, never submit bullet points in scientific papers.**170171Scientific papers must be written in complete, flowing prose. Use this two-stage approach for effective writing:172173**Stage 1: Create Section Outlines with Key Points**174175When starting a new section:1761. Use the research-lookup skill to gather relevant literature and data1772. Create a structured outline with bullet points marking:178 - Main arguments or findings to present179 - Key studies to cite180 - Data points and statistics to include181 - Logical flow and organization1823. These bullet points serve as scaffolding—they are NOT the final manuscript183184**Example outline (Introduction section):**185```186- Background: AI in drug discovery gaining traction187 * Cite recent reviews (Smith 2023, Jones 2024)188 * Traditional methods are slow and expensive189- Gap: Limited application to rare diseases190 * Only 2 prior studies (Lee 2022, Chen 2023)191 * Small datasets remain a challenge192- Our approach: Transfer learning from common diseases193 * Novel architecture combining X and Y194- Study objectives: Validate on 3 rare disease datasets195```196197**Stage 2: Convert Key Points to Full Paragraphs**198199Once the outline is complete, expand each bullet point into proper prose:2002011. **Transform bullet points into complete sentences** with subjects, verbs, and objects2022. **Add transitions** between sentences and ideas (however, moreover, in contrast, subsequently)2033. **Integrate citations naturally** within sentences, not as lists2044. **Expand with context and explanation** that bullet points omit2055. **Ensure logical flow** from one sentence to the next within each paragraph2066. **Vary sentence structure** to maintain reader engagement207208**Example conversion to prose:**209210```211Artificial intelligence approaches have gained significant traction in drug discovery 212pipelines over the past decade (Smith, 2023; Jones, 2024). While these computational 213methods show promise for accelerating the identification of therapeutic candidates, 214traditional experimental approaches remain slow and resource-intensive, often requiring 215years of laboratory work and substantial financial investment. However, the application 216of AI to rare diseases has been limited, with only two prior studies demonstrating 217proof-of-concept results (Lee, 2022; Chen, 2023). The primary obstacle has been the 218scarcity of training data for conditions affecting small patient populations. 219220To address this challenge, we developed a transfer learning approach that leverages 221knowledge from well-characterized common diseases to predict therapeutic targets for 222rare conditions. Our novel neural architecture combines convolutional layers for 223molecular feature extraction with attention mechanisms for protein-ligand interaction 224modeling. The objective of this study was to validate our approach across three 225independent rare disease datasets, assessing both predictive accuracy and biological 226interpretability of the results.227```228229**Key Differences Between Outlines and Final Text:**230231| Outline (Planning Stage) | Final Manuscript |232|--------------------------|------------------|233| Bullet points and fragments | Complete sentences and paragraphs |234| Telegraphic notes | Full explanations with context |235| List of citations | Citations integrated into prose |236| Abbreviated ideas | Developed arguments with transitions |237| For your eyes only | For publication and peer review |238239**Common Mistakes to Avoid:**240241- ❌ **Never** leave bullet points in the final manuscript242- ❌ **Never** submit lists where paragraphs should be243- ❌ **Don't** use numbered or bulleted lists in Results or Discussion sections (except for specific cases like study hypotheses or inclusion criteria)244- ❌ **Don't** write sentence fragments or incomplete thoughts245- ✅ **Do** use occasional lists only in Methods (e.g., inclusion/exclusion criteria, materials lists)246- ✅ **Do** ensure every section flows as connected prose247- ✅ **Do** read paragraphs aloud to check for natural flow248249**When Lists ARE Acceptable (Limited Cases):**250251Lists may appear in scientific papers only in specific contexts:252- **Methods**: Inclusion/exclusion criteria, materials and reagents, participant characteristics253- **Supplementary Materials**: Extended protocols, equipment lists, detailed parameters254- **Never in**: Abstract, Introduction, Results, Discussion, Conclusions255256**Integration with Research Lookup:**257258The research-lookup skill is essential for Stage 1 (creating outlines):2591. Search for relevant papers using research-lookup2602. Extract key findings, methods, and data2613. Organize findings as bullet points in your outline2624. Then convert the outline to full paragraphs in Stage 2263264This two-stage process ensures you:265- Gather and organize information systematically266- Create logical structure before writing267- Produce polished, publication-ready prose268- Maintain focus on the narrative flow269270### 8. Journal-Specific Formatting271272Adapt manuscripts to journal requirements:273- Follow author guidelines for structure, length, and format274- Apply journal-specific citation styles275- Meet figure/table specifications (resolution, file formats, dimensions)276- Include required statements (funding, conflicts of interest, data availability, ethical approval)277- Adhere to word limits for each section278- Format according to template requirements when provided279280### 9. Field-Specific Language and Terminology281282Adapt language, terminology, and conventions to match the specific scientific discipline. Each field has established vocabulary, preferred phrasings, and domain-specific conventions that signal expertise and ensure clarity for the target audience.283284**Identify Field-Specific Linguistic Conventions:**285- Review terminology used in recent high-impact papers in the target journal286- Note field-specific abbreviations, units, and notation systems287- Identify preferred terms (e.g., "participants" vs. "subjects," "compound" vs. "drug," "specimens" vs. "samples")288- Observe how methods, organisms, or techniques are typically described289290**Biomedical and Clinical Sciences:**291- Use precise anatomical and clinical terminology (e.g., "myocardial infarction" not "heart attack" in formal writing)292- Follow standardized disease nomenclature (ICD, DSM, SNOMED-CT)293- Specify drug names using generic names first, brand names in parentheses if needed294- Use "patients" for clinical studies, "participants" for community-based research295- Follow Human Genome Variation Society (HGVS) nomenclature for genetic variants296- Report lab values with standard units (SI units in most international journals)297298**Molecular Biology and Genetics:**299- Use italics for gene symbols (e.g., *TP53*), regular font for proteins (e.g., p53)300- Follow species-specific gene nomenclature (uppercase for human: *BRCA1*; sentence case for mouse: *Brca1*)301- Specify organism names in full at first mention, then use accepted abbreviations (e.g., *Escherichia coli*, then *E. coli*)302- Use standard genetic notation (e.g., +/+, +/-, -/- for genotypes)303- Employ established terminology for molecular techniques (e.g., "quantitative PCR" or "qPCR," not "real-time PCR")304305**Chemistry and Pharmaceutical Sciences:**306- Follow IUPAC nomenclature for chemical compounds307- Use systematic names for novel compounds, common names for well-known substances308- Specify chemical structures using standard notation (e.g., SMILES, InChI for databases)309- Report concentrations with appropriate units (mM, μM, nM, or % w/v, v/v)310- Describe synthesis routes using accepted reaction nomenclature311- Use terms like "bioavailability," "pharmacokinetics," "IC50" consistently with field definitions312313**Ecology and Environmental Sciences:**314- Use binomial nomenclature for species (italicized: *Homo sapiens*)315- Specify taxonomic authorities at first species mention when relevant316- Employ standardized habitat and ecosystem classifications317- Use consistent terminology for ecological metrics (e.g., "species richness," "Shannon diversity index")318- Describe sampling methods with field-standard terms (e.g., "transect," "quadrat," "mark-recapture")319320**Physics and Engineering:**321- Follow SI units consistently unless field conventions dictate otherwise322- Use standard notation for physical quantities (scalars vs. vectors, tensors)323- Employ established terminology for phenomena (e.g., "quantum entanglement," "laminar flow")324- Specify equipment with model numbers and manufacturers when relevant325- Use mathematical notation consistent with field standards (e.g., ℏ for reduced Planck constant)326327**Neuroscience:**328- Use standardized brain region nomenclature (e.g., refer to atlases like Allen Brain Atlas)329- Specify coordinates for brain regions using established stereotaxic systems330- Follow conventions for neural terminology (e.g., "action potential" not "spike" in formal writing)331- Use "neural activity," "neuronal firing," "brain activation" appropriately based on measurement method332- Describe recording techniques with proper specificity (e.g., "whole-cell patch clamp," "extracellular recording")333334**Social and Behavioral Sciences:**335- Use person-first language when appropriate (e.g., "people with schizophrenia" not "schizophrenics")336- Employ standardized psychological constructs and validated assessment names337- Follow APA guidelines for reducing bias in language338- Specify theoretical frameworks using established terminology339- Use "participants" rather than "subjects" for human research340341**General Principles:**342343**Match Audience Expertise:**344- For specialized journals: Use field-specific terminology freely, define only highly specialized or novel terms345- For broad-impact journals (e.g., *Nature*, *Science*): Define more technical terms, provide context for specialized concepts346- For interdisciplinary audiences: Balance precision with accessibility, define terms at first use347348**Define Technical Terms Strategically:**349- Define abbreviations at first use: "messenger RNA (mRNA)"350- Provide brief explanations for specialized techniques when writing for broader audiences351- Avoid over-defining terms well-known to the target audience (signals unfamiliarity with field)352- Create a glossary if numerous specialized terms are unavoidable353354**Maintain Consistency:**355- Use the same term for the same concept throughout (don't alternate between "medication," "drug," and "pharmaceutical")356- Follow a consistent system for abbreviations (decide on "PCR" or "polymerase chain reaction" after first definition)357- Apply the same nomenclature system throughout (especially for genes, species, chemicals)358359**Avoid Field Mixing Errors:**360- Don't use clinical terminology for basic science (e.g., don't call mice "patients")361- Avoid colloquialisms or overly general terms in place of precise field terminology362- Don't import terminology from adjacent fields without ensuring proper usage363364**Verify Terminology Usage:**365- Consult field-specific style guides and nomenclature resources366- Check how terms are used in recent papers from the target journal367- Use domain-specific databases and ontologies (e.g., Gene Ontology, MeSH terms)368- When uncertain, cite a key reference that establishes terminology369370### 10. Common Pitfalls to Avoid371372**Top Rejection Reasons:**3731. Inappropriate, incomplete, or insufficiently described statistics3742. Over-interpretation of results or unsupported conclusions3753. Poorly described methods affecting reproducibility3764. Small, biased, or inappropriate samples3775. Poor writing quality or difficult-to-follow text3786. Inadequate literature review or context3797. Figures and tables that are unclear or poorly designed3808. Failure to follow reporting guidelines381382**Writing Quality Issues:**383- Mixing tenses inappropriately (use past tense for methods/results, present for established facts)384- Excessive jargon or undefined acronyms385- Paragraph breaks that disrupt logical flow386- Missing transitions between sections387- Inconsistent notation or terminology388389## Workflow for Manuscript Development390391**Stage 1: Planning**3921. Identify target journal and review author guidelines3932. Determine applicable reporting guideline (CONSORT, STROBE, etc.)3943. Outline manuscript structure (usually IMRAD)3954. Plan figures and tables as the backbone of the paper396397**Stage 2: Drafting** (Use two-stage writing process for each section)3981. Start with figures and tables (the core data story)3992. For each section below, follow the two-stage process:400 - **First**: Create outline with bullet points using research-lookup401 - **Second**: Convert bullet points to full paragraphs with flowing prose4023. Write Methods (often easiest to draft first)4034. Draft Results (describing figures/tables objectively)4045. Compose Discussion (interpreting findings)4056. Write Introduction (setting up the research question)4067. Craft Abstract (synthesizing the complete story)4078. Create Title (concise and descriptive)408409**Remember**: Bullet points are for planning only—the final manuscript must be in complete paragraphs.410411**Stage 3: Revision**4121. Check logical flow and "red thread" throughout4132. Verify consistency in terminology and notation4143. Ensure figures/tables are self-explanatory4154. Confirm adherence to reporting guidelines4165. Verify all citations are accurate and properly formatted4176. Check word counts for each section4187. Proofread for grammar, spelling, and clarity419420**Stage 4: Final Preparation**4211. Format according to journal requirements4222. Prepare supplementary materials4233. Write cover letter highlighting significance4244. Complete submission checklists4255. Gather all required statements and forms426427## Integration with Other Scientific Skills428429This skill works effectively with:430- **Data analysis skills**: For generating results to report431- **Statistical analysis**: For determining appropriate statistical presentations432- **Literature review skills**: For contextualizing research433- **Figure creation tools**: For developing publication-quality visualizations434435## References436437This skill includes comprehensive reference files covering specific aspects of scientific writing:438439- `references/imrad_structure.md`: Detailed guide to IMRAD format and section-specific content440- `references/citation_styles.md`: Complete citation style guides (APA, AMA, Vancouver, Chicago, IEEE)441- `references/figures_tables.md`: Best practices for creating effective data visualizations442- `references/reporting_guidelines.md`: Study-specific reporting standards and checklists443- `references/writing_principles.md`: Core principles of effective scientific communication444445Load these references as needed when working on specific aspects of scientific writing.