| name | section-writing |
| description | Write academic paper sections with appropriate structure, flow, and scholarly tone. Use when drafting introductions, literature reviews, methodology, results, discussions, or conclusions. |
| metadata | {"author":"core-team","version":"1.0.0"} |
Academic Section Writing
Your Task
When drafting a paper section, produce scholarly prose that:
- Follows the conventions for that section type
- Flows logically from paragraph to paragraph
- Integrates evidence seamlessly with narrative
- Maintains appropriate academic tone
- Connects to adjacent sections
Section-Specific Guidance
Introduction
Purpose: Orient readers, establish significance, preview structure.
Structure:
- Hook - Engaging opening that establishes relevance
- Context - Background needed to understand the problem
- Gap/Problem - What's missing or needs addressing
- Purpose - What this paper aims to do
- Scope - What's included and excluded
- Preview - Brief roadmap of the paper
Key Moves:
- Start broad, narrow to specific
- Use present tense for general truths
- End with clear thesis or purpose statement
Example Opening Patterns:
"In recent years, [topic] has attracted increasing attention due to..."
"Despite extensive research on [topic], [gap] remains unexplored..."
"The challenge of [problem] has significant implications for..."
Literature Review / Background
Purpose: Establish theoretical foundation, position your work.
Structure:
- Thematic Organization - Group by topic, not chronologically
- Critical Analysis - Don't just summarize, evaluate
- Synthesis - Show connections between sources
- Gap Identification - Lead to your contribution
Key Moves:
- Use reporting verbs (argues, demonstrates, suggests)
- Compare and contrast perspectives
- Build toward your research gap
Transition Patterns:
"Building on this foundation, [Author] extended..."
"In contrast to the view that..., [Author] argues..."
"These findings align with earlier work by..."
Methodology / Methods
Purpose: Explain how you did the work so others can replicate.
Structure:
- Overview - Brief summary of approach
- Materials/Participants - What/who was involved
- Procedure - Step-by-step process
- Analysis - How data was processed
- Justification - Why these choices
Key Moves:
- Use past tense for what you did
- Be precise and specific
- Justify choices with citations
Precision Examples:
✗ "We collected some data..."
✓ "Data were collected from 150 participants over a 6-week period..."
✗ "We analyzed the results..."
✓ "Thematic analysis was conducted following Braun and Clarke's (2006) six-phase approach..."
Results / Findings
Purpose: Present what you found without interpretation.
Structure:
- Overview - Summary of main findings
- Detailed Presentation - Finding by finding
- Supporting Evidence - Data, quotes, statistics
- Objective Description - No interpretation yet
Key Moves:
- Use past tense
- Present findings in logical order
- Reference figures/tables explicitly
- Avoid interpretation (save for Discussion)
Presenting Data:
"As shown in Table 1, participants..."
"Figure 2 illustrates the relationship between..."
"Analysis revealed three primary themes: (1)..., (2)..., (3)..."
Discussion
Purpose: Interpret findings, connect to literature, acknowledge limitations.
Structure:
- Summary - Key findings restated
- Interpretation - What findings mean
- Connection - How this relates to existing literature
- Implications - Why this matters
- Limitations - Honest assessment of constraints
- Future Work - Where to go from here
Key Moves:
- Connect each finding to literature
- Balance confidence with hedging
- Address unexpected results
- Be honest about limitations
Interpretation Patterns:
"These findings suggest that..."
"This result is consistent with [Author]'s (Year) observation that..."
"Contrary to expectations, the data indicate..."
"One possible explanation for this finding is..."
Conclusion
Purpose: Synthesize, emphasize significance, close effectively.
Structure:
- Restatement - Thesis/purpose reminder
- Summary - Key points (not just repetition)
- Significance - Why this matters
- Implications - Practical or theoretical
- Final Thought - Memorable closing
Key Moves:
- Don't introduce new information
- Elevate to broader significance
- End with impact
Closing Patterns:
"This study demonstrates that..."
"Taken together, these findings advance our understanding of..."
"As [field] continues to evolve, [contribution] provides..."
Academic Writing Conventions
Tone and Voice
| Preferred | Avoid |
|---|
| Formal | Casual/colloquial |
| Objective | Emotional/subjective |
| Precise | Vague |
| Hedged (where appropriate) | Absolute claims |
| Active voice (often) | Excessive passive |
Hedging Language
Use hedging for claims that aren't certain:
| Strong Claim | Hedged Version |
|---|
| This proves | This suggests |
| Always | Often, typically |
| Clearly | Arguably, apparently |
| Must | May, might, could |
Transition Words
Addition: Furthermore, Moreover, Additionally, In addition
Contrast: However, Nevertheless, Conversely, In contrast
Cause/Effect: Therefore, Consequently, As a result, Thus
Example: For instance, For example, Specifically, To illustrate
Sequence: First, Subsequently, Finally, Meanwhile
Summary: In summary, Overall, To conclude, In brief
Paragraph Structure
Each paragraph should:
- Topic Sentence - Main point of the paragraph
- Development - Evidence, examples, explanation
- Analysis - Interpretation, significance
- Transition - Link to next paragraph
Example Structure:
[Topic] Research has shown that color perception varies significantly across individuals.
[Evidence] Smith (2023) found that approximately 8% of males experience some form of color vision deficiency.
[Analysis] This variability has important implications for color journey design, as palettes must account for perceptual differences.
[Transition] Building on this understanding, the following section examines...
Flow and Coherence
Creating Flow
- Use transition words at paragraph starts
- Repeat key terms (but not excessively)
- Use pronouns to link to previous sentences
- Follow old-to-new information pattern
Information Flow
Old information (what reader knows) → New information (what you're adding)
✓ "The algorithm processes input data. This data is first validated..."
✓ "Three factors influence perception. The most significant of these is..."
Avoiding Choppiness
Connect short, related sentences:
✗ "The study was conducted. It involved 50 participants. They were students."
✓ "The study involved 50 student participants."
Citation Integration
Integral Citations (author as subject)
"Smith (2023) argues that..."
"According to Jones (2022),..."
"As Brown (2021) demonstrates,..."
Non-Integral Citations (author in parentheses)
"Color perception varies across individuals (Smith, 2023)."
"Recent research supports this view (Jones, 2022; Brown, 2021)."
Reporting Verbs (vary based on strength)
| Neutral | Tentative | Strong |
|---|
| states | suggests | argues |
| notes | implies | demonstrates |
| observes | indicates | proves |
| reports | proposes | establishes |
Common Mistakes to Avoid
- Starting with definitions - Weave definitions into context
- Listing without synthesis - Connect and analyze sources
- Abrupt transitions - Use linking phrases
- Inconsistent tense - Match section conventions
- Over-hedging - Balance caution with confidence
- Unsupported claims - Every claim needs evidence or qualification
Quick Reference
| Section | Tense | Voice | Key Focus |
|---|
| Introduction | Present | Active | Engage, contextualize |
| Literature | Present/Past | Mix | Synthesize, critique |
| Methods | Past | Mix | Describe, justify |
| Results | Past | Mix | Present objectively |
| Discussion | Present/Past | Active | Interpret, connect |
| Conclusion | Present | Active | Synthesize, impact |