paper-writing
Skill481 starsChanged 46 days agoApache-2.0View on GitHub
Guides writing academic papers section by section using an 11-step workflow with LaTeX templates and counterintuitive writing tactics. Covers Abstract, Introduction, Method, Experiments, Related Work, Conclusion, and Supplementary. Use when: user asks to write or draft a paper section, needs LaTeX templates, wants to improve academic writing quality, optimize novelty framing, or mentions 'write introduction', 'draft method', 'paper writing'. Do NOT use for pre-submission review (use paper-review), experiment execution (use experiment-pipeline), or paper planning/story design (use paper-planning).
36 other projects use a version of this, 1 of them edited.
Adopted by
Most recently taken up by
- kinhluan/skillstheir own version, first seen Nov 8, 2026
- 70asunflower/70asunflower-skillstheir own version, first seen Nov 8, 2026
- SNL-UCSB/paper-writing-skilltheir own version, first seen Nov 4, 2026
- VeryMath/AI4Math-Writingtheir own version, first seen Nov 3, 2026
- Deadpoolmine/systematic-research-skillstheir own version, first seen Nov 1, 2026
- takayoshitoyoda05/claude-ml-templatetheir own version, first seen Oct 20, 2026
Used with
Projects with it also use ml-training-recipe, replication and 9 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
getcompanion-aiSkillml-training-recipe
Find implementable ML training recipes from papers, datasets, docs, and code. Use when the user wants to fine-tune, train, reproduce, or choose a practical ML method, dataset, hyperparameter setup, or benchmark recipe.
Also in 3 projects that use this
getcompanion-aiSkillreplication
Plan a replication of a paper, claim, or benchmark, and execute only after an explicit environment choice. Use when the user asks to replicate results, reproduce an experiment, verify a claim empirically, or build a replication package.
Also in 3 projects that use this
brainbytes-devSkillalpha-research
Also in 3 projects that use this
JaimeParkerSkillpaper-code-audit
Perform three-way cross-validation of a research paper by comparing the original paper text (via Zotero), official code implementation (via Git), and personal Obsidian notes. Use this skill whenever the user wants to "audit a paper", "verify paper claims against code", "cross-check notes with implementation", "triangulate paper + code + notes", "find discrepancies between paper and code", or mentions wanting a deep, structured comparison of a paper's claims against its implementation and their own notes. Also trigger when the user asks to "analyze this paper thoroughly" with code available, or when they want to systematically reconcile what the paper says, what the code does, and what their notes claim.
Also in 3 projects that use this
JimLiuSkillpdf-explore
Use this skill when the user has attached a PDF, paper, report, or other document and the answer needs content from more than one place in it: summarize the methods or any other section, compare sections, find where a topic is discussed, read a value or label off a figure or chart, or find/list/extract every instance of something across the whole document (datasets, benchmarks, citations, figures, table rows, accession numbers — including appendices). Skip it only for a single lookup of 1–4 pages quoted in your very next response — `read_file(pages=[...])` attaches pages as images that are dropped from context after one turn, so multi-section answers end up re-reading the same ranges repeatedly. Parses the PDF once in the Python kernel: `pdf_pages` (pages as persistent text), `pdf_outline` (TOC), `pdf_scan` (rank pages by relevance), `pdf_map`/`pdf_extract` (per-page summary / structured fields via parallel haiku calls). For PDF creation/manipulation, use reportlab/pypdf directly.
Also in 4 projects that use this
Yusong-EnceladusSkillresearch-review
Get a deep critical review of research from GPT via Codex MCP. Use when user says "review my research", "help me review", "get external review", or wants critical feedback on research ideas, papers, or experimental results.
Also in 6 projects that use this
- +1 more from getcompanion-ai
Other versions36 projects use a version of this.
Word for word · 0
None found.
Edited · 1
- KalarisLabs/Skill-Doctor★ 1297% same
Wrote their own version · 35
- wanshuiyin/Auto-claude-code-research-in-sleep★ 19ksame name
- advaitpaliwal/feynman★ 10ksame name
- companion-inc/feynman★ 10ksame name
- getcompanion-ai/feynman★ 10ksame name
- MLNLP-World/Paper-Writing-Tips★ 4.7ksame name
- ZimoLiao/scholaraio★ 585same name
- SNL-UCSB/paper-writing-skill★ 249same name
- voidful/academic-skills★ 126same name
- TenureAI/PhD-Zero★ 52same name
- Chanw-research/claude-code-paper-writing★ 42same name
25 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository15 other files it gives its agents.
- academic-slidesSkill
- evomath-taoSkill
- evo-memorySkill
- experiment-craftSkill
- experiment-iterative-coderSkill
- experiment-pipelineSkill
- nano-bananaSkill
- paper-figuresSkill
- paper-graphSkill
- paper-navigatorSkill
- paper-planningSkill
- paper-rebuttalSkill
- paper-reviewSkill
- research-ideationSkill
- research-surveySkill
The file
We split this skill into the rules it gives an agent
9 rules. 0 are common, 7 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 26 edited versions we read keep these.
7
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 24
If you used upstream EvoSkills, pull these artifacts before writing:
- Distinctive: line 39
Follow these steps in order.
- Distinctive: line 89
Anti-pattern: Never write "here is a naive solution, then our improvement" — this makes the work appear incremental.
- Distinctive: line 93
Every pipeline module needs three elements:
- Distinctive: line 98
Start with an Overview paragraph (setting + core contribution + section roadmap), then one subsection per module.
- Distinctive: line 122
Must include Limitation section (reviewers frequently cite "no limitation" as a weakness)
- Distinctive: line 155
Before writing the title, list important keywords, then compose
- Distinctive: line 157
Avoid generic titles; specific phrases are more memorable
- Very specific: line 166
Before invoking paper-review, verify this checklist:
“Common” is measured: kept by at least 6 in 10 of the 26 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Paper Writing
A systematic 11-step workflow for writing academic papers, with section-specific templates and battle-tested writing principles.
When to Use This Skill
- User asks to write or draft a paper or paper section
- User needs LaTeX templates for Abstract, Introduction, Method, Experiments, etc.
- User wants to improve academic writing quality
- User mentions "paper writing", "write introduction", "draft method section", etc.
Artifact Sources
If you used upstream EvoSkills, pull these artifacts before writing:
| Source Skill | Artifact | Used In |
paper-planning | Story summary (task → challenge → insight → contribution → advantage) | Step 2 (Introduction writing plan) |
paper-planning | Module Motivation Mapping table | Step 3 (Method subsections) |
paper-planning | Experiment plan (comparisons + ablations + demos) | Step 5 (Experiments section) |
paper-planning | Pipeline figure sketch | Steps 1, 6 (Method overview figure) |
paper-planning | Claim-to-experiment mapping | Steps 2, 5, 9 (Introduction, Experiments, Abstract) |
paper-planning | Fallback narrative (if planned) | Step 4 (Introduction pivot), Step 9 (Conclusion) |
experiment-pipeline | Stage 1-4 results, ablation tables, trajectory logs | Step 5 (write experiments) |
experiment-craft | Failure analysis, implementation tricks | Step 3 (Method section / Supplementary), Step 9 (Conclusion limitations) |
The 11-Step Writing Process
Follow these steps in order. Each step builds on the previous one.
- Draw a pipeline figure sketch — Sketch the method's pipeline figure to clarify the overall approach. The figure highlights novelty, not just explanation.
- Design the story and plan experiments — Outline the paper's story (core contribution, module motivations). List comparison experiments and ablation studies. Draft an Introduction writing plan.
- Write Method — Organize the Method writing plan, then draft Method. Run experiments in parallel.
- Revise Introduction and Method — Iterate on both sections while experiments continue.
- Write Experiments — Once experiments are mostly done, organize the Experiments writing plan, then draft.
- Polish figures — Finalize the pipeline figure. Create the teaser figure.
- Write Related Work — List related papers, group into topics, write paragraphs.
- Review the paper — Self-review Introduction, Method, and Experiments. Use the
paper-reviewskill. - Write Abstract and Conclusion — Organize the Abstract writing plan, then draft. Write the Conclusion with its Limitation section, so that every section exists before the final iterations.
- Choose the title — List important keywords, then compose an informative title.
- Iterate — Repeatedly review and revise the entire paper.
Counterintuitive Writing Rules
Apply these rules when aiming for higher acceptance probability:
- Underclaim in prose, overdeliver in evidence: Reduce adjective intensity in Abstract/Introduction; let tables and figures carry the strength.
- State one meaningful limitation early: A controlled limitation statement increases credibility and lowers reviewer suspicion.
- Lead with mechanism, not only metric: Explain why the method works before listing numbers; reviewers trust causal logic more than isolated gains.
- Prefer one decisive figure over many average figures: Build one "cannot-ignore" figure that validates the central claim under hard conditions.
- Remove weak but flashy claims: Any claim without direct evidence should be deleted, even if it sounds impressive.
- Declare scope boundaries explicitly: One sentence in Introduction and Conclusion stating what your method targets reduces reviewer fear of hidden assumptions.
- Show one failure case: Include one representative failure with diagnosis — it signals competence, not weakness.
See references/counterintuitive-writing.md for all 7 tactics with before/after examples.
Section Quick Reference
Abstract
Answer these questions before drafting:
- What technical problem do we solve, and why is there no well-established solution?
- What is our technical contribution?
- Why does our method fundamentally work?
- What is our technical advantage / new insight?
Three template versions: challenge-first, insight-bridge, multi-contribution. See references/abstract-templates.md
Introduction
Thinking process (reverse then forward):
- Reverse: (1) What is the technical problem? (2) What are our contributions? (3) Benefits and new insights? (4) How to lead into the challenge?
- Forward: (1) Task → (2) Previous methods → challenge → (3) Our contributions → (4) Technical advantages and insights
Four ways to introduce the task, three ways to present challenges, four ways to describe the pipeline. See references/introduction-templates.md
Anti-pattern: Never write "here is a naive solution, then our improvement" — this makes the work appear incremental.
Method
Every pipeline module needs three elements:
- Module design — Data structure, network design, forward process (given X input, step 1..., step 2..., output Y)
- Motivation — Why this module exists (problem-driven: "A remaining challenge is...")
- Technical advantages — Why this module works well
Start with an Overview paragraph (setting + core contribution + section roadmap), then one subsection per module. See references/method-templates.md
Experiments
Three key questions to answer:
- How to prove our method is better → comparison experiments
- How to prove our modules are effective → ablation studies
- How to showcase the method's upper limit → demos on challenging data
Ablation studies need: one big table (core contributions) + several small tables (design choices, hyperparameters). See references/experiments-guide.md
Related Work
Three-step process:
- List papers closely related to our method (most important — missing key references can cause rejection)
- Determine topics based on research direction and algorithm techniques
- Organize writing plan based on listed papers
See references/related-work-guide.md
Conclusion
- Must include Limitation section (reviewers frequently cite "no limitation" as a weakness)
- Limitation = task goal / setting limitations (like future work), NOT technical defects
- Rule: "If our method does not fall below current SOTA metrics, it is not a technical defect"
- That rule is about how to frame performance. A leak, an unfair comparison or an unsupported claim is a defect at any metric level: fix it rather than write it up as a limitation (
paper-reviewrecords it as a finding)
Supplementary Material
For page-limited venues, decide what goes in main paper vs. supplementary:
- Core evidence for claims must stay in the main paper
- Implementation details, extra ablations, full visual galleries go in supplementary
- Reference supplementary at the point of need, not as a blanket statement
See references/supplementary-guide.md
Core Writing Principles
- One message per paragraph — Each paragraph conveys exactly one point
- Topic sentence first — The first sentence tells readers what this paragraph is about
- Plan before writing — Outline the writing plan, refine each part, then write English sentences
- Flow between sentences — Ensure logical continuity between consecutive sentences
- Terminology consistency — Use the same term throughout; do not alternate names
- Reverse-outlining — After writing, extract the outline from paragraphs; check if the flow is smooth
- Iterate relentlessly — Polish repeatedly, asking whether readers can follow
See references/writing-principles.md
Key Insight
Visual polish directly influences review outcomes. See the paper-planning skill's figure-design.md for the full visual quality guide.
Paper Title Guidelines
- The title attracts specific reviewers — choose keywords carefully
- Before writing the title, list important keywords, then compose
- Title must be informative: include the technique, task, or problem solved
- Avoid generic titles; specific phrases are more memorable
LaTeX Assets
- assets/paper-skeleton.tex — Annotated LaTeX skeleton with section structure
- assets/table-style.tex — Booktabs table macros with color highlighting
Handoff to Review
Before invoking paper-review, verify this checklist:
- All sections (Abstract, Introduction, Method, Experiments, Related Work, Conclusion) drafted
- Every claim in Abstract/Introduction anchored to a table or figure
- Limitation section present in Conclusion
- Pipeline figure and teaser figure finalized
- All
\todo{}markers resolved or removed
Section Navigation
| Section | Reference File | When to Load |
| Abstract | abstract-templates.md | Step 9: Writing abstract |
| Introduction | introduction-templates.md | Step 2: Story design |
| Method | method-templates.md | Step 3: Writing method |
| Experiments | experiments-guide.md | Step 5: Writing experiments |
| Related Work | related-work-guide.md | Step 7: Writing related work |
| Writing Principles | writing-principles.md | Any time during writing |
| Supplementary | supplementary-guide.md | Deciding main vs. supplementary content |
| Counterintuitive strategy | counterintuitive-writing.md | Improving reviewer trust and novelty perception |
| Writing Practice | writing-practice.md | Building writing ability through deliberate practice |
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

