Research Paper Writing

master-cai/research-paper-writing-skills/research-paper-writing

by master-cai77e7c2c1ba06No license7.3K starsListed Oct 9, 2026Updated Oct 9, 2026Repository updated 3 months ago

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.

AI-generated overview

Guides revision of ML/CV/NLP research papers for clearer structure, flow, and reviewer-facing presentation.

What it does
This skill provides section-by-section guidance for drafting and revising academic papers, covering the Abstract, Introduction, Related Work, Method, Experiments, and Conclusion. It supplies paragraph clarity checks, reverse outlining, example banks, and a paper-review checklist. When rewriting sections it returns a compact outline, revised paragraphs with explicit roles, a self-review checklist, and a claim-evidence map.
When to use it
Use it when drafting or revising sections of an ML/CV/NLP-style paper, polishing figures and tables, checking that claims match experimental evidence, or running a self-review before submission.
Requirements
No scripts or packages; it is instructions plus reference markdown files that the agent reads. No credentials or network access are needed.

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

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.

Source and attribution

Source:master-cai/research-paper-writing-skillsinresearch-paper-writingat commit77e7c2c

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Research Paper Writing · research-paper-writing Agent Skill | SourceWeft