Academic Paper Writing Skill

This skill provides comprehensive guidance for writing excellent academic and research papers across all disciplines. It covers structure, style, argumentation, and best practices from initial planning through final revision.

When to Use This Skill

Use this skill when working on:

• Research papers and journal articles
• Conference papers and proceedings
• Technical reports and white papers
• Thesis chapters and dissertations
• Literature reviews and survey papers
• Position papers and perspectives

Quick Start

For immediate guidance, see the task-specific workflows below. For comprehensive reference material, consult:

• references/REFERENCE.md - Complete writing guidelines and best practices
• references/STRUCTURE.md - Detailed templates for different paper types
• references/STYLE.md - Writing style and clarity guidelines
• assets/ - Ready-to-use paper templates

Core Workflow

1. Planning Phase

Understand the Requirements

• Identify target venue (journal, conference, report)
• Check formatting requirements (APA, IEEE, ACM, Chicago, etc.)
• Note page limits, section requirements, and citation style
• Clarify submission deadlines and review process

Define the Research Question

• Formulate a clear, focused research question or hypothesis
• Ensure the question is specific, measurable, and answerable
• Identify the gap in existing knowledge or practice
• State the contribution your work will make

Create an Outline

• Draft section headings based on paper type (see Structure section)
• Allocate approximate space to each section
• Identify key points for each section
• Map evidence and references to sections

2. Writing Phase

Follow the Structured Approach

Work section-by-section, not necessarily in order. Many authors write in this sequence:

1. Methods (clearest, most concrete)
2. Results (present findings)
3. Introduction (frame the problem)
4. Discussion (interpret results)
5. Conclusion (summarize contributions)
6. Abstract (last, summarizes everything)

Section-Specific Guidance

Abstract (150-300 words)

• State the problem and motivation (1-2 sentences)
• Describe your approach/method (1-2 sentences)
• Summarize key results (2-3 sentences)
• State conclusions and implications (1-2 sentences)
• Make it self-contained (no citations, no undefined acronyms)

Introduction

• Hook: Why should anyone care? (1 paragraph)
• Context: What's the broader problem space? (1-2 paragraphs)
• Gap: What's missing in current solutions? (1 paragraph)
• Your contribution: What does this paper do? (1 paragraph)
• Paper organization: Brief roadmap (optional, 1 paragraph)

Related Work / Literature Review

• Group work thematically, not chronologically
• Compare and contrast approaches
• Identify limitations of existing work
• Position your work clearly vs. alternatives
• Be fair and accurate (don't strawman competitors)

Methodology / Approach

• Describe methods with enough detail for replication
• Justify design choices
• Define metrics and evaluation criteria
• Explain data collection and analysis procedures
• Include diagrams for complex processes

Results

• Present findings objectively without interpretation
• Use tables and figures effectively (see Visualization section)
• Report statistical significance where applicable
• Address both positive and negative results
• Organize by research question or hypothesis

Discussion

• Interpret results in context of research questions
• Compare with related work
• Explain unexpected findings
• Acknowledge limitations honestly
• Discuss implications for theory and practice

Conclusion

• Restate key contributions (1 paragraph)
• Summarize main findings (1 paragraph)
• Discuss broader implications (1 paragraph)
• Suggest future work (1 paragraph)
• End with a strong closing statement

3. Refinement Phase

First Revision: Structure and Argument

• Does each section serve its purpose?
• Is the argument logical and complete?
• Are transitions between sections smooth?
• Does evidence support all claims?
• Are counterarguments addressed?

Second Revision: Clarity and Style

• Remove jargon and define technical terms
• Eliminate redundancy and wordiness
• Use active voice for clarity (prefer "We analyzed" over "Analysis was performed")
• Ensure parallel structure in lists
• Check paragraph length (aim for 4-8 sentences)

Third Revision: Polish

• Check grammar, spelling, punctuation
• Verify all citations are formatted correctly
• Ensure figures/tables are referenced in text
• Number sections, equations, figures consistently
• Proofread carefully (reading aloud helps)

Visualization Best Practices

Tables

• Use for precise numerical comparisons
• Keep simple and readable (avoid excessive gridlines)
• Include clear column headers and units
• Caption goes above the table
• Reference in text before the table appears

Figures

• Use for trends, patterns, relationship

...