Agent skill

Paper Writing

by ZimoLiao in ZimoLiao/scholaraio

A skill your agent uses when the user wants help drafting or revising a research paper section, including Introduction, Related Work, Method, Results, Discussion, or Conclusion.

MITAuto-check passedResearch & Science

Install Paper Writing

skills CLI
$ npx skills add ZimoLiao/scholaraio --skill paper-writing -a claude-code

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

GitHub CLI
$ gh skill install ZimoLiao/scholaraio 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/ZimoLiao/scholaraio.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/paper-writing .claude/skills/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
paper-writing
GitHub stars
577
Token cost
~845 tokens
SKILL.md length
200 words
Files
1
Skills in repo
43
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user wants help drafting or revising a research paper section, including Introduction, Related Work, Method, Results, Discussion, or Conclusion.

  • Works in 5 steps: 了解写作需求 → 论文分析笔记复用 → 各章节写作策略 → …
  • The user wants help drafting
  • SKILL.md covers 前提, 执行逻辑, 写作原则 and 投稿前自查清单, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Paper Writing is an agent skill from ZimoLiao/scholaraio. Use when the user wants help drafting or revising a research paper section, including Introduction, Related Work, Method, Results, Discussion, or Conclusion.

Its SKILL.md is about 850 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Research & Science, covering Scientific writing and Literature review. The repository describes itself as: Scholar All-In-One: A research infrastructure for AI agents. The licence is MIT.

When your agent uses it

  • The user wants help drafting
  • Revising a research paper section
  • Including Introduction

Example prompts

  • “/paper-writing”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. 了解写作需求
  2. 论文分析笔记复用
  3. 各章节写作策略
  4. 引用管理
  5. 输出

What it can do on your machine

Read from SKILL.md and the folder at commit 777628b. 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 (its code samples are bash).

    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

Paper Writing loads about 845 tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 200 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~845

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 ZimoLiao/scholaraio at commit 777628b, republished under its MIT licence (© ZimoLiao). 200 words, ~845 tokens.

