Agent skill

Research Paper Writing

by Master-cai in Master-cai/Research-Paper-Writing-Skills

Rewrites and reviews ML, CV and NLP papers for clarity: one message per paragraph, reverse outlining, claim-evidence checks and a skeptical-reviewer pass.

MITAuto-check passedResearch & Science

Install Research Paper Writing

skills CLI
$ npx skills add Master-cai/Research-Paper-Writing-Skills --skill research-paper-writing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Master-cai/Research-Paper-Writing-Skills research-paper-writing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Master-cai/Research-Paper-Writing-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/research-paper-writing .claude/skills/research-paper-writing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
research-paper-writing
GitHub stars
7.4k
Token cost
~1.2k tokens
SKILL.md length
550 words
Files
40 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Rewrites and reviews ML, CV and NLP papers for clarity: one message per paragraph, reverse outlining, claim-evidence checks and a skeptical-reviewer pass.

  • Works in 6 steps: Clarify the paper story before… → Use section-specific guidance in… → Rewrite paragraph-by-paragraph with one… → …
  • Revising the abstract or introduction of a machine learning paper
  • SKILL.md covers Overview, Core Workflow, Global Principles and Paragraph Clarity Check…, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

This skill helps rewrite academic papers in the machine learning, computer vision and NLP style into drafts a reviewer can read quickly. It starts by clarifying the paper's story before any sentence edits, then rewrites paragraph by paragraph with one message each, stated in the first sentence, and runs reverse outlining after each section to confirm that topic sentences map to the thesis and evidence maps to topic sentences.

Per-section guides in a references folder cover the abstract, introduction, related work, method, experiments and conclusion, and are loaded only as needed, alongside annotated examples and templates. Visuals are treated as core content: a clean teaser and pipeline figure and minimal-ink tables. Before submission the agent checks that every major claim in the abstract and introduction is backed by experimental evidence, then reviews the paper adversarially, as a skeptical reviewer would, using a paper-review reference.

When your agent uses it

  • Revising the abstract or introduction of a machine learning paper
  • Checking whether each claim in a paper is supported by its experiments
  • Judging whether a paragraph flows and has a single clear message
  • Self-reviewing a paper before conference submission

Example prompts

  • “Rewrite my introduction so each paragraph has one message and the contributions are clear.”
  • “Check that the claims in my abstract match the experiments section.”
  • “Review this draft as a skeptical reviewer would before I submit.”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Clarify the paper story before sentence-level edits.
  2. Use section-specific guidance in references/.
  3. Rewrite paragraph-by-paragraph with one message per paragraph.
  4. Run reverse outlining after writing each section.
  5. Check every major claim in Abstract/Introduction against experimental evidence.
  6. Run final-paper adversarial review with references/paper-review.md.

What it can do on your machine

Read from SKILL.md and the folder at commit 77e7c2c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Research Paper Writing loads about 1.2k tokens when it runs, and up to ~25k if it reads all its reference files. Until then it costs about 94 tokens; SKILL.md has 550 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~94
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~25k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Master-cai/Research-Paper-Writing-Skills at commit 77e7c2c, republished under its MIT licence (© Master-cai). 550 words, ~1,209 tokens.

Download SKILL.mdSave it as .claude/skills/research-paper-writing/SKILL.md (or your agent's skills folder). This skill also uses 39 other files; get the full folder from GitHub.
name
research-paper-writing
description
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.

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

  1. Clarify the paper story before sentence-level edits.
  2. Use section-specific guidance in references/.
  3. Rewrite paragraph-by-paragraph with one message per paragraph.
  4. Run reverse outlining after writing each section.
  5. Check every major claim in Abstract/Introduction against experimental evidence.
  6. Run final-paper adversarial review with references/paper-review.md.

Global Principles

  1. Keep one paragraph for one message only.
  2. State the paragraph message in the first sentence.
  3. Make nouns self-contained; define new terms before reusing them.
  4. Maintain sentence-to-sentence flow (cause, contrast, consequence, or refinement).
  5. Iterate with adversarial self-review: read as a skeptical reviewer.
  6. Treat visual quality as core content, not decoration.
  7. Use a clean teaser and pipeline figure.
  8. Use readable, minimal-ink tables.
  9. Keep formatting consistent and tidy.

Paragraph Clarity Check (Important)

Use this quick test whenever the user asks whether a paragraph "flows" or is clear.

  1. 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)?
  2. 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.
  3. 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 Review): references/paper-review.md
  • Paragraph clarity source: references/does-my-writing-flow-source.md
  • Example bank index: references/examples/index.md
