paper-edit
Paper editing with built-in style constraints for academic writing quality, including anti-AI detection, LaTeX validation, and figure standards
SKILL.mdskills/paper-edit/skill.md
GitHubPaper Edit
Edit academic papers with enforced style constraints to ensure human-quality writing and clean presentation.
When to Use
- Editing or revising LaTeX paper sections
- Polishing paper drafts before submission
- Converting between conference templates
- Shortening paper to meet page limits
- Cleaning up figures and captions
Style Rules (ALWAYS Enforced)
Writing Style
Banned patterns --- never use these:
- Em-dashes (
---or--) --- replace with commas, periods, or parentheses - AI-style phrases: 'notably', 'leveraging', 'comprehensive', 'crucial', 'landscape', 'delve', 'furthermore', 'utilize', 'facilitate', 'underscore', 'in the realm of'
- Passive voice overuse --- prefer active voice
- Overly long sentences (>40 words) --- split them
- Redundant hedging: 'it is worth noting that', 'it should be noted that'
Required style:
- Natural, human academic tone
- Direct and concise
- Logical flow between sentences and paragraphs
- Consistent terminology throughout
LaTeX Conventions
\cite{a,b,c}--- no spaces after commas- Use
\crefor\Creffor cross-references when available - Table/figure labels:
\label{tab:xxx},\label{fig:xxx} - No orphan
\itemor\\at end of paragraphs - Compile with
pdflatexafter each edit to verify
Figure Standards
- Clean and minimal --- no decorative elements
- No unnecessary arrows, crowded labels, or extra legends
- Simple color schemes (colorblind-friendly preferred)
- Clear axis labels with readable font sizes (minimum 8pt)
- Captions: under 2 lines, factual, no interpretation
- Use vector formats (PDF) when possible
Caption Standards
- Short and factual: describe what the figure shows
- No interpretation or analysis in captions
- Format: "[Description of what is shown]. [Key observation if needed]."
- Under 2 lines for figures, under 3 lines for tables
Workflow
Step 0: Stage Plan (for restructures or 3+ edits)
Before touching any file, if the request involves restructuring, multiple sections, or more than 3 separate edits:
- List every file and section you will touch.
- Group edits into 3-5 stages with a compilation checkpoint after each.
- Present the plan and wait for user approval before executing stage 1.
- Do not bundle stages. Re-confirm between stages if scope changes.
For single targeted edits (e.g., "fix typo in §2.1"), skip Step 0 and apply directly.
Scope Discipline (always)
- When the user names specific items (reviewer comment numbers, flagged locations, bullets), edit ONLY those items.
- Never wholesale-replace an abstract, section, or formatting unless explicitly asked.
- During venue rebrands (e.g., CCS→NDSS), preserve all citations; only update template/formatting.
Step 1: Read the Target Section
Read the full section to understand context and flow. Do not read sibling sections unless explicitly part of the requested scope.
Step 2: Scan for Violations
Check for all style rule violations:
- Grep for em-dashes:
---and--(outside of LaTeX comments) - Grep for banned phrases
- Check caption lengths
- Verify
\citeformatting
Step 3: Apply Fixes
Fix violations while preserving the author's intent and argument structure. Do not rewrite content unnecessarily --- only fix what violates the rules.
Step 4: Verify Compilation
pdflatex -interaction=nonstopmode main.tex
bibtex main
pdflatex -interaction=nonstopmode main.tex
Report any compilation errors and fix them.
Step 5: Summary Report
After editing, report:
- Number of em-dashes removed
- Number of AI phrases replaced
- Captions shortened (if any)
- Compilation status
- Any remaining issues
Page Reduction Tips
When asked to shorten a paper:
- Captions first --- shorten verbose captions
- Redundant text --- remove sentences that repeat prior content
- Tighten figures --- reduce whitespace, combine subfigures
- Compress related work --- cite and move on, don't summarize extensively
- LaTeX tricks last ---
\vspace{-Xpt},\setlengthadjustments
Integration
latex-check.jsPostToolUse hook auto-validates compilation after .tex editswriting-anti-aiskill provides deeper anti-AI writing analysisml-paper-writingskill provides venue-specific writing guidance