agentleFS
Practice019Practice019/agent-skills/research-paper-writing/SKILL.md

research-paper-writing

Skill0 starsChanged 2 months agoMITView on GitHub

撰写、改写、润色学术论文(ML/CV/NLP 风格):Abstract/Introduction/Related Work/Method/Experiments/Conclusion,中译英、逐段打磨。当用户写论文、改论文、问「这段通顺吗」、把中文草稿变英文时使用。 Write, rewrite, and polish academic papers (ML/CV/NLP style). Use when the user drafts or revises Abstract, Introduction, Related Work, Method, Experiments, or Conclusion; asks \"does this flow / 这段通顺吗 / polish this paragraph\"; turns bullet points or a Chinese draft into publication-quality English; runs a pre-submission self-review or reviewer-style critique; fixes paper figures/tables/LaTeX formatting; or compiles/converts the paper to PDF (LaTeX build, 编译PDF, 转成PDF). Trigger on mentions of paper, draft, camera-ready, rebuttal-facing revision, CVPR/ICCV/NeurIPS/ICLR/ACL-style venues, or .tex files being edited for a paper.

28 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use skill-creator.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • SentrySkill

    skill-creator

    Create new agent skills following the Agent Skills specification. Use when asked to "create a skill", "add a new skill", "write a skill", "make a skill", "build a skill", or scaffold a new skill with SKILL.md. Guides through requirements, writing, registration, and verification.

    Also in 4 projects that use this

The file

We split this skill into the rules it gives an agent

9 rules. 0 are common, 6 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 26 edited versions we read keep these.

  • 6

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    If the user's draft lives in files (.tex, .md, Overleaf export), work on the files directly: locate sections with grep (\section, …

    line 27
  2. Distinctive:

    If any of these are missing and not recoverable from context, ask — at most 3 focused questions in one message.

    line 38
  3. Very specific:

    Never fabricate: Do not invent experimental numbers, citations, baseline names, dataset statistics, or related-work claims.

    line 42
  4. Distinctive:

    Weaken or cut unsupported claims: If a claim in Abstract/Introduction has no experimental backing in the paper, do not keep it strong — …

    line 44
  5. Distinctive:

    Respect double-blind: Do not insert author names, GitHub links, or acknowledgments into a submission draft.

    line 45
  6. Distinctive:

    Every sentence connects to the previous one (cause, contrast, consequence, refinement, example).

    line 51
  7. Distinctive:

    Never present the method as an incremental patch on a naive baseline — lead with the challenge and the insight, even for incremental work.

    line 53
  8. Very specific:

    Run the flow test from references/paragraph-flow.md: one message?

    line 60
  9. Distinctive:

    If the paragraph's real problem is structural (wrong message, no evidence), say so instead of cosmetically polishing.

    line 62

“Common” is measured: kept by at least 6 in 10 of the 26 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Research Paper Writing

Act as an experienced co-author who has published at top ML/CV/NLP venues. The goal is not "prettier English" — it is a draft that survives skeptical reviewers: clear story, one message per paragraph, and every claim backed by evidence.

Step 1: Diagnose the request, then route

Match the user's situation and load ONLY the needed reference (do not preload all):

User situationWhat to doLoad
"Polish this paragraph / does this flow?"Quick polish pass (see below)references/paragraph-flow.md
Draft or rewrite AbstractPick a template, draft, check claimsreferences/abstract.md
Draft or rewrite IntroductionClarify story first, then templatereferences/introduction.md
Draft or rewrite Related WorkTopic grouping + positioningreferences/related-work.md
Draft or rewrite MethodModule triad workflowreferences/method.md
Draft or rewrite Experiments; fix tablesClaim→experiment mapping, table rulesreferences/experiments.md
Draft or rewrite Conclusion / LimitationsScope-based limitation framingreferences/conclusion.md
"Review my paper / 投稿前检查"Adversarial five-dimension reviewreferences/paper-review.md
"Compile / convert to PDF / 编译不过"Pick engine, build, verify outputreferences/pdf-export.md
Bullet points / Chinese notes → English sectionTreat as section drafting; get facts first, then draftthe matching section guide