Download SKILL.mdSave it as .claude/skills/paper-writing/SKILL.md (or your agent's skills folder).
name
paper-writing
description
Use when the user wants help drafting or revising a research paper section, including Introduction, Related Work, Method, Results, Discussion, or Conclusion.

论文写作辅助

协助用户撰写研究论文的各个章节,基于工作区中的文献提供引用支持。

前提

用户必须指定一个 workspace(--ws NAME)。如果用户未指定:

  1. 运行 scholaraio ws list 列出已有工作区
  2. 让用户选择或创建一个

输出写入 workspace/<name>/ 目录。

执行逻辑

1. 了解写作需求

向用户确认:

  • 写哪个章节:Introduction / Related Work / Method / Results / Discussion / Conclusion / Abstract
  • 目标期刊/会议:格式要求、篇幅限制
  • 语言:中文 / English
  • 用户已有内容:草稿、大纲、实验数据、图表
  • 风格参考(可选):用户可提供同期刊/同领域的范文,你来分析其写作风格(句式结构、术语选择、段落节奏、引用方式、形式化程度),然后仿照
2. 论文分析笔记复用

用 scholaraio show 阅读工作区论文时,已有的 notes.md 历史笔记会自动展示。有则优先复用,无需重复阅读全文。

分析完成后,必须通过 CLI 将新的关键发现写入笔记:

bash
scholaraio show "<paper-id>" --append-notes "## YYYY-MM-DD | <workspace> | paper-writing
- 关键发现"
3. 各章节写作策略
Introduction
  1. 从宏观背景切入,逐步聚焦到具体问题
  2. 引用工作区论文建立研究脉络:
    bash
    scholaraio ws search <name> "<背景关键词>"
    scholaraio show <paper-id> --layer 2      # 摘要
  3. 明确指出现有工作的不足(research gap)
  4. 阐述本文贡献

本质上是聚焦版的文献综述,参考 /literature-review skill 的方法,但更紧凑:

  • 按与本文的关系分组(而非按主题),每组指出与本文的异同
  • 明确本文相对于 prior work 的改进
Method
  1. 用户描述方法,你协助组织成清晰的叙述
  2. 从工作区论文中找到可对比的方法:
    bash
    scholaraio ws search <name> "<方法关键词>"
    scholaraio show <paper-id> --layer 4      # 读全文了解方法细节
  3. 确保符号定义一致、公式推导完整
  4. 公式与图表:读取参考论文中的数学推导(LaTeX)和方法示意图(images/),对比本文方法的异同,确保描述准确
Results / Discussion
  1. 用户提供实验数据/图表
  2. 从工作区中检索可对比的基线结果:
    bash
    scholaraio ws search <name> "<实验条件>"
    scholaraio show <paper-id> --layer 3      # 结论
  3. 读图对比:读取参考论文中的结果图表(configured papers library 下的 <dir>/images/),与用户的实验结果做定性/定量对比
  4. 编写代码验证:用 Python 做数据分析、统计检验、可视化——用计算结果支撑 Discussion 中的论点
  5. Results:客观描述发现,引用图表
  6. Discussion:解释原因、对比文献、讨论局限性
Conclusion
  • 总结主要发现(不引入新内容)
  • 简述局限性和未来方向
Abstract
  • 最后写(需要全文定稿后)
  • 包含:背景一句、问题一句、方法一句、主要结果两句、意义一句
  • 字数严格遵循目标期刊要求
4. 引用管理
  • 正文引用格式与目标期刊一致(通常 \cite{key} 或 (Author, Year))
  • 所有引用必须来自工作区中的真实论文,绝不编造引用
  • 如发现工作区缺少需要引用的论文,提醒用户补充:
    bash
    scholaraio usearch "<关键词>"              # 全库搜索候选
    scholaraio ws add <name> <paper-id>        # 添加到工作区
  • 最终导出:
    bash
    scholaraio ws export <name> -o workspace/<name>/references.bib
5. 输出
  • 每完成一节保存到 workspace/<name>/ 下(如 introduction.md、related-work.md)
  • 或按用户要求合并为完整论文文件

写作原则

  • 引用诚实:只引用工作区中实际存在的论文。如果某个论点需要引用但库中没有对应文献,标注 [CITATION NEEDED] 而非编造。AI 生成文本中约 40% 的引用可能是幻觉——必须用 /citation-check 验证
  • 如有风格参考:分析范文的句式长度、主被动语态比例、术语密度、段落结构,严格仿照
  • 避免 AI 痕迹:不用 "it is worth noting"、"in recent years, ... has garnered significant attention" 等套话;用具体、精确的学术表达
  • 数据驱动:Results 和 Discussion 中的每个断言都应有数据或引用支撑
  • 计算验证:当论文涉及数值结果或数学推导时,编写 Python 代码独立验证,不盲信手算或直觉

投稿前自查清单

完成全文后,按以下 6 项逐一检查:

  1. 结构完整性:各章节是否齐全?逻辑链条是否连贯?Introduction 提出的问题是否在 Conclusion 中回应?
  2. 引用一致性:正文引用与参考文献列表是否一一对应?有无遗漏或多余?用 /citation-check 验证
  3. 图表质量:每个图表是否在正文中被引用?图例是否清晰?坐标轴标签是否完整?
  4. 数据可复现:方法描述是否足够详细?关键参数是否都列出?
  5. 语言质量:术语是否全文一致?时态是否正确?用 /writing-polish 做最终润色
  6. 格式合规:是否满足目标期刊的字数、图片、参考文献格式要求?

示例

用户说:"帮我写 Introduction,工作区是 my-paper" → 扫描 ws show my-paper,了解论文方向,询问研究问题,起草 Introduction

用户说:"帮我按这篇 JFM 论文的风格写 Related Work" → 分析用户提供的范文风格,按该风格组织 Related Work

用户说:"我有实验数据,帮我写 Results 和 Discussion" → 读取数据,检索工作区中的对比文献,撰写结果分析

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

Files

Just SKILL.md in .claude/skills/paper-writing of ZimoLiao/scholaraio.

Open the folder on GitHubat commit 777628b

Compare with similar skills

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.

Paper Writing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Paper Writing this skillZimoLiao/scholaraio577—~845Automated safety check: PassMIT
Academic Paper Writing PipelineImbad0202/academic-research-skills51k—~16kAutomated safety check: PassCustom licence
Academic Research PipelineImbad0202/academic-research-skills51k—~15kAutomated safety check: PassCustom licence
Academic Research Suite for CodexImbad0202/academic-research-skills-codex12k—~12kAutomated safety check: PassCustom licence
Econ Writehanlulong/econ-writing-skill6512 repos~14kAutomated safety check: PassMIT
Autonomous Researchfedericodeponte/opendraft507—~8.2kAutomated safety check: PassApache-2.0

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 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
  • 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
  • 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.

    651 GitHub starsUsed in 2 repos~14k tokens
    Research & ScienceAuto-check passed
  • Autonomous Research

    federicodeponte/opendraft

    An 18-agent pipeline that turns one topic line into a drafted research paper, literature review, or thesis chapter.

    507 GitHub stars~8.2k tokensUpdated 9 days ago
    Research & ScienceAuto-check passed
  • Social Science Paper Writing

    fakerqwq/social-science-paper-writing-skill

    Helps draft, diagnose, review and revise social science papers, from topic and research question to literature review, citation risks and pre-submission checks.

    382 GitHub stars~7k tokensUpdated 4 mo ago
    Research & ScienceAuto-check passed

More from ZimoLiao/scholaraio

All 43 skills in this repo
  • Document

    ZimoLiao/scholaraio

    A skill your agent uses when the user wants to create or inspect DOCX, PPTX, or XLSX files, generate a downloadable Office deliverable, or verify its structure and layout warnings with scholaraio…

    577 GitHub stars~674 tokensUpdated 15 days ago
    Auto-check passed
  • Academic Writing

    ZimoLiao/scholaraio

    A skill your agent uses when the user needs help choosing or organizing an academic-writing workflow by deliverable, stage, or format, including review articles, guided reading, paper sections, PPT…

    577 GitHub stars~827 tokensUpdated 15 days ago
    Auto-check passed
  • Arxiv

    ZimoLiao/scholaraio

    A skill your agent uses when the user wants to browse arXiv preprints, search arXiv directly, fetch a PDF by arXiv ID or URL, or send a preprint into the ScholarAIO ingest pipeline.

    577 GitHub stars~799 tokensUpdated 15 days ago
    Auto-check passed
  • Bioinformatics

    ZimoLiao/scholaraio

    A skill your agent uses when working on bioinformatics workflows such as alignment, variant calling, phylogenetics, or protein-structure analysis, especially across BLAST, minimap2, samtools…

    577 GitHub stars~1.4k tokensUpdated 15 days ago
    Auto-check passed
  • Citation Check

    ZimoLiao/scholaraio

    A skill your agent uses when the user wants to verify citations in AI-generated or human-written text against the local knowledge base and catch hallucinated, wrong, or missing references.

    577 GitHub stars~454 tokensUpdated 15 days ago
    Auto-check passed
  • Draw

    ZimoLiao/scholaraio

    A skill your agent uses when the user wants diagrams, flowcharts, architecture visuals, data relationships, timelines, concept maps, Mermaid, Graphviz, drawio, or polished paper figures generated…

    577 GitHub stars~1.3k tokensUpdated 15 days ago
    Auto-check: notes

Questions about Paper Writing

What does Paper Writing do?

A skill your agent uses when the user wants help drafting or revising a research paper section, including Introduction, Related Work, Method, Results, Discussion, or Conclusion. Paper Writing is an agent skill from ZimoLiao/scholaraio. Use when the user wants help drafting or revising a research paper section, including Introduction, Related Work, Method, Results, Discussion, or Conclusion.

When should I use Paper Writing?

Paper Writing fits situations like: the user wants help drafting; revising a research paper section; including Introduction.

How do I install Paper Writing in Claude Code?

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

How do I install Paper Writing in Codex?

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

Can I use 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 ZimoLiao/scholaraio --skill 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/paper-writing, .gemini/skills/paper-writing, .github/skills/paper-writing and .opencode/skills/paper-writing in your project.

What does Paper Writing need to run?

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

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

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 Paper Writing use?

About 845 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Paper Writing?

Skills that share tags, products or a category with Paper Writing: Academic Paper Writing Pipeline (Imbad0202/academic-research-skills, 51k stars), Academic Research Pipeline (Imbad0202/academic-research-skills, 51k stars), Academic Research Suite for Codex (Imbad0202/academic-research-skills-codex, 12k stars) and Econ Write (hanlulong/econ-writing-skill, 651 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Paper Writing?

ZimoLiao (a GitHub user) maintains it in ZimoLiao/scholaraio, which has 577 GitHub stars. The repository holds 43 skills in this directory. The repository was last updated on September 25, 2026.

Source: ZimoLiao/scholaraio on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.