Agent skill

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).

Stars 141
Forks 17

Install this agent skill to your Project

npx add-skill https://github.com/EvoScientist/EvoSkills/tree/main/skills/paper-writing

Metadata

Additional technical details for this skill

tags
core research writing academic-writing latex
author
EvoScientist
version
1.0.0

SKILL.md

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) Steps 1-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 (Abstract, Introduction, Experiments)
paper-planning Fallback narrative (if planned) Steps 7-8 (Introduction / Conclusion pivot)
experiment-pipeline Stage 1-4 results, ablation tables, trajectory logs Step 5 (write experiments)
experiment-craft Failure analysis, implementation tricks Step 3 (Method section), Step 9 (limitations)

The 11-Step Writing Process

Follow these steps in order. Each step builds on the previous one.

  1. Draw a pipeline figure sketch — Sketch the method's pipeline figure to clarify the overall approach. The figure highlights novelty, not just explanation.
  2. 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.
  3. Write Method — Organize the Method writing plan, then draft Method. Run experiments in parallel.
  4. Revise Introduction and Method — Iterate on both sections while experiments continue.
  5. Write Experiments — Once experiments are mostly done, organize the Experiments writing plan, then draft.
  6. Polish figures — Finalize the pipeline figure. Create the teaser figure.
  7. Write Related Work — List related papers, group into topics, write paragraphs.
  8. Review the paper — Self-review Introduction, Method, and Experiments. Use the paper-review skill.
  9. Write Abstract — Organize the Abstract writing plan, then draft.
  10. Choose the title — List important keywords, then compose an informative title.
  11. Iterate — Repeatedly review and revise the entire paper.

Counterintuitive Writing Rules

Apply these rules when aiming for higher acceptance probability:

  1. Underclaim in prose, overdeliver in evidence: Reduce adjective intensity in Abstract/Introduction; let tables and figures carry the strength.
  2. State one meaningful limitation early: A controlled limitation statement increases credibility and lowers reviewer suspicion.
  3. Lead with mechanism, not only metric: Explain why the method works before listing numbers; reviewers trust causal logic more than isolated gains.
  4. Prefer one decisive figure over many average figures: Build one "cannot-ignore" figure that validates the central claim under hard conditions.
  5. Remove weak but flashy claims: Any claim without direct evidence should be deleted, even if it sounds impressive.
  6. Declare scope boundaries explicitly: One sentence in Introduction and Conclusion stating what your method targets reduces reviewer fear of hidden assumptions.
  7. 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:

  1. What technical problem do we solve, and why is there no well-established solution?
  2. What is our technical contribution?
  3. Why does our method fundamentally work?
  4. 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:

  1. Module design — Data structure, network design, forward process (given X input, step 1..., step 2..., output Y)
  2. Motivation — Why this module exists (problem-driven: "A remaining challenge is...")
  3. 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:

  1. How to prove our method is better → comparison experiments
  2. How to prove our modules are effective → ablation studies
  3. 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:

  1. List papers closely related to our method (most important — missing key references can cause rejection)
  2. Determine topics based on research direction and algorithm techniques
  3. 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"

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

  1. One message per paragraph — Each paragraph conveys exactly one point
  2. Topic sentence first — The first sentence tells readers what this paragraph is about
  3. Plan before writing — Outline the writing plan, refine each part, then write English sentences
  4. Flow between sentences — Ensure logical continuity between consecutive sentences
  5. Terminology consistency — Use the same term throughout; do not alternate names
  6. Reverse-outlining — After writing, extract the outline from paragraphs; check if the flow is smooth
  7. 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

Expand your agent's capabilities with these related and highly-rated skills.

EvoScientist/EvoSkills

evo-memory

Manages persistent research memory across ideation and experimentation cycles. Maintains two stores: Ideation Memory M_I (feasible/unsuccessful directions) and Experimentation Memory M_E (reusable strategies for data processing, model training, architecture, debugging). Three evolution mechanisms: IDE (after idea-tournament), IVE (after experiment failure — classifies failures as implementation vs fundamental), ESE (after experiment success — extracts reusable strategies). Use when: updating memory after completing idea tournaments or experiment pipelines, classifying why a method failed (implementation vs fundamental failure), starting a new research cycle needing prior knowledge, user mentions 'update memory', 'classify failure', 'what worked before', 'research history', 'evolution'. Do NOT use for running experiments (use experiment-pipeline), debugging experiment code (use experiment-craft), or generating ideas (use idea-tournament).

141 17
Explore
EvoScientist/EvoSkills

paper-navigator

End-to-end academic paper workflow: disambiguate queries, discover papers (search, citation traversal, recommendations, arXiv monitoring, trending, GitHub search), evaluate (TLDR, citations, code, SOTA), read with structured analysis (3-level strategy), and organize into literature maps or reports. Use when: finding papers, reading a paper, related work, literature survey, citation analysis, research trends, SOTA results, datasets, or literature reports. Do NOT use for writing a literature review section (use paper-writing), comparing research ideas (use idea-tournament), or planning paper structure (use paper-planning).

141 17
Explore
EvoScientist/EvoSkills

paper-review

Guides self-review of YOUR OWN academic paper before submission with adversarial stress-testing. Core method: 5-aspect checklist (contribution sufficiency, writing clarity, results quality, testing completeness, method design), 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).

141 17
Explore
EvoScientist/EvoSkills

experiment-craft

Use this skill when the user wants to debug, diagnose, or systematically iterate on an experiment that already exists, or when they need a structured experiment log for tracking runs, hypotheses, failures, results, and next steps during active research. Apply it to underperforming methods, training that will not converge, regressions after a change, inconsistent results across datasets, aimless experimentation without progress, and questions like 'why doesn't this work?', 'no progress after many attempts', or 'how should I investigate this failure?'. Also use it for setting up practical experiment logging/record-keeping that supports debugging and iteration. Do not use it for designing a brand-new experiment pipeline or full experiment program (use experiment-pipeline), generating research ideas, fixing isolated coding/syntax errors, or writing retrospective summaries into research memory/notes/knowledge bases.

141 17
Explore
EvoScientist/EvoSkills

experiment-pipeline

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).

141 17
Explore
EvoScientist/EvoSkills

academic-slides

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.

141 17
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results