academic-writing-refiner
by @zihan-zhu
Refine academic writing for computer science research papers targeting top-tier venues (NeurIPS, ICLR, ICML, AAAI, IJCAI, ACL, EMNLP, NAACL, CVPR, WWW, KDD, SIGIR, CIKM, and similar). Use this skill whenever a user asks to improve, polish, refine, edit, or proofread academic or research writing β including paper drafts, abstracts, introductions, related work sections, methodology descriptions, experiment write-ups, or conclusion sections. Also trigger when users paste LaTeX content and ask for w
clawhub install academic-writing-refinerπ About This Skill
name: academic-writing-refiner description: Refine academic writing for computer science research papers targeting top-tier venues (NeurIPS, ICLR, ICML, AAAI, IJCAI, ACL, EMNLP, NAACL, CVPR, WWW, KDD, SIGIR, CIKM, and similar). Use this skill whenever a user asks to improve, polish, refine, edit, or proofread academic or research writing β including paper drafts, abstracts, introductions, related work sections, methodology descriptions, experiment write-ups, or conclusion sections. Also trigger when users paste LaTeX content and ask for writing help, mention "camera-ready", "rebuttal", "paper revision", or reference any academic venue or conference. This skill handles both full paper refinement and section-by-section editing.
Academic Writing Refiner
This skill transforms rough or intermediate academic drafts into polished, publication-ready prose for top-tier CS conferences. The goal is writing that is clear, precise, and accessible to a broad technical audience β the kind of writing that reviewers at venues like NeurIPS, ICML, or ACL appreciate because it respects their time and communicates ideas efficiently.
Core Philosophy
Top CS conferences share a common expectation: writing should be a transparent window into the ideas, not a display of vocabulary. The best papers at NeurIPS, ACL, or KDD succeed not because they use impressive words, but because every sentence earns its place and every paragraph advances the reader's understanding.
This means:
How to Refine
When a user provides text to refine, follow this process:
1. Understand the Context
Before editing, figure out:
If the user doesn't specify, infer from content and ask only if genuinely ambiguous.
2. Apply Section-Specific Conventions
Read references/section-guide.md for detailed conventions per section type. The key principles:
Abstract: Should be self-contained, state the problem, approach, key result (with numbers), and significance β all in ~150β250 words. No citations, no undefined acronyms.
Introduction: Problem β gap β contribution β brief results β paper outline. The reader should understand what you did and why it matters within the first page.
Related Work: Group by theme, not by paper. Each paragraph should end by distinguishing the current work from what was just discussed. Avoid "laundry list" style (X did A. Y did B. Z did C.).
Methodology: Present the approach in logical order. Define notation before using it. Use equations for precision but always provide intuition in words alongside them.
Experiments: Lead with research questions or hypotheses, then describe setup, then results. Tables and figures should be self-contained with descriptive captions.
Conclusion: Summarize contributions (not the whole paper), acknowledge limitations honestly, suggest concrete future directions.
3. Sentence-Level Refinement
Consult references/word-choice.md for a quick-reference table of common substitutions (fancy β simple, filler β delete, hedging calibration, and transition connectives). Apply these transformations systematically:
Tighten prose:
Fix common academic writing issues:
Strengthen transitions:
4. LaTeX-Specific Handling
When the input contains LaTeX:
\cite{}, \ref{}, \label{}, equation environments, and custom macros exactly as written\textbf{}, \textit{}, \emph{} formatting choices~ (non-breaking spaces) before \cite and \ref% comments\paragraph{}, \subsubsection{} etc. unless the user asks for structural changes5. What NOT to Do
These are equally important as what to do:
Output Format
When presenting refined text:
1. Provide the refined version as the primary output, clearly separated from commentary 2. Add brief marginal notes for substantive changes β explain why you changed something when the reason isn't obvious (e.g., "Restructured to lead with the contribution rather than the gap" or "Made the comparison to X explicit") 3. Flag issues you cannot fix β missing citations, unclear experimental details, potential factual concerns β as a separate list at the end 4. If the input is LaTeX, output LaTeX. If the input is plain text, output plain text. Match the format.
Interaction Patterns
Full paper refinement: If the user provides an entire paper (or most of one), work section by section. Start with whichever section the user indicates, or begin with the abstract and introduction since those set the tone.
Single section: Apply the full refinement process to that section.
Quick polish: If the user says "just fix the grammar" or "light edit only", respect that β fix spelling, grammar, and punctuation without restructuring or rewriting.
Iterative refinement: After providing a refined version, be ready for feedback like "too formal", "I want to keep the original structure of paragraph 2", or "make the motivation stronger". Apply changes surgically without re-editing the rest.
Rebuttal writing: When the user mentions a rebuttal or reviewer response, read references/rebuttal-guide.md for specific advice on crafting effective rebuttals.
Common Venue-Specific Notes
| Venue Group | Style Tendencies | |---|---| | NeurIPS, ICML, ICLR | Concise, equation-centric. Theoretical rigor valued. Anonymous review β remove self-identifying references. | | AAAI, IJCAI | Broader AI scope. Motivation and real-world relevance important. Slightly more expository than ML-focused venues. | | ACL, EMNLP, NAACL | Thorough related work expected. Linguistic precision in terminology. Error analysis and ablation studies valued. | | CVPR | Visual results critical. Qualitative examples alongside quantitative. Clear figure descriptions. | | WWW, KDD, SIGIR, CIKM | Problem-driven motivation. Scalability and practical impact often expected. Dataset descriptions need care. |
These are tendencies, not rigid rules β good writing is good writing regardless of venue.