Agent skill

Using Research Writing

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

A skill your agent uses when starting any research writing task - establishes workflow and routes to appropriate skills

MITAuto-check passedAgent Workflows

Install Using Research Writing

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

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

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

At a glance

A skill your agent uses when starting any research writing task - establishes workflow and routes to appropriate skills

  • Works in 3 steps: 用户明确指令(直接请求、CLAUDE.md、AGENTS.md 中的设置)—… → 科研写作技能 — 覆盖默认系统行为 → 默认系统提示 — 最低优先级
  • Starting any research writing task - establishes workflow and routes to appropriate skills
  • SKILL.md covers 指令优先级, 如何访问技能, 核心规则 and Red Flags(停止并检查), plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Using Research Writing is an agent skill from Norman-bury/research-writing-skill. Use when starting any research writing task - establishes workflow and routes to appropriate skills

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

When your agent uses it

  • Starting any research writing task - establishes workflow and routes to appropriate skills

Example prompts

  • “/using-research-writing”

Requirements

  • Python 3

Workflow steps

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

  1. 用户明确指令(直接请求、CLAUDE.md、AGENTS.md 中的设置)— 最高优先级
  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).

    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

Using Research Writing loads about 916 tokens when it runs. Until then it costs about 31 tokens; SKILL.md has 186 words of instructions outside code blocks.

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

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). 186 words, ~916 tokens.

