Agent skill

Research Writing Assistant

by Norman-bury in Norman-bury/research-writing-skill

A skill your agent uses when writing academic papers, theses, or research articles - supports brainstorming, chapter writing, literature review, and LaTeX output

MITAuto-check: notesResearch & Science

Install Research Writing Assistant

skills CLI
$ npx skills add Norman-bury/research-writing-skill --skill research-writing-assistant -a claude-code

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

GitHub CLI
$ gh skill install Norman-bury/research-writing-skill research-writing-assistant --agent claude-code

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

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

Facts

Skill name
research-writing-assistant
GitHub stars
3.4k
Token cost
~1.3k tokens
SKILL.md length
349 words
Files
61 (incl. scripts)
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when writing academic papers, theses, or research articles - supports brainstorming, chapter writing, literature review, and LaTeX output

  • Works in 6 steps: 入口路由 → 调用 using-research-writing → 中型任务编排 → 调用 paper-orchestration → 头脑风暴 → 调用 brainstorming-research → …
  • Writing academic papers
  • SKILL.md covers 哲学原则, 新架构(v3.0), 技能列表 and Red Flags(停止并检查), plus 6 more sections
  • Research articles - supports brainstorming

What it does

Research Writing Assistant is an agent skill from Norman-bury/research-writing-skill. Use when writing academic papers, theses, or research articles - supports brainstorming, chapter writing, literature review, and LaTeX output

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 65 other files, including scripts (for example `.claude-plugin/plugin.json`, `.codex/INSTALL.md` and `.cursor-plugin/plugin.json`).

It sits in Research & Science, covering Brainstorming, LaTeX and Literature review. It works with LaTeX and Python. The repository describes itself as: 科研写作助手 (Research Writing Assistant). The licence is MIT.

When your agent uses it

  • Writing academic papers
  • Research articles - supports brainstorming
  • Chapter writing
  • Literature review

Example prompts

  • “/research-writing-assistant”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Bash, WebSearch

Workflow steps

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

  1. 入口路由 → 调用 using-research-writing
  2. 中型任务编排 → 调用 paper-orchestration
  3. 头脑风暴 → 调用 brainstorming-research
  4. 章节写作 → 调用 writing-chapters
  5. LaTeX 输出(可选)→ 调用 latex-output
  6. 两阶段 Review(每章完成后)

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Bash
    • WebSearch

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    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 Assistant loads about 1.3k tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 349 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Edit, Bash, WebSearch

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); the scripts in this folder are not scanned.

SKILL.md

The full file from Norman-bury/research-writing-skill at commit 6f79595, republished under its MIT licence (© Norman-bury). 349 words, ~1,272 tokens.

