research-paper-writing

Draft and revise ML, CV, NLP, and systems research papers with strong claim-evidence flow, reviewer-aware structure, and submission-ready section planning. Use when the user needs help with an abstract, introduction, related work, method, experiments, ablations, discussion, figures/tables, checklist

By akillness · 458 installs

npx skills add akillness/jeo-skills --skill research-paper-writing

Source repository · Upstream listing

research paper writing Use this skill when the job is not generic prose cleanup, but turning research work into a defensible manuscript package . The center of gravity is: contribution framing, claim → evidence alignment, section level structure, figure/table support, reviewer facing completeness, rebuttal and camera ready revision. Read these support notes before drafting or revising: [references/claim evidence packet.md](references/claim evidence packet.md) [references/experiment and figure coverage.md](references/experiment and figure coverage.md) [references/rebuttal and camera ready.md](references/rebuttal and camera ready.md) When to use this skill Drafting or rewriting an abstract around concrete claims and measurable evidence Structuring an introduction so motivation, gap, method, and contributions land quickly Turning notes, code results, or slide bullets into a method section with reproducible detail Designing experiment, ablation, error analysis, or figure/table coverage for a paper Writing related work that positions the paper instead of listing references Tightening a rebuttal, reviewer response, or camera ready revision plan under strict limits Checking whether the manuscript actually supports each promised contribution When not to use this skill The request is an internal design doc, ADR, architecture note, or engineering runbook → use technical writing The request is an API portal, SDK reference, or developer facing product documentation problem → use api documentation The request is an end user tutorial, onboarding guide, or FAQ → use technical writing The request is a slide deck, investor pitch, roadmap deck, or game pitch → use presentation builder The request is broad marketing or launch messaging rather than academic publication → use marketing automation The request is only citation collection / literature discovery without manuscript writing or revision pressure Instructions Step 1: Lock the paper contract Before writing, define this packet: If the core claim or required evidence is fuzzy, fix that first. Weak framing leaks into every section. Step 2: Map each claim to proof Build a quick claim evidence table before drafting: Claim Evidence needed Supporting figure/table Risk if missing ... ... ... ... Do not let a headline contribution survive without an experiment, ablation, analysis, or explicit scope boundary. Step 3: Draft the abstract from claims, not chronology Use this order: 1. problem and stakes 2. gap in existing work 3. proposed method 4. strongest quantitative or qualitative result 5. scope, limitation, or implication Replace vague phrases like “significant improvement” with metric + benchmark + margin whenever possible. Step 4: Build the introduction as a reviewer funnel Structure the introduction in five moves: 1. why the problem matters 2. why existing approaches fall short 3. what your method changes 4. what the evidence shows 5. bullet contributions Contribution bullets should be specific and testable , not marketing copy. Step 5: Make the method reproducible The method section should answer: what inputs and outputs exist, what modules or stages the system contains, what training or optimization objective is used, what implementation choices materially affect results, what assumptions or boundary conditions matter. Use equations only where they clarify behavior. If a precise algorithm box, table, or pipeline list explains the system more cleanly, prefer that. Step 6: Treat experiments as the proof section Cover at least: main benchmark or task results, strong baselines, ablations for the claimed mechanism, qualitative or failure analysis when useful, efficiency / compute / cost when the paper claims practicality, limitations or scope notes when evidence is mixed. Each subsection should map back to one contribution claim. Step 7: Check figures, tables, and checklist coverage For each important figure or table, verify: what claim it supports, whether the caption states the takeaway, whether the text references it at the right moment, whether a reviewer could misread it without extra context, whether the venue checklist expects additional disclosure. If a result is important enough to mention in the abstract or contribution bullets, it usually deserves a clear table or figure anchor. Step 8: Write rebuttals with evidence first For each reviewer concern: 1. restate the concern precisely, 2. answer directly in one sentence, 3. add concrete evidence, 4. say what text, figure, table, or experiment changes in the revision, 5. keep tone calm and non defensive. Use a response matrix before final prose if several reviewers overlap or contradict one another. Step 9: Return one paper ready packet Choose the single most useful output for the current stage: abstract rewrite introduction / contribution framing packet method clarification packet experiment + ablation plan figure/table support packet reviewer response / rebuttal packet camera ready revision checklist Do not emit a vague “full paper advice” dump if the user clearly needs one stage specific artifact. Output format Examples Example 1: Abstract rewrite Input: notes on a diffusion model paper benchmark table target venue: CVPR Output: a 150–200 word abstract with problem, gap, method, results, and scope one warning about the strongest unsupported claim Example 2: Experiment plan Input: draft method section three claimed contributions Output: experiment matrix listing datasets, baselines, ablations, metrics, and figure/table owners one note on which contribution is still under supported Example 3: Rebuttal packet Input: reviewer comments from OpenReview current manuscript claims two new analyses available, no time for new large experiment Output: point by point response packet manuscript change list explicit note on what can be promised for camera ready versus what cannot Best practices 1. Every major claim should have a matching figure, table, ablation, or explicit limitation. 2. Do not bury the best result in the middle of a paragraph. 3. Use consistent terminology for modules, datasets, and metrics throughout the paper. 4. Prefer short, information dense sentences over long narrative transitions. 5. If a result is mixed, state the boundary clearly instead of overselling. 6. Treat rebuttal writing as evidence packaging, not persuasion theater. 7. Keep this skill narrow: manuscript structure, evidence, figures/tables, and reviewer responses — not generic research tooling. References Overleaf collaboration and versioning docs OpenReview author response workflow NeurIPS paper checklist and venue reporting expectations Academic writing / response letter guidance synthesized in the support docs under references/