
paper-writing
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).
- Installs
- 506
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/evoscientist/evoskills --skill paper-writing- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads paper-writing automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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 |
FAQ
What does the paper-writing skill do?
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).
How do I install paper-writing?
Run npx skills add https://github.com/evoscientist/evoskills --skill paper-writing in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/paper-writing/ (personal) or .claude/skills/paper-writing/ (project).
Which AI agents can use paper-writing?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is paper-writing safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains paper-writing?
It is published by evoscientist in evoscientist/evoskills. It has 506 recorded installs.
More from evoscientist/evoskills
paper-review
evoscientist/evoskills
Guides self-review of YOUR OWN academic paper before submission with adversarial stress-testing. Core method: three passes (adversarial deep read; 5-aspect checklist — contribution sufficiency, writing clarity, results quality, testing completeness, method design; mechanical consistency scans and experimental protocol audit of data flow, assumptions, leakage), counterintuitive protocol (reject-first simulation, delete unsupported claims, score trust, promote limitations, attack novelty), reverse-outlining, and figure/table quality checks. Use when: user wants to self-review or self-check their own paper draft before submission, stress-test their claims, prepare for reviewer criticism, or mentions 'self-review', 'check my draft', 'is my paper ready'. Do NOT use for writing a peer review of someone else's paper, and do NOT use after receiving actual reviews (use paper-rebuttal instead). Also runs as a background expert: dispatch it async with a draft path and it reviews end-to-end while
research-ideation
evoscientist/evoskills
End-to-end research ideation pipeline: literature grounding → multi-track idea generation (3 personas: innovator/pragmatist/critic) → iterative refinement → ELO tournament ranking → update evo-memory (IDE) → user selects direction → expand into manuscript-quality proposal. Use when: user wants to find a research direction, brainstorm ideas, evaluate idea novelty, design a novel solution, rank/compare research ideas, or generate a research proposal. Do NOT use for finding/searching/reading papers (use paper-navigator), literature survey reports (use research-survey), or planning a paper (use paper-planning).
academic-slides
evoscientist/evoskills
Use this skill for creating or refining an academic slide deck and the talk built around it: structuring a conference talk, thesis defense, lab meeting, or paper-to-slides deck; deciding the narrative arc and slide breakdown; improving slide design and visual hierarchy; planning rehearsal, timing, Q&A, and backup slides; or generating the .pptx. Reach for it when the user is shaping the presentation itself. Do not use for writing the paper, producing standalone speaker notes/scripts/transcripts, making posters, creating isolated figures/charts outside a slide deck, or building non-academic presentations.
paper-rebuttal
evoscientist/evoskills
Guides writing effective rebuttals after receiving peer review feedback. Covers review diagnosis (score-driven color-coding), response strategy (champion identification, common-theme consolidation), tactical writing (18 rules), and counterintuitive rebuttal principles. Use when: user received reviewer scores/comments, needs to write a rebuttal or author response, wants to respond to specific criticism (e.g. 'limited novelty', 'missing baselines'), mentions 'rebuttal', 'reviewer comments', 'author response', or 'respond to reviewers'. Do NOT use for pre-submission self-review (use paper-review instead).
paper-planning
evoscientist/evoskills
Guides pre-writing planning for academic papers with 4 structured steps: story design (task-challenge-insight-contribution-advantage), experiment planning (comparisons + ablations), figure design (pipeline + teaser), and 4-week timeline management. Includes counterintuitive planning tactics (write a mock rejection letter to identify weaknesses before writing, narrow before broad claims, design ablations first). Use when: user wants to plan a paper before writing, design story/contributions, plan experiments, create figure sketches, set a writing timeline, or write a pre-emptive rejection letter for planning purposes. Do NOT use for actual writing (use paper-writing), running experiments (use experiment-pipeline), self-reviewing a finished draft (use paper-review), or finding research problems (use research-ideation).
experiment-pipeline
evoscientist/evoskills
Guides structured 4-stage experiment execution with attempt budgets and gate conditions: Stage 1 initial implementation (reproduce baseline), Stage 2 hyperparameter tuning, Stage 3 proposed method validation, Stage 4 ablation study. Integrates with evo-memory (load prior strategies, trigger IVE/ESE) and experiment-craft (5-step diagnostic on failure). Use when: user has a planned experiment, needs to reproduce baselines, organize experiment workflow, or systematically validate a method. Do NOT use for debugging a specific experiment failure (use experiment-craft) or designing which experiments to run (use paper-planning).
Popular education & science skills
teach
mattpocock/skills
Teach the user a new skill or concept, within this workspace.
scaffold-exercises
mattpocock/skills
Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.
paper-context-resolver
lllllllama/rigorpilot-skills
Rigor Paper Context helper for README-first deep learning repo reproduction. Use only when the README and repository files leave a narrow reproduction-critical gap and the task is to resolve a specific paper detail such as dataset split, preprocessing, evaluation protocol, checkpoint mapping, or runtime assumption from primary paper sources while recording conflicts. Do not use for general paper summary, repo scanning, environment setup, command execution, title-only paper lookup, or replacing README guidance by default.
caveman-learn
juliusbrussee/caveman
Act on a Caveman learn report - review the ranked token sinks, apply cost-lowering fixes with per-edit consent, and report what those fixes returned. Use when asked to lower an agent's token cost, what caveman has saved, to trim a heavy CLAUDE.md, or to offload re-pasted context into cavemem.
gsap-plugins
greensock/gsap-skills
Official GSAP skill for GSAP plugins — registration, ScrollToPlugin, ScrollSmoother, Flip, Draggable, Inertia, Observer, SplitText, ScrambleText, SVG and physics plugins, CustomEase, EasePack, CustomWiggle, CustomBounce, GSDevTools. Use when the user asks about a GSAP plugin, scroll-to, flip animations, draggable, SVG drawing, or plugin registration.
teach-impeccable
pbakaus/impeccable
DEPRECATED: Use /impeccable teach instead. This command has been folded into the impeccable skill.