Download SKILL.mdSave it as .claude/skills/research-writing-assistant/SKILL.md (or your agent's skills folder). This skill also uses 60 other files; get the full folder from GitHub.
name
research-writing-assistant
description
Use when writing academic papers, theses, or research articles - supports brainstorming, chapter writing, literature review, and LaTeX output
allowed-tools
Read, Write, Edit, Bash, WebSearch

科研写作助手 (Research Writing Assistant)

面向本科与研究生论文写作的执行型 Skill。

哲学原则

  • 流程优于即兴 — 头脑风暴先行,结构确认再写作
  • 证据优于声称 — 引用可追溯,绝不编造文献
  • 简洁优于复杂 — 去AI化写作,拒绝机械表达
  • 确认优于假设 — 每章用户确认,避免返工

新架构(v3.0)

本 Skill 已升级为模块化技能架构,支持多平台:

平台配置
Claude Code.claude-plugin/plugin.json
Cursor.cursor-plugin/plugin.json
Codex.codex/INSTALL.md
OpenCode.opencode/INSTALL.md
Gemini CLIGEMINI.md

技能列表

核心流程技能
技能路径说明
using-research-writingskills/using-research-writing/入口技能,规则和路由
paper-orchestrationskills/paper-orchestration/中型/整篇任务编排
brainstorming-researchskills/brainstorming-research/头脑风暴,7轮问答
writing-chaptersskills/writing-chapters/章节写作
latex-outputskills/latex-output/LaTeX 输出
写作支持技能
技能路径说明
writing-coreskills/writing-core/核心写作规范
writing-humanitiesskills/writing-humanities/文科写作
writing-medicalskills/writing-medical/医学写作
writing-lawskills/writing-law/法学写作
literature-reviewskills/literature-review/文献综述
evidence-driven-writingskills/evidence-driven-writing/文献驱动引言/相关工作
experiment-results-planningskills/experiment-results-planning/实验、结果和 mock 数据规划
工具技能
技能路径说明
verificationskills/verification/验证机制,确保完成声称有证据
figures-pythonskills/figures-python/Python 数据图表
figures-diagramskills/figures-diagram/流程图/架构图
peer-reviewskills/peer-review/自审检查
statistical-analysisskills/statistical-analysis/统计分析
prompts-collectionskills/prompts-collection/提示词集合
environment-setupskills/environment-setup/环境配置

Red Flags(停止并检查)

流程类 Red Flags
AI的想法正确做法
"用户说得很清楚了,直接开始写"必须先完成 brainstorming-research
"这只是修改一小段"检查是否有 plan/,没有则先创建
"先写一段看看效果"必须先确认论文类型和章节结构
"用户很着急,跳过讨论"流程可以加速,但不能跳过关键确认
"这是简单任务,不需要 plan"任何写作任务都需要 plan 记录
"我知道怎么写论文"必须按用户选择的类型和结构写
"先把内容写完再说格式"格式在 brainstorming 阶段确定
"这章内容很简单,不用确认"每章写完都必须让用户确认
文献类 Red Flags
AI的想法正确做法
"文献我可以补充一些"绝不编造文献,必须可追溯
"我记得这个技能的内容"技能会更新,必须重新读取当前版本
"这个引用看起来很合理"没有来源的引用一律不写
"用户应该知道这个领域"不假设用户知识,问清楚再写
验证类 Red Flags(来自 verification 技能)
AI的想法正确做法
"应该写完了"运行验证命令确认
"章节看起来完整"执行字数统计和结构检查
"引用应该是真的"调用 CrossRef API 或搜索验证
"格式应该没问题"运行格式检查脚本
"搜索完成"检查结果数量和 DOI 列表
"我很确信"确信 ≠ 证据,运行验证
"就这一次跳过验证"没有例外
<EXTREMELY-IMPORTANT>
任何论文写作任务开始前,必须先调用 `skills/using-research-writing/` 确定流程。
不允许跳过头脑风暴直接写作。
</EXTREMELY-IMPORTANT>
标准流程
  1. 入口路由 → 调用 using-research-writing

    • 中型/整篇任务先转入 paper-orchestration
    • 简单章节任务继续检查 plan/ 与章节状态
  2. 中型任务编排 → 调用 paper-orchestration

    • 多章节、文献驱动、实验图表或质量返工任务必须先生成任务包
    • 完成后记录 capability-use audit(能力使用审计)
  3. 头脑风暴 → 调用 brainstorming-research

    • 确认论文类型(7种)
    • 确认学科领域
    • 确认题目、研究背景、方法
    • 确认章节结构
    • 检测 LaTeX 模板
    • 创建 plan/ 和 chapters/
  4. 章节写作 → 调用 writing-chapters

    • 每章独立文件
    • 两阶段 Review(见下方)
    • 用户确认后继续
  5. LaTeX 输出(可选)→ 调用 latex-output

    • 用户提供模板
    • 输出 .tex 文件
    • 可直接编译
  6. 两阶段 Review(每章完成后)

    • 阶段一:规范合规 — 检查字数、结构、引用格式是否满足要求
    • 阶段二:质量检查 — 检查去AI化、语言流畅度、学术表达

模块兼容(向后兼容)

两阶段 Review 机制

每章写作完成后,执行两阶段检查:

阶段一:规范合规检查

  • 字数是否符合要求
  • 章节结构是否完整
  • 引用格式是否正确
  • 小节标题是否清晰

阶段二:质量检查

  • 去 AI 化:无机械过渡词、无空壳强调句
  • 语言流畅:无重复表达、无冗余
  • 学术表达:使用"本文"、"本研究"等客观表述
  • 段落结构:优先连贯段落,不使用列表堆砌

模块兼容(向后兼容)

原有 modules/ 目录仍然保留,可通过以下方式使用:

场景模块
通用写作modules/writing-core.md
文科写作modules/writing-humanities.md
医学写作modules/writing-medical.md
法学写作modules/writing-law.md
文献综述modules/literature-review.md
文献驱动写作skills/evidence-driven-writing/
论文工作流编排skills/paper-orchestration/
实验结果规划skills/experiment-results-planning/
翻译润色modules/prompts-collection.md
自审检查modules/peer-review.md
Python图表modules/figures-python.md
流程图modules/figures-diagram.md
环境配置modules/environment-setup.md
LaTeX指南modules/latex-guide.md

输出规范

去 AI 化
  • 禁用机械过渡词:首先、其次、最后、此外
  • 禁用空壳强调句:值得注意的是、需要指出的是
  • 语气客观,使用"本文"、"本研究"
格式规范
  • 段落之间空一行
  • 正文不使用加粗
  • 论文正文优先连贯段落,不使用列表堆砌
引用规范
  • 绝不编造文献
  • 引用必须可追溯

文献与事实规则

  1. 绝不编造文献。
  2. 英文文献可检索后引用,中文文献优先让用户提供来源。
  3. 任何引用必须可追溯(作者、年份、出处至少完整两项)。

版本信息

  • 版本:3.1.0
  • 更新日期:2026-05-10
  • 维护目标:可执行、可追踪、流程化、多平台适配
v3.1 更新内容
  1. 哲学原则 — 明确核心价值观
  2. CSO优化 — 所有技能 description 使用 "Use when..." 格式
  3. 增强 Red Flags — 从10条扩展到12条
  4. 两阶段 Review — 规范合规 + 质量检查
  5. 语言默认规则 — 毕业论文默认中文,期刊根据要求
  6. 结构模板 — 7种论文类型的默认结构模板
  7. 交互优化 — 让用户少做选择,多做确认

© Norman-bury, 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 60 other files (scripts) in the repository root of Norman-bury/research-writing-skill.

  • SKILL.md
  • .claude-plugin/plugin.json
  • .codex/INSTALL.md
  • .cursor-plugin/plugin.json
  • .gitattributes
  • .gitignore
  • .opencode/INSTALL.md
  • AGENTS.md
  • CHANGELOG.md
  • CLAUDE.md
  • GEMINI.md
  • LICENSE
  • README.md
  • README_EN.md
  • hooks/hooks-cursor.json
  • hooks/hooks.json
  • … and 45 more

Open the folder on GitHubat commit 6f79595

Compare with similar skills

Research Writing Assistant 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 Assistant compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Research Writing Assistant this skillNorman-bury/research-writing-skill3.4k—~1.3kAutomated safety check: NotesMIT
Research Depth ControlBingHanOfUESTC/open_agent_team106—~989Automated safety check: PassMIT
Arxiv MCP Serverblazickjp/arxiv-mcp-server3.2k—~353Automated safety check: PassApache-2.0
Arxiv Paper Writeryunshenwuchuxun/latex-paper-skills267—~3.2kAutomated safety check: PassMIT
Research SurveyEvoScientist/EvoSkills4783 repos~2.5kAutomated safety check: PassApache-2.0
Research Writing SkillzLanqing/codex-claude-academic-skills4.7k—~1.1kAutomated safety check: PassMIT

Similar skills

  • Research Depth Control

    BingHanOfUESTC/open_agent_team

    A skill your agent uses when autoresearchteam needs deeper literature coverage, more citations in paper writing, stronger related-work synthesis, or a gate that prevents shallow research from…

    106 GitHub stars~989 tokensUpdated 3 mo ago
    Research & ScienceAuto-check passed
  • Arxiv MCP Server

    blazickjp/arxiv-mcp-server

    A skill your agent uses when finding, comparing, reading, or monitoring arXiv papers, including requests for abstracts, citation graphs, original LaTeX, section-level technical details, or…

    3.2k GitHub stars~353 tokensUpdated 3 days ago
    Research & ScienceAuto-check passed
  • Arxiv Paper Writer

    yunshenwuchuxun/latex-paper-skills

    Writes ML/AI review and survey papers for arXiv using the IEEEtran LaTeX template with verified BibTeX citations.

    267 GitHub stars~3.2k tokensUpdated 6 mo ago
    Research & ScienceAuto-check passed
  • Research Survey

    EvoScientist/EvoSkills

    Generates structured literature survey reports from collected papers using a multi-stage pipeline: outline generation (query-type adaptive) → draft survey → section-by-section expansion → summary…

    478 GitHub starsUsed in 3 repos~2.5k tokens
    Research & ScienceAuto-check passed
  • Research Writing Skill

    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.

    4.7k GitHub stars~1.1k tokensUpdated 5 mo ago
    Research & ScienceAuto-check passed
  • 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

More from Norman-bury/research-writing-skill

All 20 skills in this repo
  • Evidence Driven Writing

    Norman-bury/research-writing-skill

    A skill your agent uses when writing or revising Introduction, Related Work, background, literature synthesis, or any section where references must drive claims

    3.4k GitHub stars~952 tokensUpdated 4 mo ago
    Auto-check passed
  • Environment Setup

    Norman-bury/research-writing-skill

    A skill your agent uses when Python environment setup is needed for data visualization or conda installation is required

    3.4k GitHub stars~840 tokensUpdated 4 mo ago
    Auto-check passed
  • Experiment Results Planning

    Norman-bury/research-writing-skill

    A skill your agent uses when designing experiments, result tables, mock planning data, evaluation protocols, or results sections before real data are final

    3.4k GitHub stars~990 tokensUpdated 4 mo ago
    Auto-check passed
  • Figures Diagram

    Norman-bury/research-writing-skill

    A skill your agent uses when creating flowcharts, architecture diagrams, or conceptual diagrams - generates prompts for image AI

    3.4k GitHub stars~548 tokensUpdated 4 mo ago
    Auto-check passed
  • Figures Python

    Norman-bury/research-writing-skill

    A skill your agent uses when creating data visualizations for papers - generates publication-quality plots with top-journal color schemes

    3.4k GitHub stars~1.2k tokensUpdated 4 mo ago
    Auto-check passed
  • Latex Output

    Norman-bury/research-writing-skill

    A skill your agent uses when user requests LaTeX format output or has provided school/journal LaTeX templates

    3.4k GitHub stars~977 tokensUpdated 4 mo ago
    Auto-check passed

Works with

Questions about Research Writing Assistant

What does Research Writing Assistant do?

A skill your agent uses when writing academic papers, theses, or research articles - supports brainstorming, chapter writing, literature review, and LaTeX output. Research Writing Assistant is an agent skill from Norman-bury/research-writing-skill.

When should I use Research Writing Assistant?

Research Writing Assistant fits situations like: writing academic papers; research articles - supports brainstorming; chapter writing; literature review.

How do I install Research Writing Assistant in Claude Code?

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

How do I install Research Writing Assistant in Codex?

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

Can I use Research Writing Assistant 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 Norman-bury/research-writing-skill --skill research-writing-assistant -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-assistant, .gemini/skills/research-writing-assistant, .github/skills/research-writing-assistant and .opencode/skills/research-writing-assistant in your project.

What does Research Writing Assistant need to run?

SKILL.md names no scripts, command-line tools or credentials: Research Writing Assistant is instructions for the agent only. Our summary lists: Python 3. Its frontmatter pre-approves these tools: Read, Write, Edit, Bash, WebSearch.

Does Research Writing Assistant 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 Assistant safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Research Writing Assistant use?

Research Writing Assistant is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Research Writing Assistant use?

About 1.3k tokens (SKILL.md is roughly 5.1k 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 Research Writing Assistant?

Skills that share tags, products or a category with Research Writing Assistant: Research Depth Control (BingHanOfUESTC/open_agent_team, 106 stars), Arxiv MCP Server (blazickjp/arxiv-mcp-server, 3.2k stars), Arxiv Paper Writer (yunshenwuchuxun/latex-paper-skills, 267 stars) and Research Survey (EvoScientist/EvoSkills, 478 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Research Writing Assistant?

Norman-bury (a GitHub user) maintains it in Norman-bury/research-writing-skill, which has 3,384 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on June 10, 2026.

Source: Norman-bury/research-writing-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.