MCPInstall

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
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads paper-writing automatically when relevant.

  3. 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 SkillArtifactUsed In
paper-planningStory summary (task → challenge → insight → contribution → advantage)Step 2 (Introduction writing plan)
paper-planningModule Motivation Mapping tableStep 3 (Method subsections)
paper-planningExperiment plan (comparisons + ablations + demos)Step 5 (Experiments section)
paper-planningPipeline figure sketchSteps 1, 6 (Method overview figure)
paper-planningClaim-to-experiment mappingSteps 2, 5, 9 (Introduction, Experiments, Abstract)
paper-planningFallback narrative (if planned)Step 4 (Introduction pivot), Step 9 (Conclusion)
experiment-pipelineStage 1-4 results, ablation tables, trajectory logsStep 5 (write experiments)
experiment-craftFailure analysis, implementation tricksStep 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.

  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 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.
  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"
  • 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-review records 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

  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

SectionReference FileWhen to Load
Abstractabstract-templates.mdStep 9: Writing abstract
Introductionintroduction-templates.mdStep 2: Story design
Methodmethod-templates.mdStep 3: Writing method
Experimentsexperiments-guide.mdStep 5: Writing experiments
Related Workrelated-work-guide.mdStep 7: Writing related work
Writing Principleswriting-principles.mdAny time during writing
Supplementarysupplementary-guide.mdDeciding main vs. supplementary content
Counterintuitive strategycounterintuitive-writing.mdImproving reviewer trust and novelty perception
Writing Practicewriting-practice.mdBuilding 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

View all →

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.

Docs & Writing482 installs

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

View category →

teach

mattpocock/skills

Teach the user a new skill or concept, within this workspace.

Education & Science874K installs

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.

Education & Science488.2K installs

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.

Education & Science478.3K installs

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.

Education & Science107.9K installs

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.

Education & Science67.9K installs

teach-impeccable

pbakaus/impeccable

DEPRECATED: Use /impeccable teach instead. This command has been folded into the impeccable skill.