Agent skill

Writing Chapters

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

A skill your agent uses when writing paper chapters - requires completed brainstorming, writes one chapter at a time with user confirmation

MITAuto-check passedAgent Workflows

Install Writing Chapters

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

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

GitHub CLI
$ gh skill install Norman-bury/research-writing-skill writing-chapters --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/Norman-bury/research-writing-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/writing-chapters .claude/skills/writing-chapters && 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
writing-chapters
GitHub stars
3.4k
Token cost
~1.7k tokens
SKILL.md length
463 words
Files
1
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when writing paper chapters - requires completed brainstorming, writes one chapter at a time with user confirmation

  • Works in 3 steps: 读取项目信息 → 确认当前章节 → 调用学科模块
  • Writing paper chapters - requires completed brainstorming
  • SKILL.md covers Checklist(每章必须完成), Chapter Agent Contract, 两阶段 Review 机制 and 写作流程, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Writing Chapters is an agent skill from Norman-bury/research-writing-skill. Use when writing paper chapters - requires completed brainstorming, writes one chapter at a time with user confirmation

Its SKILL.md is about 1.7k 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 Agent Workflows, covering Brainstorming. The repository describes itself as: 科研写作助手 (Research Writing Assistant). The licence is MIT.

When your agent uses it

  • Writing paper chapters - requires completed brainstorming
  • Writes one chapter at a time with user confirmation

Example prompts

  • “/writing-chapters”

Workflow steps

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

  1. 读取项目信息
  2. 确认当前章节
  3. 调用学科模块

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 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 dot and markdown).

    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

Writing Chapters loads about 1.7k tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 463 words of instructions outside code blocks.

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

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 Norman-bury/research-writing-skill at commit 6f79595, republished under its MIT licence (© Norman-bury). 463 words, ~1,705 tokens.