Show full SKILL.md (225 more words)Show less

Paper Review Core Points

Use references/paper-review.md for the full checklist and workflow.

  1. Add an end-of-draft self-review question list in five dimensions:
    • contribution,
    • writing clarity,
    • experimental strength,
    • evaluation completeness,
    • method design soundness.
  2. Treat claim-evidence alignment as a hard constraint, especially for Abstract and Introduction.
  3. Perform adversarial writing: review as a skeptical reviewer and resolve every high-risk question.
  4. Revise until major rejection risks are explicitly addressed.

Execution Rules

  1. Build a mini-outline before drafting prose.
  2. For each subsection, explicitly include motivation, design, and technical advantage when applicable.
  3. Avoid writing style that looks like incremental patching of a naive baseline.
  4. Keep terminology stable across the full paper.
  5. If a claim cannot be supported by results, weaken or remove the claim.
  6. Before finalizing, append and answer a five-dimension self-review question list, then revise the paper based on unresolved items.
  7. 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:

  1. A compact section outline (3-7 bullets).
  2. Revised paragraphs with explicit paragraph roles (opening/challenge/method/advantage/evidence/limitation).
  3. A short self-review checklist covering clarity, flow, terminology consistency, unsupported claims, and missing evidence.
  4. A claim-evidence map for each major claim in the revised text using Claim: ... | Evidence: ... | Status: supported/needs evidence.

© Master-cai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 39 other files (references) in research-paper-writing of Master-cai/Research-Paper-Writing-Skills.

  • SKILL.md
  • agents/openai.yaml
  • references/abstract.md
  • references/conclusion.md
  • references/does-my-writing-flow-source.md
  • references/examples/abstract-examples.md
  • references/examples/abstract/template-a.md
  • references/examples/abstract/template-b.md
  • references/examples/abstract/template-c.md
  • references/examples/index.md
  • references/examples/introduction-examples.md
  • references/examples/introduction/novel-task-challenge-decomposition.md
  • references/examples/introduction/pipeline-not-recommended-abstract-only.md
  • references/examples/introduction/pipeline-version-1-one-contribution-multi-advantages.md
  • references/examples/introduction/pipeline-version-2-two-contributions.md
  • references/examples/introduction/pipeline-version-3-new-module-on-existing-pipeline.md
  • … and 24 more

Open the folder on GitHubat commit 77e7c2c

Compare with similar skills

Research Paper Writing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Research Paper Writing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Research Paper Writing this skillMaster-cai/Research-Paper-Writing-Skills7.4k—~1.2kAutomated safety check: PassMIT
Academic Paper Writing PipelineImbad0202/academic-research-skills51k—~16kAutomated safety check: PassCustom licence
Academic Paper ReviewerImbad0202/academic-research-skills51k—~11kAutomated safety check: PassCustom licence
Academic Research PipelineImbad0202/academic-research-skills51k—~15kAutomated safety check: PassCustom licence
Benchmark Paper TemplateHKUSTDial/Supervisor-Skills8.8k—~2.8kAutomated safety check: PassCC-BY-4.0
Academic Research Suite for CodexImbad0202/academic-research-skills-codex12k—~12kAutomated safety check: PassCustom licence

