paper-writing
Write scientific papers following IMRaD structure with proper citations. Use when: user asks to draft or improve a scientific paper, write specific sections, or format citations. NOT for: non-academic writing or presentation slides.
Best use case
paper-writing is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Write scientific papers following IMRaD structure with proper citations. Use when: user asks to draft or improve a scientific paper, write specific sections, or format citations. NOT for: non-academic writing or presentation slides.
Teams using paper-writing should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/paper-writing/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How paper-writing Compares
| Feature / Agent | paper-writing | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Write scientific papers following IMRaD structure with proper citations. Use when: user asks to draft or improve a scientific paper, write specific sections, or format citations. NOT for: non-academic writing or presentation slides.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Paper Writing Skill
Draft, structure, and refine scientific papers across all disciplines.
## When to Use
- "Write the methods section for..."
- "Draft an abstract for these results"
- "Help me structure this paper"
- "Format these citations in APA/IEEE"
- "Improve the introduction of my paper"
- Generating LaTeX-formatted content
## When NOT to Use
- Literature searching (use literature-search)
- Data analysis (use code-execution + scipy-analysis)
- Non-academic writing
- Grant proposals (different structure)
## Paper Structure (IMRaD)
### Title
- Concise, informative, contains key terms
- Avoid abbreviations and jargon
- 10-15 words ideal
### Abstract (150-300 words)
```
Background: [1-2 sentences: context and gap]
Objective: [1 sentence: what this study does]
Methods: [2-3 sentences: approach and data]
Results: [2-3 sentences: key findings with numbers]
Conclusions: [1-2 sentences: implications]
```
### Introduction
1. Broad context (funnel from general to specific)
2. Literature review (key findings, organized thematically)
3. Research gap (what's missing or contradictory)
4. Study objective and hypothesis
5. Brief approach overview
6. Significance statement
### Methods
- Study design and setting
- Participants/samples (inclusion/exclusion criteria)
- Materials and instruments
- Procedure (reproducible detail)
- Data analysis plan
- Ethical approvals
### Results
- Present in order of research questions
- Text + tables + figures (no redundancy)
- Statistical results: test statistic, df, p-value, effect size
- Report exact p-values (not just p < 0.05)
### Discussion
1. Summary of key findings
2. Comparison with prior literature
3. Mechanistic explanation
4. Strengths of the study
5. Limitations and their impact
6. Future directions
7. Conclusions and implications
## Citation Formats
### APA 7th Edition
- In-text: (Author, Year) or Author (Year)
- Two authors: (Smith & Jones, 2024)
- 3+ authors: (Smith et al., 2024)
### IEEE
- Numbered: [1], [2], [3]
- Reference list: [1] A. Author, "Title," Journal, vol. X, no. Y, pp. Z-Z, Year.
### Chicago (Author-Date)
- In-text: (Author Year, page)
- Bibliography: Author. Year. "Title." Journal Vol(Issue): Pages.
### Vancouver/NLM
- Numbered: (1), (2), (3)
- Reference: Author(s). Title. Journal. Year;Vol(Issue):Pages.
## LaTeX Templates
### Article
```latex
\documentclass[12pt]{article}
\usepackage{amsmath,graphicx,natbib}
\title{Title}
\author{Author}
\begin{document}
\maketitle
\begin{abstract}
...
\end{abstract}
\section{Introduction}
...
\bibliographystyle{plainnat}
\bibliography{refs}
\end{document}
```
## Integration with MCP Tools
**Citation Workflow**
1. Search papers via `academic-mcp` (19 databases) or `semantic-scholar-mcp`
2. Export BibTeX/APA/MLA citations directly from Semantic Scholar MCP
3. Manage references with `zotero-mcp` (if Zotero is available)
4. Use `arxiv-latex-mcp` to read LaTeX source for accurate equation citing
**Related Skills**
- For detailed LaTeX formatting → use `latex-writing` skill
- For citation network analysis → use `citation-analysis` skill
- For systematic reviews → use `systematic-review` skill
- For meta-analysis → use `meta-analysis` skill
## Guidelines
1. Use active voice where appropriate
2. Be precise — avoid vague qualifiers ("somewhat", "relatively")
3. Define abbreviations on first use
4. Every claim needs a citation or data reference
5. Tables and figures must be self-contained with captions
6. Follow target journal's style guide
7. Report effect sizes, not just p-values
8. Include CRediT author contributions, data availability, and COI statementsRelated Skills
writing
No description provided.
ssrn-econpapers
Search social science research papers across SSRN, RePEc/IDEAS, CrossRef, and Semantic Scholar. Use when: (1) finding working papers in economics, finance, law, or political science, (2) searching RePEc for economics papers, (3) querying CrossRef for social science journal articles, (4) retrieving citation metadata for social science research. NOT for: natural sciences (use arxiv-search or pubmed-search), computer science preprints (use arxiv-search), general academic search (use semantic-scholar).
scientific-writing
Assist with scientific paper writing, LaTeX formatting, abstract drafting, review responses, grant proposals, and academic communication. Use when user asks to write/edit a paper section, draft an abstract, format in LaTeX, respond to reviewer comments, write a grant proposal, or improve academic writing. Triggers on "write abstract", "draft introduction", "LaTeX", "reviewer response", "grant proposal", "improve my writing", "paper draft", "methods section".
review-writing
No description provided.
protocol-writing
No description provided.
paper-analysis
Read, summarize, and critically analyze scientific papers. Extract key findings, methodology, limitations, and contributions. Use when user shares a paper (PDF/URL/DOI), asks to summarize a paper, critique methodology, extract data from a paper, compare papers, or do a critical review. Triggers on "summarize this paper", "analyze this study", "what does this paper say", "critique this methodology", "extract findings from".
markdown-mermaid-writing
Comprehensive markdown and Mermaid diagram writing skill. Use when creating any scientific document, report, analysis, or visualization. Establishes text-based diagrams as the default documentation standard with full style guides (markdown + mermaid), 24 diagram type references, and 9 document templates.
latex-writing
Write and format LaTeX documents for academic journals. Use when: user asks to write LaTeX code, format papers for specific journals (Nature/Science/IEEE/ACM), create equations, tables, or BibTeX entries. NOT for: non-LaTeX writing (use paper-writing), data analysis, or literature search.
grant-writing
Assists with research grant proposal writing including specific aims, significance framing, innovation articulation, approach design, and budget justification for NIH, NSF, ERC, and other funding agencies; trigger when users discuss grant proposals, funding applications, or research funding strategy.
article-writing
Write articles, guides, blog posts, tutorials, newsletter issues, and other long-form content in a distinctive voice derived from supplied examples or brand guidance. Use when the user wants polished written content longer than a paragraph, especially when voice consistency, structure, and credibility matter.
xurl
A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.
xlsx
Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.