Download SKILL.mdSave it as .claude/skills/writing-chapters/SKILL.md (or your agent's skills folder).
name
writing-chapters
description
Use when writing paper chapters - requires completed brainstorming, writes one chapter at a time with user confirmation

章节写作

负责论文各章节的实际写作。必须在头脑风暴完成、项目结构创建后调用。

<HARD-GATE>
调用此技能前必须满足以下条件:
1. plan/project-overview.md 存在且包含论文类型和章节结构
2. plan/outline.md 存在且已确认
3. chapters/ 目录已创建

如果任何条件不满足,必须先调用 brainstorming-research 技能。 </HARD-GATE>

<HARD-GATE>
章节写作必须先判断章节类型:
  1. Introduction、Related Work、研究背景、文献综述:必须先调用 evidence-driven-writing,并读取 refs/evidence-map.md 或 plan/evidence-map.md。
  2. Methodology、Methods、研究方法:必须按“输入到输出”的技术流写作,不能只罗列模块。
  3. Results、Discussion、实验结果:必须先调用 experiment-results-planning,确认真实数据或明确标记的 mock/synthetic planning data。

任何用户要求都不得直接进入正文。诸如“写得自然”“不要泛泛而谈”“注意衔接”只能转化为句子、段落、结构和证据处理。 </HARD-GATE>

Checklist(每章必须完成)

  • 读取 plan/outline.md 确认本章目标和要点
  • 如果存在 plan/chapter-architecture.md,确认本章文件名、最小正文长度和 agent owner
  • 检查前置章节是否完成(按逻辑顺序)
  • 与用户确认本章关键论点和内容方向
  • 根据学科领域调用对应写作模块
  • 对引言/相关工作读取 evidence-driven-writing 产物
  • 对方法章节检查输入到输出 flow
  • 执行正文污染 contamination firewall 检查
  • 写作输出到 chapters/XX-name.md
  • 阶段1:规范合规检查
  • 阶段2:质量检查(去AI化、语言流畅度)
  • 更新 plan/progress.md
  • 展示写作成果,询问用户确认或修改
  • 用户确认后,询问是否继续下一章

Chapter Agent Contract

Full-paper drafts and redrafts must use a separate fresh agent for each major chapter. The controller prepares the task packet and review criteria; the chapter agent writes only its assigned file.

Each chapter agent must receive:

  • the exact chapter file it owns;
  • the chapter's role in the whole manuscript;
  • required source files and evidence IDs;
  • paragraph-level argument chain, not a list of section labels;
  • minimum prose length from plan/chapter-architecture.md;
  • prohibited wording and prohibited structure;
  • instructions to report unresolved gaps instead of inventing evidence or results.

Each chapter agent must return:

  • status: DONE, DONE_WITH_CONCERNS, NEEDS_CONTEXT, or BLOCKED;
  • changed file path;
  • short summary of argument chain;
  • unresolved evidence/data gaps;
  • self-review against the rejection checks.

The controller must record this in plan/chapter-agent-provenance.md. A chapter without provenance is not accepted for a full-paper redraft.

两阶段 Review 机制

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

阶段1:规范合规检查

检查是否满足论文基本要求:

检查项说明
字数是否达到目标字数(±10%可接受)
结构章节结构是否完整,小节是否清晰
引用格式引用格式是否统一(GB/T 7714 或 APA)
标题层级是否符合论文规范

检查结果:✅ 通过 / ❌ 需修改

阶段2:质量检查

检查写作质量:

检查项说明
去AI化无机械过渡词、无空壳强调句
语言流畅无重复表达、无冗余
学术表达使用"本文"、"本研究"等客观表述
段落结构优先连贯段落,不使用列表堆砌
引用真实所有引用可追溯,无编造

检查结果:✅ 通过 / ❌ 需修改

写作流程

dot
digraph writing_chapters {
    "读取 outline.md" [shape=box];
    "确认本章目标" [shape=box];
    "用户确认方向?" [shape=diamond];
    "调用学科写作模块" [shape=box];
    "写作到 chapters/" [shape=box];
    "去AI化检查" [shape=box];
    "更新 progress.md" [shape=box];
    "展示成果" [shape=box];
    "用户确认?" [shape=diamond];
    "继续下一章?" [shape=diamond];
    "结束或继续" [shape=doublecircle];

    "读取 outline.md" -> "确认本章目标";
    "确认本章目标" -> "用户确认方向?";
    "用户确认方向?" -> "调用学科写作模块" [label="确认"];
    "用户确认方向?" -> "确认本章目标" [label="调整"];
    "调用学科写作模块" -> "写作到 chapters/";
    "写作到 chapters/" -> "去AI化检查";
    "去AI化检查" -> "更新 progress.md";
    "更新 progress.md" -> "展示成果";
    "展示成果" -> "用户确认?";
    "用户确认?" -> "写作到 chapters/" [label="修改"];
    "用户确认?" -> "继续下一章?" [label="确认"];
    "继续下一章?" -> "读取 outline.md" [label="是"];
    "继续下一章?" -> "结束或继续" [label="否"];
}

写作前准备

1. 读取项目信息

从 plan/ 读取:

  • project-overview.md:论文类型、学科、研究背景
  • outline.md:章节大纲和要点
  • progress.md:已完成章节
  • notes.md:用户偏好和特殊要求

参考结构模板: skills/brainstorming-research/templates.md 了解不同论文类型的标准结构。

2. 确认当前章节

"根据大纲,本章「[章节名]」的主要内容是:

  • [要点1]
  • [要点2]
  • [要点3]

请确认这些要点,或告诉我需要调整的内容:"

3. 调用学科模块
学科领域调用模块
工科、理科writing-core
文科writing-humanities
社科writing-humanities(侧重数据)
医学writing-medical
法学writing-law

写作规范

<EXTREMELY-IMPORTANT>
以下规范必须严格遵守,不得因为"效率"或"简化"而跳过。
</EXTREMELY-IMPORTANT>
Show full SKILL.md (188 more words)Show less
去 AI 化写作
  1. 禁用机械过渡词:首先、其次、最后、此外、另外、总之
  2. 禁用空壳强调句:值得注意的是、需要指出的是、重要的是、显而易见
  3. 禁用主观化表达:我认为、我觉得、我的研究(正文中)
  4. 禁用列表堆砌:论文正文优先连贯段落,不使用项目符号
  5. 语气客观:使用"本文"、"本研究"、"研究表明"等客观表述
反罗列写作

每章必须形成连续论证,而不是把要点平铺为短段落。正文段落应满足以下模式之一:

  • 背景段:场景约束 → 研究矛盾 → 本章承接。
  • 文献段:同类研究共同解决的问题 → 代表性证据 → 尚未覆盖的边界。
  • 方法段:输入对象 → 处理过程 → 输出形式 → 设计理由。
  • 实验段:评价目标 → 对照关系 → 指标含义 → 可接受结论边界。
  • 讨论段:结果含义 → 工程/学术解释 → 局限和后续验证。

禁止把这些模式写成列表。每个正文段落都要包含因果、转折、承接或限定关系。除参考文献外,正文默认不得出现项目符号;贡献点需要列表时,最多 3 条,并且必须由前后段落解释。

长度和密度

对完整论文初稿,Introduction、Methodology、Experimental Results and Analysis、Discussion 等主体章节不能只写成摘要级说明。若 plan/chapter-architecture.md 给出 min_chars,必须达到该下限。达不到时,返回 NEEDS_CONTEXT 或继续扩写,不得把短稿标记为完成。

格式规范
  1. 段落之间空一行
  2. 正文不使用加粗(除术语首次定义)
  3. 不使用斜体强调
  4. 标题层级清晰
引用规范
  1. 绝不编造文献
  2. 引用必须可追溯:作者、年份、出处至少完整两项
  3. 英文文献可检索后引用
  4. 中文文献优先让用户提供来源

章节写作模板

开始写作前的确认

"我将开始写作「[章节名]」。

本章目标:[从outline读取] 预计字数:[根据论文类型估算] 包含小节:

  • [小节1]
  • [小节2]

请确认或调整后开始写作:"

写作完成后的展示

"「[章节名]」初稿已完成。

实际字数:[字数] 主要内容:[简要总结]

已保存到:chapters/[文件名].md

请审阅以下内容:


[章节内容预览,可以是开头部分]

如需修改请告诉我具体位置和修改意见,确认无误后我将更新进度。"

更新进度

在 progress.md 中记录:

markdown
## [日期] - [章节名]

- **状态**:已完成 / 待修改
- **字数**:[字数]
- **用户确认**:是 / 否
- **修改记录**:[如有]

特殊章节指导

摘要(Abstract)
  • 留到正文全部完成后再写
  • 中文摘要 300-500 字,英文摘要对应
  • 结构:背景、目的、方法、结果、结论
  • 不含引用、不含图表
绪论(Introduction)
  • 研究背景(宏观到具体)
  • 研究问题(现有不足)
  • 研究目的和意义
  • 研究内容和方法概述
  • 论文结构安排可保留一小段,但不得用它替代研究空白论证
  • 计算机/工程 SCI 论文通常可将 Related Work 融入 Introduction;不要机械拆出独立 Related Work 章,除非大纲或模板要求
文献综述(Literature Review)
  • 调用 literature-review 技能
  • 按主题/时间/方法分类
  • 必须有批判性分析
  • 必须指出研究空白
研究方法(Methods)

方法章节必须采用输入到输出(input-to-output)flow,而不是模块清单:

  1. 输入对象:数据形态、样本、特征、约束。
  2. 预处理或表示:清洗、编码、划分、标准化。
  3. 核心模型/算法:每个模块说明输入、处理、输出、设计理由。
  4. 训练或推理流程:公式、算法、参数更新或决策路径。
  5. 输出:预测、解释、告警、指标或下游接口。
  6. 与实验的对应:每个关键模块必须能映射到消融、对照或局限说明。

禁止只写“由三层组成”“包括若干模块”后缺少数据流、公式位置和可复现步骤。

结果与讨论

结果章节不得保留“实验目的、表位、回填模板、讨论提示、请用户替换”等过程性说明。真实结果用数据支撑;mock 数据只能作为 planning data,并保留 [待真实实验替换] 标记,不能写成已验证结论。

正文污染防护

正文污染 contamination firewall 必须检查:

  1. 用户修改要求不得进入正文。
  2. 过程性说明不得进入正文或附录。
  3. 压缩不等于删空,必须保留核心论点、证据、方法条件和边界。
  4. 不能用表格替代应有的论文论证段落。
  5. 列表只能在目标期刊允许或贡献点特别清晰时使用,正文默认转成连贯段落。
结论(Conclusion)
  • 总结研究发现
  • 回应研究目的
  • 指出创新点
  • 提出未来方向

错误处理

如果 plan/ 不存在

"检测到项目结构未创建。需要先完成头脑风暴才能开始写作。

是否现在开始头脑风暴?"

调用 brainstorming-research。

如果前置章节未完成

"建议先完成「[前置章节]」再写「[当前章节]」,因为:

  • [原因]

是否要先写前置章节,还是跳过继续?"

记录用户选择到 notes.md。

如果用户要求跳过确认

"理解你想加快进度。我会简化确认流程,但仍需要你在每章完成后简单确认。

现在开始写作「[章节名]」。"

关键原则

  • 一次只写一章 — 完成并确认后再开始下一章
  • 每章必须确认 — 不得自动继续
  • 进度必须更新 — 每次写作后更新 progress.md
  • 风格必须一致 — 遵循学科模块规范
  • 引用必须真实 — 绝不编造

© 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

Just SKILL.md in skills/writing-chapters of Norman-bury/research-writing-skill.

Open the folder on GitHubat commit 6f79595

Compare with similar skills

Writing Chapters 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.

Writing Chapters compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Writing Chapters this skillNorman-bury/research-writing-skill3.4k—~1.7kAutomated safety check: PassMIT
Brainstormingobra/superpowers297k1 repos~2.5kAutomated safety check: PassMIT
Brainstormingxpinjection/test-driven-spring-boot11253 repos~2.6kAutomated safety check: PassMIT
Yao Meta Skillyaojingang/yao-meta-skill2.7k—~768Automated safety check: PassMIT
Typesafe AIOpenAgentsInc/openagents4559 repos~2.5kAutomated safety check: PassMIT
Trellis StartROYIANS/foliq-print-template-designer1366 repos~646Automated safety check: PassMIT

Similar skills

  • Brainstorming

    obra/superpowers

    Makes the agent clarify intent and agree on a design with you before writing any code, scaling the process from a quick spike to a written spec.

    297k GitHub starsUsed in 1 repo~2.5k tokens
    Agent WorkflowsAuto-check passed
  • Brainstorming

    xpinjection/test-driven-spring-boot

    You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior.

    112 GitHub starsUsed in 53 repos~2.6k tokens
    Agent WorkflowsAuto-check passed
  • Yao Meta Skill

    yaojingang/yao-meta-skill

    Create, improve, or evaluate an existing skill from workflows, prompts, SOPs, scripts.

    2.7k GitHub stars~768 tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Typesafe AI

    OpenAgentsInc/openagents

    Build AI-powered software with TypeSafe: small units of AI intelligence you can use like programming primitives.

    455 GitHub starsUsed in 9 repos~2.5k tokens
    Agent WorkflowsAuto-check passed
  • Trellis Start

    ROYIANS/foliq-print-template-designer

    Initializes an AI development session by reading workflow guides, developer identity, git status, active tasks, and project guidelines from .trellis/.

    136 GitHub starsUsed in 6 repos~646 tokens
    Agent WorkflowsAuto-check passed
  • Brainstorming Before Building

    jnMetaCode/superpowers-zh

    Turns a rough idea into an approved design before any code is written, sorting the request into spike, bounded or architectural and enforcing an approval gate.

    8.3k GitHub stars~1.8k tokensUpdated 3 days ago
    Agent WorkflowsAuto-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

Categories

Questions about Writing Chapters

What does Writing Chapters do?

A skill your agent uses when writing paper chapters - requires completed brainstorming, writes one chapter at a time with user confirmation. Writing Chapters is an agent skill from Norman-bury/research-writing-skill.

When should I use Writing Chapters?

Writing Chapters fits situations like: writing paper chapters - requires completed brainstorming; writes one chapter at a time with user confirmation.

How do I install Writing Chapters in Claude Code?

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

How do I install Writing Chapters in Codex?

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

Can I use Writing Chapters 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 writing-chapters -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/writing-chapters, .gemini/skills/writing-chapters, .github/skills/writing-chapters and .opencode/skills/writing-chapters in your project.

What does Writing Chapters need to run?

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

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

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

About 1.7k tokens (SKILL.md is roughly 6.8k 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 Writing Chapters?

Skills that share tags, products or a category with Writing Chapters: Brainstorming (obra/superpowers, 297k stars), Brainstorming (xpinjection/test-driven-spring-boot, 112 stars), Yao Meta Skill (yaojingang/yao-meta-skill, 2.7k stars) and Typesafe AI (OpenAgentsInc/openagents, 455 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Writing Chapters?

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.