research-paper-writing
Skill4 starsChanged 6 months agoMITView on GitHub
Improve academic paper writing quality for ML/CV/NLP-style papers with clear section structure, paragraph flow, and reviewer-facing presentation. Use when drafting or revising Abstract, Introduction, Related Work, Method, Experiments, or Conclusion; polishing figures/tables; checking claim-support alignment; or performing self-review before submission.
28 other projects use a version of this, 5 of them edited.
Adopted by
Most recently taken up by
- ashleysbrain/skillstheir own version, first seen Nov 8, 2026
- delorenj/skillstheir own version, first seen Nov 7, 2026
- ethosagent/ethostheir own version, first seen Nov 3, 2026
- Gavin-Tao/claude-skillsword for word, first seen Nov 2, 2026
- yuiseki/GeoAI-master-skillstheir own version, first seen Nov 1, 2026
- a-attia/scicomp-research-skillsedited, first seen Nov 1, 2026
Used with
Projects with it also use handoff.
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.
MicrosoftSkillhandoff
Compact the current conversation into a handoff document for another agent to pick up.
Also in 3 projects that use this
Other versions28 projects use a version of this.
Word for word · 3
- ZeyuLing/research_autocode_skills★ 9100% same
- tuoxie2046/claude-code-research-skills★ 5100% same
- Gavin-Tao/claude-skills★ 3100% same
Edited · 5
- Master-cai/Research-Paper-Writing-Skills★ 6.5k99% same
- sii-research/SocioVerse2★ 1493% same
- a-attia/scicomp-research-skills★ 1353% same
- talhaMah56/claude_skills★ 099% same
- yunyancuo/keresearch★ 099% same
Wrote their own version · 20
- Tommy-yw/RunbookHermes★ 546same name
- aivrar/portable-hermes-agent★ 239same name
- RedWoodOG/Hermes-Desktop★ 177same name
- pcdp577/evidence-grounded-manuscript-skills★ 53same name
- ethosagent/ethos★ 22same name
- delorenj/skills★ 17same name
- Samin12/skills★ 8same name
- yuiseki/GeoAI-master-skills★ 3same name
- 0mlkrizzz655335v/claude-skills-zh★ 2same name
- john-data-chen/hermes-agent-backup★ 2same name
10 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository37 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- adaptSkill
- animateSkill
- arrangeSkill
- auditSkill
- bolderSkill
- clarifySkill
- code-refactorSkill
- colorizeSkill
- critiqueSkill
- delightSkill
- distillSkill
- extractSkill
- frontend-designSkill
- gitlab-integrationSkill
- git-operationsSkill
- hardenSkill
- industrial-ai-researchSkill
- latex-paper-enSkill
- latex-thesis-zhSkill
- mermaid-diagramsSkill
- normalizeSkill
- onboardSkill
- optimizeSkill
- overdriveSkill
- paper-auditSkill
- polishSkill
- pydanticSkill
- python-best-practicesSkill
- python-docsSkill
- pytorch-lightningSkill
- quieterSkill
- remotion-best-practicesSkill
- skill-creatorSkill
- teach-impeccableSkill
- typesetSkill
- typst-paperSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
27 rules. 0 are common, 22 are distinctive, and 5 are very specific to this project.
0
Common
Most of the 23 edited versions we read keep these.
22
Distinctive
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 9
Use this skill to rewrite a research paper into a reviewer-friendly, high-clarity draft.
- Very specific: line 15
Use section-specific guidance in references/.
- Distinctive: line 17
Run reverse outlining after writing each section.
- Distinctive: line 18
Check every major claim in Abstract/Introduction against experimental evidence.
- Very specific: line 19
Run final-paper adversarial review with references/paper-review.md.
- Distinctive: line 23
Keep one paragraph for one message only.
- Distinctive: line 28
Treat visual quality as core content, not decoration.
- Distinctive: line 29
Use a clean teaser and pipeline figure.
- Distinctive: line 30
Use readable, minimal-ink tables.
- Distinctive: line 31
Keep formatting consistent and tidy.
- Distinctive: line 35
Use this quick test whenever the user asks whether a paragraph "flows" or is clear.
- Distinctive: line 37
Read as an external reader:
- Distinctive: line 42
Run reverse outlining for the current section:
- Distinctive: line 43
Write down thesis/main claim.
- Distinctive: line 44
Write down each paragraph topic sentence.
- Distinctive: line 45
Write down the evidence/explanation points under each paragraph.
- Distinctive: line 46
Check mapping: topic sentence -> thesis, and evidence -> topic sentence.
- Distinctive: line 48
If flow is still weak, add temporary section headers and explicit transition phrases during revision, then remove unnecessary headers …
- Very specific: line 70
Use references/paper-review.md for the full checklist and workflow.
- Distinctive: line 72
Add an end-of-draft self-review question list in five dimensions:
- Distinctive: line 78
Treat claim-evidence alignment as a hard constraint, especially for Abstract and Introduction.
- Distinctive: line 86
Avoid writing style that looks like incremental patching of a naive baseline.
- Distinctive: line 87
Keep terminology stable across the full paper.
- Distinctive: line 88
If a claim cannot be supported by results, weaken or remove the claim.
- Distinctive: line 89
Before finalizing, append and answer a five-dimension self-review question list, then revise the paper based on unresolved items.
- Very specific: line 90
Do not load all section references (Introduction/Abstract/Related Work/Method/Experiments/Conclusion) at once.
- Distinctive: line 94
When asked to rewrite or draft sections, return:
“Common” is measured: kept by at least 6 in 10 of the 23 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.
Files
Research Paper Writing
Overview
Use this skill to rewrite a research paper into a reviewer-friendly, high-clarity draft. Prioritize first-impression quality (figures/tables/layout), logical flow, and evidence-backed claims.
Core Workflow
- Clarify the paper story before sentence-level edits.
- Use section-specific guidance in
references/. - Rewrite paragraph-by-paragraph with one message per paragraph.
- Run reverse outlining after writing each section.
- Check every major claim in Abstract/Introduction against experimental evidence.
- Run final-paper adversarial review with
references/paper-review.md.
Global Principles
- Keep one paragraph for one message only.
- State the paragraph message in the first sentence.
- Make nouns self-contained; define new terms before reusing them.
- Maintain sentence-to-sentence flow (cause, contrast, consequence, or refinement).
- Iterate with adversarial self-review: read as a skeptical reviewer.
- Treat visual quality as core content, not decoration.
- Use a clean teaser and pipeline figure.
- Use readable, minimal-ink tables.
- Keep formatting consistent and tidy.
Paragraph Clarity Check (Important)
Use this quick test whenever the user asks whether a paragraph "flows" or is clear.
- Read as an external reader:
- Does this paragraph have one explicit message?
- Does the first sentence state what this paragraph will do?
- Are all key nouns/terms readable without hidden context?
- Does each sentence connect to the previous one with a clear relation (cause, contrast, consequence, refinement, example)?
- Run reverse outlining for the current section:
- Write down thesis/main claim.
- Write down each paragraph topic sentence.
- Write down the evidence/explanation points under each paragraph.
- Check mapping: topic sentence -> thesis, and evidence -> topic sentence.
- Revise or remove any paragraph that cannot be mapped cleanly.
- If flow is still weak, add temporary section headers and explicit transition phrases during revision, then remove unnecessary headers before finalizing.
Source reference for this check:
references/does-my-writing-flow-source.md
Section Guides
Load only the needed section file:
- Introduction:
references/introduction.md - Abstract:
references/abstract.md - Related Work:
references/related-work.md - Method:
references/method.md - Experiments:
references/experiments.md - Conclusion:
references/conclusion.md - Paper review (Paper Rview):
references/paper-review.md - Paragraph clarity source:
references/does-my-writing-flow-source.md - Example bank index:
references/examples/index.md
Paper Review Core Points
Use references/paper-review.md for the full checklist and workflow.
- Add an end-of-draft self-review question list in five dimensions:
- contribution,
- writing clarity,
- experimental strength,
- evaluation completeness,
- method design soundness.
- Treat claim-evidence alignment as a hard constraint, especially for Abstract and Introduction.
- Perform adversarial writing: review as a skeptical reviewer and resolve every high-risk question.
- Revise until major rejection risks are explicitly addressed.
Execution Rules
- Build a mini-outline before drafting prose.
- For each subsection, explicitly include motivation, design, and technical advantage when applicable.
- Avoid writing style that looks like incremental patching of a naive baseline.
- Keep terminology stable across the full paper.
- If a claim cannot be supported by results, weaken or remove the claim.
- Before finalizing, append and answer a five-dimension self-review question list, then revise the paper based on unresolved items.
- Do not load all section references (Introduction/Abstract/Related Work/Method/Experiments/Conclusion) at once; load only the specific section guide needed for the current edit target.
Output Contract
When asked to rewrite or draft sections, return:
- A compact section outline (3-7 bullets).
- Revised paragraphs with explicit paragraph roles (opening/challenge/method/advantage/evidence/limitation).
- A short self-review checklist covering clarity, flow, terminology consistency, unsupported claims, and missing evidence.
- A claim-evidence map for each major claim in the revised text using
Claim: ... | Evidence: ... | Status: supported/needs evidence.
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
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.

