Agent skill

Research Writing Skill

by zLanqing in zLanqing/codex-claude-academic-skills

Chinese-first research paper writing, revision, polishing, section drafting, rebuttal, peer-review response, thesis prose improvement, and manuscript argument planning.

MITAuto-check passedResearch & Science

Install Research Writing Skill

skills CLI
$ npx skills add zLanqing/codex-claude-academic-skills --skill research-writing-skill -a claude-code

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

GitHub CLI
$ gh skill install zLanqing/codex-claude-academic-skills research-writing-skill --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/zLanqing/codex-claude-academic-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/research-writing-skill .claude/skills/research-writing-skill && 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-writing-skill
GitHub stars
4.7k
Token cost
~1.1k tokens
SKILL.md length
447 words
Files
22 (incl. references)
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

Chinese-first research paper writing, revision, polishing, section drafting, rebuttal, peer-review response, thesis prose improvement, and manuscript argument planning.

  • Works in 6 steps: Clarify target:… → Identify source material: paper notes,… → Build an argument outline before full… → …
  • The user asks to write
  • SKILL.md covers Scope, Writing Principles, Manuscript Workflow and Section Guides, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Research Writing Skill is an agent skill from zLanqing/codex-claude-academic-skills. Chinese-first research paper writing, revision, polishing, section drafting, rebuttal, peer-review response, thesis prose improvement, and manuscript argument planning. Use when the user asks to write or revise论文正文, abstracts, introductions, methods, results, discussion, conclusions, related work, responses to reviewers, LaTeX/Overleaf text, or academic prose. Preserve formulas, English paper titles, terms, citations, and measured results.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 27 other files, including reference files (for example `agents/openai.yaml`, `references/paper-writing/author_profile/compression_patterns.md` and `references/paper-writing/author_profile/editorial_principles.md`).

It sits in Research & Science, covering LaTeX, Skill authoring and Literature review. It works with LaTeX. The repository describes itself as: 本仓库包含三个面向学术科研人员的Skills,覆盖从文献阅读、论文写作到科学计算的完整研究工作流。office-academic-skill 负责论文阅读报告与学术 PPT/Word 文档生成;research-writing-skill 提供论文写作、润色与审稿回复辅助;scientific-toolkit-skill 整合 MATLAB/Python… The licence is MIT.

When your agent uses it

  • The user asks to write
  • Responses to reviewers
  • LaTeX/Overleaf text

Example prompts

  • “/research-writing-skill”

Requirements

  • Python 3

Workflow steps

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

  1. Clarify target: journal/conference/thesis/course report, language, length, audience, and required format.
  2. Identify source material: paper notes, experiment results, figures, tables, MATLAB/Python outputs, references, advisor comments.
  3. Build an argument outline before full prose: problem, gap, method, evidence, contribution, limitation.
  4. Draft in coherent paragraphs, not empty slogan bullets.
  5. Add source or evidence labels for quantitative claims and literature claims.
  6. Revise for logic, specificity, terminology consistency, and citation accuracy.

What it can do on your machine

Read from SKILL.md and the folder at commit 7ed6377. 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 Writing Skill loads about 1.1k tokens when it runs, and up to ~31k if it reads all its reference files. Until then it costs about 117 tokens; SKILL.md has 447 words of instructions outside code blocks.

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

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 zLanqing/codex-claude-academic-skills at commit 7ed6377, republished under its MIT licence (© zLanqing). 447 words, ~1,057 tokens.

