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.
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. 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
8. 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
9. 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
- Start with figures and tables (the core data story)
- 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)
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. IMRAD structure, citations (APA/AMA/Vancouver), figures/tables, reporting guidelines (CONSORT/STROBE/PRISMA), abstracts, for research papers and journal submissions.4---5
6# Scientific Writing
7
8## Overview
9
10Scientific 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.
11
12## When to Use This Skill
13
14This skill should be used when:
15- Writing or revising any section of a scientific manuscript (abstract, introduction, methods, results, discussion)
16- Structuring a research paper using IMRAD or other standard formats
17- Formatting citations and references in specific styles (APA, AMA, Vancouver, Chicago, IEEE)
18- Creating, formatting, or improving figures, tables, and data visualizations
19- Applying study-specific reporting guidelines (CONSORT for trials, STROBE for observational studies, PRISMA for reviews)
20- Drafting abstracts that meet journal requirements (structured or unstructured)
21- Preparing manuscripts for submission to specific journals
22- Improving writing clarity, conciseness, and precision
23- Ensuring proper use of field-specific terminology and nomenclature
24- Addressing reviewer comments and revising manuscripts
25
26## Core Capabilities
27
28### 1. Manuscript Structure and Organization
29
30**IMRAD Format**: Guide papers through the standard Introduction, Methods, Results, And Discussion structure used across most scientific disciplines. This includes:
31- **Introduction**: Establish research context, identify gaps, state objectives
32- **Methods**: Detail study design, populations, procedures, and analysis approaches
33- **Results**: Present findings objectively without interpretation
34- **Discussion**: Interpret results, acknowledge limitations, propose future directions
35
36For detailed guidance on IMRAD structure, refer to `references/imrad_structure.md`.
37
38**Alternative Structures**: Support discipline-specific formats including:
39- Review articles (narrative, systematic, scoping)
40- Case reports and case series
41- Meta-analyses and pooled analyses
42- Theoretical/modeling papers
43- Methods papers and protocols
44
45### 2. Section-Specific Writing Guidance
46
47**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.
48
49**Introduction Development**: Build compelling introductions that:
50- Establish the research problem's importance
51- Review relevant literature systematically
52- Identify knowledge gaps or controversies
53- State clear research questions or hypotheses
54- Explain the study's novelty and significance
55
56**Methods Documentation**: Ensure reproducibility through:
57- Detailed participant/sample descriptions
58- Clear procedural documentation
59- Statistical methods with justification
60- Equipment and materials specifications
61- Ethical approval and consent statements
62
63**Results Presentation**: Present findings with:
64- Logical flow from primary to secondary outcomes
65- Integration with figures and tables
66- Statistical significance with effect sizes
67- Objective reporting without interpretation
68
69**Discussion Construction**: Synthesize findings by:
70- Relating results to research questions
71- Comparing with existing literature
72- Acknowledging limitations honestly
73- Proposing mechanistic explanations
74- Suggesting practical implications and future research
75
76### 3. Citation and Reference Management
77
78Apply citation styles correctly across disciplines. For comprehensive style guides, refer to `references/citation_styles.md`.
79
80**Major Citation Styles:**
81- **AMA (American Medical Association)**: Numbered superscript citations, common in medicine
82- **Vancouver**: Numbered citations in square brackets, biomedical standard
83- **APA (American Psychological Association)**: Author-date in-text citations, common in social sciences
84- **Chicago**: Notes-bibliography or author-date, humanities and sciences
85- **IEEE**: Numbered square brackets, engineering and computer science
86
87**Best Practices:**
88- Cite primary sources when possible
89- Include recent literature (last 5-10 years for active fields)
90- Balance citation distribution across introduction and discussion
91- Verify all citations against original sources
92- Use reference management software (Zotero, Mendeley, EndNote)
93
94### 4. Figures and Tables
95
96Create effective data visualizations that enhance comprehension. For detailed best practices, refer to `references/figures_tables.md`.
97
98**When to Use Tables vs. Figures:**
99- **Tables**: Precise numerical data, complex datasets, multiple variables requiring exact values
100- **Figures**: Trends, patterns, relationships, comparisons best understood visually
101
102**Design Principles:**
103- Make each table/figure self-explanatory with complete captions
104- Use consistent formatting and terminology across all display items
105- Label all axes, columns, and rows with units
106- Include sample sizes (n) and statistical annotations
107- Follow the "one table/figure per 1000 words" guideline
108- Avoid duplicating information between text, tables, and figures
109
110**Common Figure Types:**
111- Bar graphs: Comparing discrete categories
112- Line graphs: Showing trends over time
113- Scatterplots: Displaying correlations
114- Box plots: Showing distributions and outliers
115- Heatmaps: Visualizing matrices and patterns
116
117### 5. Reporting Guidelines by Study Type
118
119Ensure completeness and transparency by following established reporting standards. For comprehensive guideline details, refer to `references/reporting_guidelines.md`.
120
121**Key Guidelines:**
122- **CONSORT**: Randomized controlled trials
123- **STROBE**: Observational studies (cohort, case-control, cross-sectional)
124- **PRISMA**: Systematic reviews and meta-analyses
125- **STARD**: Diagnostic accuracy studies
126- **TRIPOD**: Prediction model studies
127- **ARRIVE**: Animal research
128- **CARE**: Case reports
129- **SQUIRE**: Quality improvement studies
130- **SPIRIT**: Study protocols for clinical trials
131- **CHEERS**: Economic evaluations
132
133Each guideline provides checklists ensuring all critical methodological elements are reported.
134
135### 6. Writing Principles and Style
136
137Apply fundamental scientific writing principles. For detailed guidance, refer to `references/writing_principles.md`.
138
139**Clarity**:
140- Use precise, unambiguous language
141- Define technical terms and abbreviations at first use
142- Maintain logical flow within and between paragraphs
143- Use active voice when appropriate for clarity
144
145**Conciseness**:
146- Eliminate redundant words and phrases
147- Favor shorter sentences (15-20 words average)
148- Remove unnecessary qualifiers
149- Respect word limits strictly
150
151**Accuracy**:
152- Report exact values with appropriate precision
153- Use consistent terminology throughout
154- Distinguish between observations and interpretations
155- Acknowledge uncertainty appropriately
156
157**Objectivity**:
158- Present results without bias
159- Avoid overstating findings or implications
160- Acknowledge conflicting evidence
161- Maintain professional, neutral tone
162
163### 7. Journal-Specific Formatting
164
165Adapt manuscripts to journal requirements:
166- Follow author guidelines for structure, length, and format
167- Apply journal-specific citation styles
168- Meet figure/table specifications (resolution, file formats, dimensions)
169- Include required statements (funding, conflicts of interest, data availability, ethical approval)
170- Adhere to word limits for each section
171- Format according to template requirements when provided
172
173### 8. Field-Specific Language and Terminology
174
175Adapt 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.
176
177**Identify Field-Specific Linguistic Conventions:**
178- Review terminology used in recent high-impact papers in the target journal
179- Note field-specific abbreviations, units, and notation systems
180- Identify preferred terms (e.g., "participants" vs. "subjects," "compound" vs. "drug," "specimens" vs. "samples")
181- Observe how methods, organisms, or techniques are typically described
182
183**Biomedical and Clinical Sciences:**
184- Use precise anatomical and clinical terminology (e.g., "myocardial infarction" not "heart attack" in formal writing)
185- Follow standardized disease nomenclature (ICD, DSM, SNOMED-CT)
186- Specify drug names using generic names first, brand names in parentheses if needed
187- Use "patients" for clinical studies, "participants" for community-based research
188- Follow Human Genome Variation Society (HGVS) nomenclature for genetic variants
189- Report lab values with standard units (SI units in most international journals)
190
191**Molecular Biology and Genetics:**
192- Use italics for gene symbols (e.g., *TP53*), regular font for proteins (e.g., p53)
193- Follow species-specific gene nomenclature (uppercase for human: *BRCA1*; sentence case for mouse: *Brca1*)
194- Specify organism names in full at first mention, then use accepted abbreviations (e.g., *Escherichia coli*, then *E. coli*)
195- Use standard genetic notation (e.g., +/+, +/-, -/- for genotypes)
196- Employ established terminology for molecular techniques (e.g., "quantitative PCR" or "qPCR," not "real-time PCR")
197
198**Chemistry and Pharmaceutical Sciences:**
199- Follow IUPAC nomenclature for chemical compounds
200- Use systematic names for novel compounds, common names for well-known substances
201- Specify chemical structures using standard notation (e.g., SMILES, InChI for databases)
202- Report concentrations with appropriate units (mM, μM, nM, or % w/v, v/v)
203- Describe synthesis routes using accepted reaction nomenclature
204- Use terms like "bioavailability," "pharmacokinetics," "IC50" consistently with field definitions
205
206**Ecology and Environmental Sciences:**
207- Use binomial nomenclature for species (italicized: *Homo sapiens*)
208- Specify taxonomic authorities at first species mention when relevant
209- Employ standardized habitat and ecosystem classifications
210- Use consistent terminology for ecological metrics (e.g., "species richness," "Shannon diversity index")
211- Describe sampling methods with field-standard terms (e.g., "transect," "quadrat," "mark-recapture")
212
213**Physics and Engineering:**
214- Follow SI units consistently unless field conventions dictate otherwise
215- Use standard notation for physical quantities (scalars vs. vectors, tensors)
216- Employ established terminology for phenomena (e.g., "quantum entanglement," "laminar flow")
217- Specify equipment with model numbers and manufacturers when relevant
218- Use mathematical notation consistent with field standards (e.g., ℏ for reduced Planck constant)
219
220**Neuroscience:**
221- Use standardized brain region nomenclature (e.g., refer to atlases like Allen Brain Atlas)
222- Specify coordinates for brain regions using established stereotaxic systems
223- Follow conventions for neural terminology (e.g., "action potential" not "spike" in formal writing)
224- Use "neural activity," "neuronal firing," "brain activation" appropriately based on measurement method
225- Describe recording techniques with proper specificity (e.g., "whole-cell patch clamp," "extracellular recording")
226
227**Social and Behavioral Sciences:**
228- Use person-first language when appropriate (e.g., "people with schizophrenia" not "schizophrenics")
229- Employ standardized psychological constructs and validated assessment names
230- Follow APA guidelines for reducing bias in language
231- Specify theoretical frameworks using established terminology
232- Use "participants" rather than "subjects" for human research
233
234**General Principles:**
235
236**Match Audience Expertise:**
237- For specialized journals: Use field-specific terminology freely, define only highly specialized or novel terms
238- For broad-impact journals (e.g., *Nature*, *Science*): Define more technical terms, provide context for specialized concepts
239- For interdisciplinary audiences: Balance precision with accessibility, define terms at first use
240
241**Define Technical Terms Strategically:**
242- Define abbreviations at first use: "messenger RNA (mRNA)"
243- Provide brief explanations for specialized techniques when writing for broader audiences
244- Avoid over-defining terms well-known to the target audience (signals unfamiliarity with field)
245- Create a glossary if numerous specialized terms are unavoidable
246
247**Maintain Consistency:**
248- Use the same term for the same concept throughout (don't alternate between "medication," "drug," and "pharmaceutical")
249- Follow a consistent system for abbreviations (decide on "PCR" or "polymerase chain reaction" after first definition)
250- Apply the same nomenclature system throughout (especially for genes, species, chemicals)
251
252**Avoid Field Mixing Errors:**
253- Don't use clinical terminology for basic science (e.g., don't call mice "patients")
254- Avoid colloquialisms or overly general terms in place of precise field terminology
255- Don't import terminology from adjacent fields without ensuring proper usage
256
257**Verify Terminology Usage:**
258- Consult field-specific style guides and nomenclature resources
259- Check how terms are used in recent papers from the target journal
260- Use domain-specific databases and ontologies (e.g., Gene Ontology, MeSH terms)
261- When uncertain, cite a key reference that establishes terminology
262
263### 9. Common Pitfalls to Avoid
264
265**Top Rejection Reasons:**
2661. Inappropriate, incomplete, or insufficiently described statistics
2672. Over-interpretation of results or unsupported conclusions
2683. Poorly described methods affecting reproducibility
2694. Small, biased, or inappropriate samples
2705. Poor writing quality or difficult-to-follow text
2716. Inadequate literature review or context
2727. Figures and tables that are unclear or poorly designed
2738. Failure to follow reporting guidelines
274
275**Writing Quality Issues:**
276- Mixing tenses inappropriately (use past tense for methods/results, present for established facts)
277- Excessive jargon or undefined acronyms
278- Paragraph breaks that disrupt logical flow
279- Missing transitions between sections
280- Inconsistent notation or terminology
281
282## Workflow for Manuscript Development
283
284**Stage 1: Planning**
2851. Identify target journal and review author guidelines
2862. Determine applicable reporting guideline (CONSORT, STROBE, etc.)
2873. Outline manuscript structure (usually IMRAD)
2884. Plan figures and tables as the backbone of the paper
289
290**Stage 2: Drafting**
2911. Start with figures and tables (the core data story)
2922. Write Methods (often easiest to draft first)
2933. Draft Results (describing figures/tables objectively)
2944. Compose Discussion (interpreting findings)
2955. Write Introduction (setting up the research question)
2966. Craft Abstract (synthesizing the complete story)
2977. Create Title (concise and descriptive)
298
299**Stage 3: Revision**
3001. Check logical flow and "red thread" throughout
3012. Verify consistency in terminology and notation
3023. Ensure figures/tables are self-explanatory
3034. Confirm adherence to reporting guidelines
3045. Verify all citations are accurate and properly formatted
3056. Check word counts for each section
3067. Proofread for grammar, spelling, and clarity
307
308**Stage 4: Final Preparation**
3091. Format according to journal requirements
3102. Prepare supplementary materials
3113. Write cover letter highlighting significance
3124. Complete submission checklists
3135. Gather all required statements and forms
314
315## Integration with Other Scientific Skills
316
317This skill works effectively with:
318- **Data analysis skills**: For generating results to report
319- **Statistical analysis**: For determining appropriate statistical presentations
320- **Literature review skills**: For contextualizing research
321- **Figure creation tools**: For developing publication-quality visualizations
322
323## References
324
325This skill includes comprehensive reference files covering specific aspects of scientific writing:
326
327- `references/imrad_structure.md`: Detailed guide to IMRAD format and section-specific content
328- `references/citation_styles.md`: Complete citation style guides (APA, AMA, Vancouver, Chicago, IEEE)
329- `references/figures_tables.md`: Best practices for creating effective data visualizations
330- `references/reporting_guidelines.md`: Study-specific reporting standards and checklists
331- `references/writing_principles.md`: Core principles of effective scientific communication
332
333Load these references as needed when working on specific aspects of scientific writing.