Download SKILL.mdSave it as .claude/skills/using-research-writing/SKILL.md (or your agent's skills folder).
name
using-research-writing
description
Use when starting any research writing task - establishes workflow and routes to appropriate skills
<SUBAGENT-STOP>
如果你是作为子代理被派发执行特定任务,跳过此技能。
</SUBAGENT-STOP>
<EXTREMELY-IMPORTANT>
当用户提出任何与论文写作相关的任务时,你必须调用相应的技能。

如果你认为有哪怕 1% 的可能性某个技能适用于当前任务,你必须调用该技能。

这不是建议,是强制要求。不允许跳过流程直接写作。不允许找任何借口。 </EXTREMELY-IMPORTANT>

指令优先级

科研写作技能会覆盖默认系统提示行为,但用户指令始终优先:

  1. 用户明确指令(直接请求、CLAUDE.md、AGENTS.md 中的设置)— 最高优先级
  2. 科研写作技能 — 覆盖默认系统行为
  3. 默认系统提示 — 最低优先级

如果用户说"不需要讨论直接写",你可以简化流程,但仍需记录到 plan/。

如何访问技能

在 Claude Code 中: 使用 Skill 工具。调用技能时,其内容会被加载并呈现给你 — 直接遵循即可。

在 Cursor 中: 技能通过会话启动 hook 自动加载。使用 Skill 工具调用其他技能。

在 Codex 中: 技能通过符号链接加载。参考 .codex/INSTALL.md。

在 OpenCode 中: 使用原生 skill 工具:use skill tool to load research-writing/brainstorming-research

核心规则

在任何响应或行动之前,先调用相关技能。 即使只有 1% 的可能性某个技能适用,你也应该调用它检查。

中型或整篇论文任务必须先调用 paper-orchestration。 中型任务包括:影响多个段落、一个以上小节、任一章节、文献论证链、实验/图表设计、或任何已出现质量失败的返工任务。paper-orchestration 负责阶段判断、任务包、子代理分发、两阶段 review 与 capability-use audit(能力使用审计)。

dot
digraph skill_flow {
    "用户消息" [shape=doublecircle];
    "是否论文写作相关?" [shape=diamond];
    "是否中型/整篇任务?" [shape=diamond];
    "调用 paper-orchestration" [shape=box];
    "已完成头脑风暴?" [shape=diamond];
    "调用 brainstorming-research" [shape=box];
    "根据任务调用对应技能" [shape=box];
    "执行任务" [shape=box];
    "更新 plan/progress.md" [shape=box];
    "询问用户确认" [shape=doublecircle];

    "用户消息" -> "是否论文写作相关?";
    "是否论文写作相关?" -> "是否中型/整篇任务?" [label="是"];
    "是否论文写作相关?" -> "执行任务" [label="否,普通问题"];
    "是否中型/整篇任务?" -> "调用 paper-orchestration" [label="是"];
    "是否中型/整篇任务?" -> "已完成头脑风暴?" [label="否"];
    "调用 paper-orchestration" -> "已完成头脑风暴?";
    "已完成头脑风暴?" -> "根据任务调用对应技能" [label="是"];
    "已完成头脑风暴?" -> "调用 brainstorming-research" [label="否"];
    "调用 brainstorming-research" -> "根据任务调用对应技能";
    "根据任务调用对应技能" -> "执行任务";
    "执行任务" -> "更新 plan/progress.md";
    "更新 plan/progress.md" -> "询问用户确认";
}

Red Flags(停止并检查)

这些想法意味着你在找借口 — 停下来:

AI 的想法正确做法
"用户说得很清楚了,直接开始写"必须先完成 brainstorming-research
"这只是修改一小段"检查是否有 plan/,没有则先创建
"先写一段看看效果"必须先确认论文类型和章节结构
"用户很着急,跳过讨论"流程可以加速,但不能跳过关键确认
"这是简单任务,不需要 plan"任何写作任务都需要 plan 记录
"我知道怎么写论文"必须按用户选择的类型和结构写
"先把内容写完再说格式"格式在 brainstorming 阶段确定
"这章内容很简单,不用确认"每章写完都必须让用户确认
"文献我可以补充一些"绝不编造文献,必须可追溯
"我记得这个技能的内容"技能会更新,必须重新读取当前版本

技能路由

任务类型调用技能
中型任务 / 整篇论文 / 多章节协作 / 质量返工paper-orchestration
开始新论文 / 确定选题 / 第一次对话brainstorming-research
引言 / 相关工作 / 背景综述 / 文献驱动段落evidence-driven-writing + literature-review
写某一章节writing-chapters
文献综述literature-review
实验设计 / 结果章节 / mock 数据 / 表格方案experiment-results-planning
画图 / 数据可视化figures-python
流程图 / 架构图figures-diagram
自审 / 检查 / 投稿准备peer-review
统计分析statistical-analysis
LaTeX 输出 / 模板使用latex-output
环境配置 / 安装问题environment-setup
翻译 / 润色 / 去AI化prompts-collection

技能优先级

当多个技能可能适用时,按以下顺序:

  1. 流程技能优先(brainstorming-research)— 决定如何开始任务
  2. 实现技能其次(writing-chapters、literature-review 等)— 指导具体执行

"帮我写论文" → 先 paper-orchestration,再 brainstorming-research,再 writing-chapters "写第三章" → 检查是否已完成 brainstorming,是则直接 writing-chapters

"优化整篇初稿" → 先 paper-orchestration,生成任务包和能力使用审计,再分派章节或图表任务

技能类型

严格型(brainstorming-research、writing-chapters):必须严格遵循,不得跳过步骤。

灵活型(prompts-collection、figures-diagram):可根据上下文调整。

技能本身会说明属于哪种类型。

用户指令

用户指令说的是"做什么",不是"怎么做"。"写第一章"或"帮我润色"不代表跳过工作流。

任务收尾

中型及以上任务完成前必须写入 capability-use audit(能力使用审计),记录应使用的技能、实际使用的技能、已消费资料、未使用资料及原因、产物、验证命令和剩余风险。缺少审计时,不得声称任务完成。

© 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/using-research-writing of Norman-bury/research-writing-skill.

Open the folder on GitHubat commit 6f79595

Compare with similar skills

Using Research 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.

Using Research Writing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Using Research Writing this skillNorman-bury/research-writing-skill3.4k—~916Automated safety check: PassMIT
Business Brainstormcoreyhaines31/makerskills851—~1.7kAutomated safety check: PassMIT
Proposal AgentOpenRSI-Foundation/OpenRSI-Index207—~5.1kAutomated safety check: PassApache-2.0
Open-Science Host Inspectionaipoch/open-science5.5k—~3.8kAutomated safety check: PassApache-2.0
Idea Generationvoidful/academic-skills135—~1.6kAutomated safety check: PassMIT
Research Ideationmaxwell2732/paper-replicate-agent-demo1371 repos~914Automated safety check: PassNone

Similar skills

  • Business Brainstorm

    coreyhaines31/makerskills

    When you want to pressure-test a potential new business, product, or side project against the serial-founder filter.

    851 GitHub stars~1.7k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Proposal Agent

    OpenRSI-Foundation/OpenRSI-Index

    A skill your agent uses when a contributor wants to create, repair, or complete an OpenRSI-Index AutoResearch task proposal grounded in a remote model-development repository, including…

    207 GitHub stars~5.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Open-Science Host Inspection

    aipoch/open-science

    Teaches an agent to inspect Open-Science's JavaScript control REPL, check which host.* calls are allowed, and find project files, sessions and agent frames.

    5.5k GitHub stars~3.8k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Idea Generation

    voidful/academic-skills

    學術研究的 Idea 產生技能——從發散到收斂,系統化地產出高品質研究構想。當使用者想腦力激盪研究方向、找新 research idea、或問「我接下來可以做什麼研究」時,一定要使用此技能。觸發詞包括:brainstorm、想 idea、研究方向、下一步做什麼、有什麼可以研究的、找 gap、research proposal。適用於任何階段的學術研究構想生成。

    135 GitHub stars~1.6k tokensUpdated 6 mo ago
    Agent WorkflowsAuto-check passed
  • Research Ideation

    maxwell2732/paper-replicate-agent-demo

    Generate structured research questions, testable hypotheses, and empirical strategies from a topic or dataset

    137 GitHub starsUsed in 1 repo~914 tokens
    Agent WorkflowsAuto-check passed
  • Biomarker Multi Agent Discovery

    aws-samples/amazon-bedrock-agents-healthcare-lifesciences

    Official

    A skill your agent uses when orchestrating a multi-agent biomarker discovery workflow that requires coordinating database queries, pathway analysis, literature review, statistical modeling, and…

    274 GitHub stars~1.4k tokensUpdated 9 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

Questions about Using Research Writing

What does Using Research Writing do?

A skill your agent uses when starting any research writing task - establishes workflow and routes to appropriate skills. Using Research Writing is an agent skill from Norman-bury/research-writing-skill.

When should I use Using Research Writing?

Using Research Writing fits situations like: starting any research writing task - establishes workflow and routes to appropriate skills.

How do I install Using Research Writing in Claude Code?

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

How do I install Using Research Writing in Codex?

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

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

What does Using Research Writing need to run?

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

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

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

About 916 tokens (SKILL.md is roughly 3.7k 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 Using Research Writing?

Skills that share tags, products or a category with Using Research Writing: Business Brainstorm (coreyhaines31/makerskills, 851 stars), Proposal Agent (OpenRSI-Foundation/OpenRSI-Index, 207 stars), Open-Science Host Inspection (aipoch/open-science, 5.5k stars) and Idea Generation (voidful/academic-skills, 135 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Using Research Writing?

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.