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.
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:
- Methods (clearest, most concrete)
- Results (present findings)
- Introduction (frame the problem)
- Discussion (interpret results)
- Conclusion (summarize contributions)
- 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 the dataviz skill and
references/REFERENCE.md)
- 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)
Discipline-Specific Considerations
Computer Science / Engineering
- Emphasize reproducibility and implementation details
- Include complexity analysis where relevant
- Provide algorithm pseudocode or code snippets
- Compare against state-of-the-art baselines
- Make code/data available when possible
Natural Sciences
- Follow strict IMRAD structure (Intro, Methods, Results, Discussion)
- Report statistical power and effect sizes
- Include detailed experimental protocols
- Address confounding variables
- Report null results honestly
Social Sciences
- Contextualize within theoretical frameworks
- Justify sampling and participant selection
- Report demographic information
- Address potential biases
- Discuss generalizability limitations
Humanities
- Develop clear thesis statement
- Support arguments with textual evidence
- Engage with scholarly debates
- Use close reading and analysis
- Contextualize within historical/cultural frameworks
Conversation-First Approach
When helping users write papers, prioritize natural conversation over rapid-fire questions:
Start simple: Ask ONE opening question to understand their situation
- "What's your paper about?" (topic/working title)
- OR "What stage are you at?" (if they're already focused)
Listen and follow up: Based on their answer, ask the next most relevant question
- If they're starting: Ask about target venue or research gap
- If they're revising: Ask which section needs work
- If they're stuck: Ask what specific challenge they're facing
Build context progressively: Let information emerge naturally through dialogue
Provide targeted help: Focus on their immediate need, not all possible topics
Maintain author voice: Edit to improve, not to rewrite in a different style
Explain recommendations: Help them understand why changes strengthen their paper
Load references as needed: Use reference documents for deeper guidance only when relevant
Using Reference Materials
This skill includes detailed reference materials for deeper guidance:
- Load
references/REFERENCE.md for comprehensive writing guidelines, style guides, and detailed best practices
- Load
references/STRUCTURE.md for complete templates for different paper types (journal article, conference paper, thesis, etc.)
- Load
references/STYLE.md for in-depth guidance on academic writing style, word choice, and clarity
- Check
assets/ for ready-to-use templates in various formats
Only load these materials when needed to conserve context. For most tasks, the guidance above is sufficient.
Quality Checklist
Before considering a paper complete, verify:
Remember: All good papers go through multiple revisions. Writing is rewriting.
1---2name: paper-writing3description: Expert guidance for writing high-quality academic and research papers. Use when the user wants to write, structure, revise, or improve academic papers, research articles, conference papers, or technical reports. Provides comprehensive support for all stages from planning to final polish.4license: MIT5metadata:6 source: https://skillmd.com/skills/vishalsachdev/paper-writing7 category: writing8 version: 1.0.09 author: Claude Code Community10---1112# Academic Paper Writing Skill1314This 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.1516## Quick Start1718For immediate guidance, see the task-specific workflows below. For comprehensive reference material, consult:19- `references/REFERENCE.md` - Complete writing guidelines and best practices20- `references/STRUCTURE.md` - Detailed templates for different paper types21- `references/STYLE.md` - Writing style and clarity guidelines22- `assets/` - Ready-to-use paper templates2324## Core Workflow2526### 1. Planning Phase2728**Understand the Requirements**29- Identify target venue (journal, conference, report)30- Check formatting requirements (APA, IEEE, ACM, Chicago, etc.)31- Note page limits, section requirements, and citation style32- Clarify submission deadlines and review process3334**Define the Research Question**35- Formulate a clear, focused research question or hypothesis36- Ensure the question is specific, measurable, and answerable37- Identify the gap in existing knowledge or practice38- State the contribution your work will make3940**Create an Outline**41- Draft section headings based on paper type (see Structure section)42- Allocate approximate space to each section43- Identify key points for each section44- Map evidence and references to sections4546### 2. Writing Phase4748**Follow the Structured Approach**4950Work section-by-section, not necessarily in order. Many authors write in this sequence:511. Methods (clearest, most concrete)522. Results (present findings)533. Introduction (frame the problem)544. Discussion (interpret results)555. Conclusion (summarize contributions)566. Abstract (last, summarizes everything)5758**Section-Specific Guidance**5960**Abstract (150-300 words)**61- State the problem and motivation (1-2 sentences)62- Describe your approach/method (1-2 sentences)63- Summarize key results (2-3 sentences)64- State conclusions and implications (1-2 sentences)65- Make it self-contained (no citations, no undefined acronyms)6667**Introduction**68- Hook: Why should anyone care? (1 paragraph)69- Context: What's the broader problem space? (1-2 paragraphs)70- Gap: What's missing in current solutions? (1 paragraph)71- Your contribution: What does this paper do? (1 paragraph)72- Paper organization: Brief roadmap (optional, 1 paragraph)7374**Related Work / Literature Review**75- Group work thematically, not chronologically76- Compare and contrast approaches77- Identify limitations of existing work78- Position your work clearly vs. alternatives79- Be fair and accurate (don't strawman competitors)8081**Methodology / Approach**82- Describe methods with enough detail for replication83- Justify design choices84- Define metrics and evaluation criteria85- Explain data collection and analysis procedures86- Include diagrams for complex processes8788**Results**89- Present findings objectively without interpretation90- Use tables and figures effectively (see the dataviz skill and `references/REFERENCE.md`)91- Report statistical significance where applicable92- Address both positive and negative results93- Organize by research question or hypothesis9495**Discussion**96- Interpret results in context of research questions97- Compare with related work98- Explain unexpected findings99- Acknowledge limitations honestly100- Discuss implications for theory and practice101102**Conclusion**103- Restate key contributions (1 paragraph)104- Summarize main findings (1 paragraph)105- Discuss broader implications (1 paragraph)106- Suggest future work (1 paragraph)107- End with a strong closing statement108109### 3. Refinement Phase110111**First Revision: Structure and Argument**112- Does each section serve its purpose?113- Is the argument logical and complete?114- Are transitions between sections smooth?115- Does evidence support all claims?116- Are counterarguments addressed?117118**Second Revision: Clarity and Style**119- Remove jargon and define technical terms120- Eliminate redundancy and wordiness121- Use active voice for clarity (prefer "We analyzed" over "Analysis was performed")122- Ensure parallel structure in lists123- Check paragraph length (aim for 4-8 sentences)124125**Third Revision: Polish**126- Check grammar, spelling, punctuation127- Verify all citations are formatted correctly128- Ensure figures/tables are referenced in text129- Number sections, equations, figures consistently130- Proofread carefully (reading aloud helps)131132## Discipline-Specific Considerations133134**Computer Science / Engineering**135- Emphasize reproducibility and implementation details136- Include complexity analysis where relevant137- Provide algorithm pseudocode or code snippets138- Compare against state-of-the-art baselines139- Make code/data available when possible140141**Natural Sciences**142- Follow strict IMRAD structure (Intro, Methods, Results, Discussion)143- Report statistical power and effect sizes144- Include detailed experimental protocols145- Address confounding variables146- Report null results honestly147148**Social Sciences**149- Contextualize within theoretical frameworks150- Justify sampling and participant selection151- Report demographic information152- Address potential biases153- Discuss generalizability limitations154155**Humanities**156- Develop clear thesis statement157- Support arguments with textual evidence158- Engage with scholarly debates159- Use close reading and analysis160- Contextualize within historical/cultural frameworks161162## Conversation-First Approach163164When helping users write papers, prioritize natural conversation over rapid-fire questions:1651661. **Start simple**: Ask ONE opening question to understand their situation167 - "What's your paper about?" (topic/working title)168 - OR "What stage are you at?" (if they're already focused)1691702. **Listen and follow up**: Based on their answer, ask the next most relevant question171 - If they're starting: Ask about target venue or research gap172 - If they're revising: Ask which section needs work173 - If they're stuck: Ask what specific challenge they're facing1741753. **Build context progressively**: Let information emerge naturally through dialogue1761774. **Provide targeted help**: Focus on their immediate need, not all possible topics1781795. **Maintain author voice**: Edit to improve, not to rewrite in a different style1801816. **Explain recommendations**: Help them understand why changes strengthen their paper1821837. **Load references as needed**: Use reference documents for deeper guidance only when relevant184185## Using Reference Materials186187This skill includes detailed reference materials for deeper guidance:188189- **Load `references/REFERENCE.md`** for comprehensive writing guidelines, style guides, and detailed best practices190- **Load `references/STRUCTURE.md`** for complete templates for different paper types (journal article, conference paper, thesis, etc.)191- **Load `references/STYLE.md`** for in-depth guidance on academic writing style, word choice, and clarity192- **Check `assets/`** for ready-to-use templates in various formats193194Only load these materials when needed to conserve context. For most tasks, the guidance above is sufficient.195196## Quality Checklist197198Before considering a paper complete, verify:199200- [ ] Clear research question or contribution stated in introduction201- [ ] All claims supported by evidence or citations202- [ ] Logical flow from section to section203- [ ] Methods sufficiently detailed for replication204- [ ] Results presented objectively205- [ ] Discussion interprets results and addresses limitations206- [ ] All figures/tables referenced in text and have clear captions207- [ ] Citations formatted consistently208- [ ] Abstract accurately summarizes the paper209- [ ] No typos or grammatical errors210- [ ] Meets venue requirements (format, length, style)211212Remember: All good papers go through multiple revisions. Writing is rewriting.