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.
A skill your agent uses when writing paper chapters - requires completed brainstorming, writes one chapter at a time with user confirmation
$ npx skills add Norman-bury/research-writing-skill --skill writing-chapters -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Norman-bury/research-writing-skill writing-chapters --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ 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-srcUse ~/.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/
Install the "writing-chapters" agent skill from https://github.com/Norman-bury/research-writing-skill/tree/main/skills/writing-chapters into .claude/skills/writing-chapters/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "writing-chapters", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Norman-bury/research-writing-skill/tree/main/skills/writing-chaptersType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Norman-bury/research-writing-skill --skill writing-chapters -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Norman-bury/research-writing-skill writing-chapters --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Norman-bury/research-writing-skill.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/writing-chapters .agents/skills/writing-chapters && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "writing-chapters" agent skill from https://github.com/Norman-bury/research-writing-skill/tree/main/skills/writing-chapters into .agents/skills/writing-chapters/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "writing-chapters", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Norman-bury/research-writing-skill --skill writing-chapters -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Norman-bury/research-writing-skill writing-chapters --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Norman-bury/research-writing-skill.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/writing-chapters .cursor/skills/writing-chapters && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "writing-chapters" agent skill from https://github.com/Norman-bury/research-writing-skill/tree/main/skills/writing-chapters into .cursor/skills/writing-chapters/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "writing-chapters", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Norman-bury/research-writing-skill.git --path skills/writing-chapters--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Norman-bury/research-writing-skill --skill writing-chapters -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Norman-bury/research-writing-skill writing-chapters --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Norman-bury/research-writing-skill.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/writing-chapters .gemini/skills/writing-chapters && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "writing-chapters" agent skill from https://github.com/Norman-bury/research-writing-skill/tree/main/skills/writing-chapters into .gemini/skills/writing-chapters/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "writing-chapters", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Norman-bury/research-writing-skill writing-chaptersInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Norman-bury/research-writing-skill --skill writing-chapters -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Norman-bury/research-writing-skill.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/writing-chapters .github/skills/writing-chapters && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "writing-chapters" agent skill from https://github.com/Norman-bury/research-writing-skill/tree/main/skills/writing-chapters into .github/skills/writing-chapters/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "writing-chapters", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Norman-bury/research-writing-skill --skill writing-chapters -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Norman-bury/research-writing-skill writing-chapters --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Norman-bury/research-writing-skill.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/writing-chapters .opencode/skills/writing-chapters && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "writing-chapters" agent skill from https://github.com/Norman-bury/research-writing-skill/tree/main/skills/writing-chapters into .opencode/skills/writing-chapters/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "writing-chapters", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
writing-chaptersA 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. 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.
3 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 6f79595. It shows what the files ask for, not the result of running them.
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.
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.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
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.
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.
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.
The full file from Norman-bury/research-writing-skill at commit 6f79595, republished under its MIT licence (© Norman-bury). 463 words, ~1,705 tokens.
.claude/skills/writing-chapters/SKILL.md (or your agent's skills folder).负责论文各章节的实际写作。必须在头脑风暴完成、项目结构创建后调用。
<HARD-GATE>
调用此技能前必须满足以下条件:
1. plan/project-overview.md 存在且包含论文类型和章节结构
2. plan/outline.md 存在且已确认
3. chapters/ 目录已创建
如果任何条件不满足,必须先调用 brainstorming-research 技能。
</HARD-GATE>
<HARD-GATE>
章节写作必须先判断章节类型:
evidence-driven-writing,并读取 refs/evidence-map.md 或 plan/evidence-map.md。experiment-results-planning,确认真实数据或明确标记的 mock/synthetic planning data。任何用户要求都不得直接进入正文。诸如“写得自然”“不要泛泛而谈”“注意衔接”只能转化为句子、段落、结构和证据处理。
</HARD-GATE>
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:
plan/chapter-architecture.md;Each chapter agent must return:
The controller must record this in plan/chapter-agent-provenance.md. A chapter without provenance is not accepted for a full-paper redraft.
每章写作完成后,必须执行两阶段检查:
检查是否满足论文基本要求:
| 检查项 | 说明 |
|---|---|
| 字数 | 是否达到目标字数(±10%可接受) |
| 结构 | 章节结构是否完整,小节是否清晰 |
| 引用格式 | 引用格式是否统一(GB/T 7714 或 APA) |
| 标题层级 | 是否符合论文规范 |
检查结果:✅ 通过 / ❌ 需修改
检查写作质量:
| 检查项 | 说明 |
|---|---|
| 去AI化 | 无机械过渡词、无空壳强调句 |
| 语言流畅 | 无重复表达、无冗余 |
| 学术表达 | 使用"本文"、"本研究"等客观表述 |
| 段落结构 | 优先连贯段落,不使用列表堆砌 |
| 引用真实 | 所有引用可追溯,无编造 |
检查结果:✅ 通过 / ❌ 需修改
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="否"];
}从 plan/ 读取:
参考结构模板: skills/brainstorming-research/templates.md 了解不同论文类型的标准结构。
"根据大纲,本章「[章节名]」的主要内容是:
- [要点1]
- [要点2]
- [要点3]
请确认这些要点,或告诉我需要调整的内容:"
| 学科领域 | 调用模块 |
|---|---|
| 工科、理科 | writing-core |
| 文科 | writing-humanities |
| 社科 | writing-humanities(侧重数据) |
| 医学 | writing-medical |
| 法学 | writing-law |
<EXTREMELY-IMPORTANT>
以下规范必须严格遵守,不得因为"效率"或"简化"而跳过。
</EXTREMELY-IMPORTANT>
每章必须形成连续论证,而不是把要点平铺为短段落。正文段落应满足以下模式之一:
禁止把这些模式写成列表。每个正文段落都要包含因果、转折、承接或限定关系。除参考文献外,正文默认不得出现项目符号;贡献点需要列表时,最多 3 条,并且必须由前后段落解释。
对完整论文初稿,Introduction、Methodology、Experimental Results and Analysis、Discussion 等主体章节不能只写成摘要级说明。若 plan/chapter-architecture.md 给出 min_chars,必须达到该下限。达不到时,返回 NEEDS_CONTEXT 或继续扩写,不得把短稿标记为完成。
"我将开始写作「[章节名]」。
本章目标:[从outline读取] 预计字数:[根据论文类型估算] 包含小节:
- [小节1]
- [小节2]
请确认或调整后开始写作:"
"「[章节名]」初稿已完成。
实际字数:[字数] 主要内容:[简要总结]
已保存到:chapters/[文件名].md
请审阅以下内容:
[章节内容预览,可以是开头部分]
如需修改请告诉我具体位置和修改意见,确认无误后我将更新进度。"
在 progress.md 中记录:
## [日期] - [章节名]
- **状态**:已完成 / 待修改
- **字数**:[字数]
- **用户确认**:是 / 否
- **修改记录**:[如有]方法章节必须采用输入到输出(input-to-output)flow,而不是模块清单:
禁止只写“由三层组成”“包括若干模块”后缺少数据流、公式位置和可复现步骤。
结果章节不得保留“实验目的、表位、回填模板、讨论提示、请用户替换”等过程性说明。真实结果用数据支撑;mock 数据只能作为 planning data,并保留 [待真实实验替换] 标记,不能写成已验证结论。
正文污染 contamination firewall 必须检查:
"检测到项目结构未创建。需要先完成头脑风暴才能开始写作。
是否现在开始头脑风暴?"
调用 brainstorming-research。
"建议先完成「[前置章节]」再写「[当前章节]」,因为:
- [原因]
是否要先写前置章节,还是跳过继续?"
记录用户选择到 notes.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
Just SKILL.md in skills/writing-chapters of Norman-bury/research-writing-skill.
Open the folder on GitHubat commit 6f79595
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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Writing Chapters this skillNorman-bury/research-writing-skill | 3.4k | — | ~1.7k | Automated safety check: Pass | MIT | |
| Brainstormingobra/superpowers | 297k | 1 repos | ~2.5k | Automated safety check: Pass | MIT | |
| Brainstormingxpinjection/test-driven-spring-boot | 112 | 53 repos | ~2.6k | Automated safety check: Pass | MIT | |
| Yao Meta Skillyaojingang/yao-meta-skill | 2.7k | — | ~768 | Automated safety check: Pass | MIT | |
| Typesafe AIOpenAgentsInc/openagents | 455 | 9 repos | ~2.5k | Automated safety check: Pass | MIT | |
| Trellis StartROYIANS/foliq-print-template-designer | 136 | 6 repos | ~646 | Automated safety check: Pass | MIT |
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.
xpinjection/test-driven-spring-boot
You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior.
yaojingang/yao-meta-skill
Create, improve, or evaluate an existing skill from workflows, prompts, SOPs, scripts.
OpenAgentsInc/openagents
Build AI-powered software with TypeSafe: small units of AI intelligence you can use like programming primitives.
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/.
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.
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
Norman-bury/research-writing-skill
A skill your agent uses when Python environment setup is needed for data visualization or conda installation is required
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
Norman-bury/research-writing-skill
A skill your agent uses when creating flowcharts, architecture diagrams, or conceptual diagrams - generates prompts for image AI
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
Norman-bury/research-writing-skill
A skill your agent uses when user requests LaTeX format output or has provided school/journal LaTeX templates
Categories
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.
Writing Chapters fits situations like: writing paper chapters - requires completed brainstorming; writes one chapter at a time with user confirmation.
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.
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.
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.
SKILL.md names no scripts, command-line tools or credentials: Writing Chapters is instructions for the agent only.
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.
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.
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.
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.
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.
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.