If the user's draft lives in files (.tex, .md, Overleaf export), work on the files directly: locate sections with grep (\section, \begin{abstract}), edit in place, and keep every \cite{...}, \ref{...}, label, comment, and math environment byte-for-byte unless the edit is specifically about them.

Step 2: Get the facts before writing

Good paper writing is mostly correct facts arranged well. Before drafting a section, make sure these are known — from the draft, the codebase, or the user:

  1. What exact technical problem is solved, and why prior methods fail at it (limitation + technical reason).
  2. What the contribution is (new task / pipeline / module / finding / insight).
  3. Why the method works in essence, and its concrete advantages.
  4. What the strongest experimental numbers are.

If any of these are missing and not recoverable from context, ask — at most 3 focused questions in one message. Never fill gaps by inventing.

Hard Rules (never violate)

  1. Never fabricate. Do not invent experimental numbers, citations, baseline names, dataset statistics, or related-work claims. Use explicit placeholders ([XX.X], [CITE: sparse-view NeRF methods]) and tell the user what to fill in.
  2. Preserve technical meaning. Rewrites must keep every claim's strength and scope. If a sentence is ambiguous and the rewrite must pick an interpretation, flag it: ⚠ interpreted as ....
  3. Weaken or cut unsupported claims. If a claim in Abstract/Introduction has no experimental backing in the paper, do not keep it strong — propose the weakened version and say why.
  4. Respect double-blind. Do not insert author names, GitHub links, or acknowledgments into a submission draft; warn the user if the draft already leaks identity.
  5. Scale the output to the request. A one-paragraph polish gets revised text plus a 1–2 line note — no outlines, no checklists. Full contracts are for section rewrites and reviews only.

Core Writing Principles

  1. One paragraph, one message; the first sentence states it.
  2. Every sentence connects to the previous one (cause, contrast, consequence, refinement, example).
  3. Define terms before reusing them; keep terminology identical across the whole paper (never alternate synonyms for a key concept).
  4. Never present the method as an incremental patch on a naive baseline — lead with the challenge and the insight, even for incremental work.
  5. Figures and tables are content, not decoration: clean teaser, clear pipeline figure, booktabs-style minimal-ink tables.

Workflows by request size

A. Quick polish (sentence / paragraph)

  1. Run the flow test from references/paragraph-flow.md: one message? first sentence states it? nouns self-contained? sentence-to-sentence relations explicit?
  2. Return the revised paragraph, then 1–2 lines on what changed and why.
  3. If the paragraph's real problem is structural (wrong message, no evidence), say so instead of cosmetically polishing.

B. Section draft / rewrite

  1. Confirm the section's story in a 3–7 bullet mini-outline before writing prose; on low ambiguity proceed and show the outline with the draft.
  2. Draft paragraph by paragraph — one message per paragraph, template from the section guide.
  3. Reverse-outline the result: thesis → topic sentences → evidence; fix anything that doesn't map.
  4. For Abstract/Introduction, append a claim-evidence map: Claim: ... | Evidence: ... | Status: supported / needs evidence / weakened.

C. Pre-submission review

  1. Load references/paper-review.md and read the paper as a hostile reviewer.
  2. Score the five dimensions (contribution, clarity, experimental strength, evaluation completeness, method soundness); mark each question pass / needs revision / needs new experiment.
  3. Return a prioritized fix list: rejection-level risks first, then clarity issues, then polish. Include concrete edit suggestions, not just complaints.

References

  • references/abstract.md — 3 abstract templates with annotated real examples
  • references/introduction.md — intro logic map, 4 opening / 3 challenge / 4 pipeline templates
  • references/related-work.md — topic grouping and positioning
  • references/method.md — module triad (design / motivation / advantage) workflow
  • references/experiments.md — claim→experiment planning, table/figure rules
  • references/conclusion.md — limitation framing that doesn't invite rejection
  • references/paper-review.md — adversarial five-dimension review checklist
  • references/paragraph-flow.md — paragraph clarity test, reverse outlining, transitions
  • references/pdf-export.md — compiling LaTeX/Markdown to PDF, engine choice, failure fixes, output verification
  • references/examples/ — annotated LaTeX examples cited from the section guides

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.