Download SKILL.mdSave it as .claude/skills/research-writing-skill/SKILL.md (or your agent's skills folder). This skill also uses 21 other files; get the full folder from GitHub.
name
research-writing-skill
description
Chinese-first research paper writing, revision, polishing, section drafting, rebuttal, peer-review response, thesis prose improvement, and manuscript argument planning. Use when the user asks to write or revise论文正文, abstracts, introductions, methods, results, discussion, conclusions, related work, responses to reviewers, LaTeX/Overleaf text, or academic prose. Preserve formulas, English paper titles, terms, citations, and measured results.

Research Writing Skill

Scope

Use this skill for research writing and revision when the output is prose, LaTeX, Markdown, or manuscript text. Use office-academic-skill instead when the main deliverable is Word/PPT. Use scientific-toolkit-skill when the task is primarily MATLAB, Python, plotting, statistics, simulation, or literature search.

Writing Principles

  • Default to Chinese academic expression unless the user requests English.
  • Preserve English titles, formulas, variables, methods, software names, citations, and reference entries.
  • Do not invent data, DOI, journal details, experiment settings, results, or author claims.
  • Separate 原文/已有数据, 用户确认内容, 根据上下文推断, and 建议性扩展.
  • Prefer verifiable technical statements over generic claims.
  • When revising, preserve the user's intended meaning and terminology unless a change is clearly needed.

Manuscript Workflow

For a new section or paper draft:

  1. Clarify target: journal/conference/thesis/course report, language, length, audience, and required format.
  2. Identify source material: paper notes, experiment results, figures, tables, MATLAB/Python outputs, references, advisor comments.
  3. Build an argument outline before full prose: problem, gap, method, evidence, contribution, limitation.
  4. Draft in coherent paragraphs, not empty slogan bullets.
  5. Add source or evidence labels for quantitative claims and literature claims.
  6. Revise for logic, specificity, terminology consistency, and citation accuracy.

For revision or polishing:

  • Keep claims tied to evidence.
  • Replace vague words such as "显著", "先进", "有效", "鲁棒" with measured conditions, comparison baselines, or remove them.
  • Check whether each paragraph advances the section's purpose.
  • Keep formulas with variable definitions, units, assumptions, and applicable conditions.
  • For experimental sections, state dataset/sample, hardware/software, parameters, metrics, baselines, and uncertainty when available.
Show full SKILL.md (199 more words)Show less

Section Guides

Use these default moves unless the user's school or journal template overrides them:

  • Abstract: problem, method, experiment/data, key result, contribution.
  • Introduction: background, unresolved gap, why it matters, proposed approach, contributions.
  • Related work: organize by technical theme, compare assumptions and limitations, avoid simple paper-by-paper summaries.
  • Methods: model assumptions, variables, workflow, algorithm, implementation details needed for reproduction.
  • Experiments: data/source, platform/software, parameters, metrics, baseline, repeated trials, visualization plan.
  • Results and discussion: claim first, evidence second, mechanism/explanation third, limitation last.
  • Conclusion: answer the research question, summarize evidence, state limitations and next steps.

Bundled References

The folder references/paper-writing/ contains external writing checklists and section patterns adapted as references. Load only the relevant file when needed:

  • brainstorming_guide.md for turning an unclear idea into a paper plan.
  • section_rhetorical_moves/ for section structure.
  • writing_checklists/ for self-diagnosis.
  • figure_templates/ for figure planning.
  • author_profile/ for editorial heuristics.

These references come from an external systems/networking-oriented repository. Treat them as optional craft guidance, not binding rules, and adapt them to光电信息科学与工程, optics, optoelectronics, sensing, communication, signal processing, and MATLAB simulation work.

Final Checks

Before delivery, state:

  • What was drafted or revised.
  • Which source material was used.
  • Which claims still need user-provided data or citation support.
  • Any uncertainty about terminology, parameters, or references.

© zLanqing, 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 21 other files (references) in research-writing-skill of zLanqing/codex-claude-academic-skills.

  • SKILL.md
  • agents/openai.yaml
  • references/paper-writing/author_profile/compression_patterns.md
  • references/paper-writing/author_profile/editorial_principles.md
  • references/paper-writing/author_profile/intervention_types.md
  • references/paper-writing/author_profile/rhetorical_moves.md
  • references/paper-writing/author_profile/voice_profile.md
  • references/paper-writing/brainstorming_guide.md
  • references/paper-writing/figure_synthesis_guide.md
  • references/paper-writing/figure_templates/figure_spec_template.md
  • references/paper-writing/figure_templates/prompt_templates.md
  • references/paper-writing/figure_templates/tikz_skeletons.md
  • references/paper-writing/figure_templates/venue_styles.md
  • references/paper-writing/section_rhetorical_moves/design.md
  • references/paper-writing/section_rhetorical_moves/evaluation.md
  • … and 7 more

Open the folder on GitHubat commit 7ed6377

Compare with similar skills

Research Writing Skill 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 Writing Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Research Writing Skill this skillzLanqing/codex-claude-academic-skills4.7k—~1.1kAutomated safety check: PassMIT
Academic Paper Writing PipelineImbad0202/academic-research-skills51k—~16kAutomated safety check: PassCustom licence
Econ Writehanlulong/econ-writing-skill6472 repos~14kAutomated safety check: PassMIT
Paper Auditbrycewang-stanford/Auto-Empirical-Research-Skills4.5k—~3.6kAutomated safety check: PassCustom licence
01 Paper Reviewagentscope-ai/OpenJudge870—~2.4kAutomated safety check: PassApache-2.0
Check Review AlignmentInternScience/DrClaw172—~1.5kAutomated safety check: PassNone

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 today
    Research & ScienceAuto-check passed
  • Econ Write

    hanlulong/econ-writing-skill

    Expert economics paper writing assistant synthesizing advice from 50+ top guides by Cochrane, McCloskey, Shapiro, Head, Bellemare, Goldin, Glaeser, Kremer, and other leading economists.

    647 GitHub starsUsed in 2 repos~14k tokens
    Research & ScienceAuto-check passed
  • Paper Audit

    brycewang-stanford/Auto-Empirical-Research-Skills

    Deep-review-first audit for Chinese and English academic papers across LaTeX, Typst, and PDF formats.

    4.5k GitHub stars~3.6k tokensUpdated 4 days ago
    Documents & OfficeAuto-check passed
  • 01 Paper Review

    agentscope-ai/OpenJudge

    Review academic papers for correctness, quality, and novelty using OpenJudge's multi-stage pipeline.

    870 GitHub stars~2.4k tokensUpdated 28 days ago
    Research & ScienceAuto-check passed
  • Check Review Alignment

    InternScience/DrClaw

    当用户明确要求"核查/优化综述 {主题}review.tex 的正文引用"或"运行 check-review-alignment"时使用。通过宿主 AI 的语义理解逐条核查引用是否与文献内容吻合,只在发现致命性引用错误时对"包含引用的句子"做最小化改写,并复用 systematic-literature-review 的渲染脚本输出…

    172 GitHub stars~1.5k tokensUpdated 6 mo ago
    Research & ScienceAuto-check passed
  • Run a referee-grade review of the manuscript in the open project without changing a single manuscript file.

    209 GitHub stars~2.3k tokensUpdated today
    Research & ScienceAuto-check passed

More from zLanqing/codex-claude-academic-skills

All 17 skills in this repo
  • Matplotlib

    zLanqing/codex-claude-academic-skills

    Low-level plotting library for full customization. An agent skill from zLanqing/codex-claude-academic-skills.

    4.7k GitHub starsUsed in 17 repos~2.9k tokens
    Auto-check passed
  • Scikit Learn

    zLanqing/codex-claude-academic-skills

    Machine learning in Python with scikit-learn. An agent skill from zLanqing/codex-claude-academic-skills.

    4.7k GitHub starsUsed in 16 repos~3.9k tokens
    Auto-check passed
  • Simpy

    zLanqing/codex-claude-academic-skills

    Process-based discrete-event simulation framework in Python.

    4.7k GitHub starsUsed in 11 repos~3k tokens
    Auto-check passed
  • Networkx

    zLanqing/codex-claude-academic-skills

    Comprehensive toolkit for creating, analyzing, and visualizing complex networks and graphs in Python.

    4.7k GitHub starsUsed in 15 repos~3.2k tokens
    Auto-check passed
  • Seaborn

    zLanqing/codex-claude-academic-skills

    Statistical visualization with pandas integration. An agent skill from zLanqing/codex-claude-academic-skills.

    4.7k GitHub starsUsed in 15 repos~4.9k tokens
    Auto-check passed
  • Statsmodels

    zLanqing/codex-claude-academic-skills

    Statistical models library for Python. An agent skill from zLanqing/codex-claude-academic-skills.

    4.7k GitHub starsUsed in 15 repos~4.9k tokens
    Auto-check passed

Works with

Questions about Research Writing Skill

What does Research Writing Skill do?

Chinese-first research paper writing, revision, polishing, section drafting, rebuttal, peer-review response, thesis prose improvement, and manuscript argument planning. Research Writing Skill is an agent skill from zLanqing/codex-claude-academic-skills. Chinese-first research paper writing, revision, polishing, section drafting, rebuttal, peer-review response, thesis prose improvement, and manuscript argument planning.

When should I use Research Writing Skill?

Research Writing Skill fits situations like: the user asks to write; responses to reviewers; laTeX/Overleaf text.

How do I install Research Writing Skill in Claude Code?

Run `npx skills add zLanqing/codex-claude-academic-skills --skill research-writing-skill -a claude-code`. Or copy the skill folder (research-writing-skill in zLanqing/codex-claude-academic-skills) into .claude/skills/research-writing-skill in your project. Claude Code loads it when a task matches its description.

How do I install Research Writing Skill in Codex?

Run `npx skills add zLanqing/codex-claude-academic-skills --skill research-writing-skill -a codex`. Or copy the skill folder (research-writing-skill in zLanqing/codex-claude-academic-skills) into .agents/skills/research-writing-skill in your project. Codex loads it when a task matches its description.

Can I use Research Writing Skill 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 zLanqing/codex-claude-academic-skills --skill research-writing-skill -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-writing-skill, .gemini/skills/research-writing-skill, .github/skills/research-writing-skill and .opencode/skills/research-writing-skill in your project.

What does Research Writing Skill need to run?

SKILL.md names no scripts, command-line tools or credentials: Research Writing Skill is instructions for the agent only. Our summary lists: Python 3.

Does Research Writing Skill 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 Writing Skill 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 Writing Skill use?

Research Writing Skill 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 Writing Skill use?

About 1.1k tokens (SKILL.md is roughly 4.2k 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 30k tokens, read only when the agent opens those files.

What are the alternatives to Research Writing Skill?

Skills that share tags, products or a category with Research Writing Skill: Academic Paper Writing Pipeline (Imbad0202/academic-research-skills, 51k stars), Econ Write (hanlulong/econ-writing-skill, 647 stars), Paper Audit (brycewang-stanford/Auto-Empirical-Research-Skills, 4.5k stars) and 01 Paper Review (agentscope-ai/OpenJudge, 870 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Research Writing Skill?

zLanqing (a GitHub user) maintains it in zLanqing/codex-claude-academic-skills, which has 4,671 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on May 14, 2026.

Source: zLanqing/codex-claude-academic-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.