Similar skills

  • Academic Paper Writing Pipeline

    Imbad0202/academic-research-skills

    Runs a 12-agent pipeline that plans, drafts, cites, reviews and formats academic papers, with modes for revision, rebuttals, abstracts and citation checks.

    51k GitHub stars~16k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Academic Paper Reviewer

    Imbad0202/academic-research-skills

    Simulates a journal peer review of a manuscript with a five-seat reviewer panel, an editorial synthesizer and several review modes.

    51k GitHub stars~11k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Academic Research Pipeline

    Imbad0202/academic-research-skills

    Orchestrates a ten-stage academic workflow from research to finished manuscript, including integrity checks, two rounds of peer review and revision.

    51k GitHub stars~15k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Benchmark Paper Template

    HKUSTDial/Supervisor-Skills

    Structures benchmark and evaluation papers around five pillars, with a completeness audit, an Introduction logic chain, a section skeleton and a pre-submission checklist.

    8.8k GitHub stars~2.8k tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed
  • Academic Research Suite for Codex

    Imbad0202/academic-research-skills-codex

    A router skill that sends academic work such as literature reviews, drafting, citation checks, peer review and revision to the right workflow in the ARS suite.

    12k GitHub stars~12k tokensUpdated 7 days ago
    Research & ScienceAuto-check passed
  • Manuscript Statistics Audit

    Yuan1z0825/nature-skills

    Audits or rewrites the statistical reporting in a manuscript: experimental units, replication, tests, uncertainty and figure legends, without inventing missing details.

    47k GitHub starsUsed in 2 repos~2.1k tokens
    Research & ScienceAuto-check passed

Questions about Research Paper Writing

What does Research Paper Writing do?

Rewrites and reviews ML, CV and NLP papers for clarity: one message per paragraph, reverse outlining, claim-evidence checks and a skeptical-reviewer pass. This skill helps rewrite academic papers in the machine learning, computer vision and NLP style into drafts a reviewer can read quickly. It starts by clarifying the paper's story before any sentence edits, then rewrites paragraph by paragraph with one message each, stated in the first sentence, and runs reverse outlining after each section to confirm that topic sentences map to the thesis and evidence maps to topic sentences.

When should I use Research Paper Writing?

Research Paper Writing fits situations like: revising the abstract or introduction of a machine learning paper; checking whether each claim in a paper is supported by its experiments; judging whether a paragraph flows and has a single clear message; self-reviewing a paper before conference submission.

How do I install Research Paper Writing in Claude Code?

Run `npx skills add Master-cai/Research-Paper-Writing-Skills --skill research-paper-writing -a claude-code`. Or copy the skill folder (research-paper-writing in Master-cai/Research-Paper-Writing-Skills) into .claude/skills/research-paper-writing in your project. Claude Code loads it when a task matches its description.

How do I install Research Paper Writing in Codex?

Run `npx skills add Master-cai/Research-Paper-Writing-Skills --skill research-paper-writing -a codex`. Or copy the skill folder (research-paper-writing in Master-cai/Research-Paper-Writing-Skills) into .agents/skills/research-paper-writing in your project. Codex loads it when a task matches its description.

Can I use Research Paper Writing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Master-cai/Research-Paper-Writing-Skills --skill research-paper-writing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/research-paper-writing, .gemini/skills/research-paper-writing, .github/skills/research-paper-writing and .opencode/skills/research-paper-writing in your project.

What does Research Paper Writing need to run?

SKILL.md names no scripts, command-line tools or credentials: Research Paper Writing is instructions for the agent only.

Does Research Paper Writing access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Research Paper Writing safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Research Paper Writing use?

Research Paper Writing is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Research Paper Writing use?

About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 24k tokens, read only when the agent opens those files.

What are the alternatives to Research Paper Writing?

Skills that share tags, products or a category with Research Paper Writing: Academic Paper Writing Pipeline (Imbad0202/academic-research-skills, 51k stars), Academic Paper Reviewer (Imbad0202/academic-research-skills, 51k stars), Academic Research Pipeline (Imbad0202/academic-research-skills, 51k stars) and Benchmark Paper Template (HKUSTDial/Supervisor-Skills, 8.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Research Paper Writing?

Master-cai (a GitHub user) maintains it in Master-cai/Research-Paper-Writing-Skills, which has 7,364 GitHub stars. The repository was last updated on June 23, 2026.

Source: Master-cai/Research-Paper-Writing-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.