Agent skill

Novel Write

by Xiaoyangy in Xiaoyangy/novel-studio

用一句创作需求驱动 novel-studio 走可恢复 pipeline 完整创作(写作→评审→重写→导出)。触发:「帮我写本小说」「按这个设定写」「跑一次创作」,已有明确创作要求且希望无人值守端到端产出章节时使用。

Apache-2.0Auto-check passedWriting & Content

Install Novel Write

skills CLI
$ npx skills add Xiaoyangy/novel-studio --skill novel-write -a claude-code

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

GitHub CLI
$ gh skill install Xiaoyangy/novel-studio novel-write --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/Xiaoyangy/novel-studio.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/novel-write .claude/skills/novel-write && 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
novel-write
GitHub stars
131
Token cost
~441 tokens
SKILL.md length
80 words
Files
3
Skills in repo
18
Repo updated
First seen
Licence
Apache-2.0

At a glance

用一句创作需求驱动 novel-studio 走可恢复 pipeline 完整创作(写作→评审→重写→导出)。触发:「帮我写本小说」「按这个设定写」「跑一次创作」,已有明确创作要求且希望无人值守端到端产出章节时使用。

  • Tasks that involve Creative writing and fiction
  • SKILL.md covers 前置条件, 执行, 参数 and 产物, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Novel Write is an agent skill from Xiaoyangy/novel-studio. 用一句创作需求驱动 novel-studio 走可恢复 pipeline 完整创作(写作→评审→重写→导出)。触发:「帮我写本小说」「按这个设定写」「跑一次创作」,已有明确创作要求且希望无人值守端到端产出章节时使用。

Its SKILL.md is about 440 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `CONTEXT.md` and `context.json`).

It sits in Writing & Content, covering Creative writing and fiction. The repository describes itself as: 开源、本地优先的 AI 长篇小说创作引擎:多智能体世界推演、按弧规划、RAG 长程记忆、逐章审核与断点恢复 | Open-source AI novel generator for long-form fiction. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Creative writing and fiction

Example prompts

  • “/novel-write”

What it can do on your machine

Read from SKILL.md and the folder at commit ed04a10. 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

Novel Write loads about 441 tokens when it runs. Until then it costs about 30 tokens; SKILL.md has 80 words of instructions outside code blocks.

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

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 Xiaoyangy/novel-studio at commit ed04a10, republished under its Apache-2.0 licence (© Xiaoyangy). 80 words, ~441 tokens.

Download SKILL.mdSave it as .claude/skills/novel-write/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
novel-write
description
用一句创作需求驱动 novel-studio 走可恢复 pipeline 完整创作(写作→评审→重写→导出)。触发:「帮我写本小说」「按这个设定写」「跑一次创作」,已有明确创作要求且希望无人值守端到端产出章节时使用。

novel-write:单句需求跑一次 pipeline 创作

把用户的创作要求作为 prompt 交给 novel-studio --pipeline,由 pipeline 编排写作、评审、 重写和导出。章节落盘到 output/novel/chapters/*.md。无 TTY,可在 CI / 远程 agent 中运行。

--headless --prompt 只保留为兼容别名,命令层会转入 pipeline。新任务一律直接调用 --pipeline,不要绕过流水线。

前置条件

  • 已完成首次配置(见 skills/README.md)。headless 不支持首次引导。

执行

bash
# 直接传文本
novel-studio --pipeline --prompt "写一个赛博朋克背景、主角是义体黑客的长篇开篇"

# 从文件读 prompt(长需求/含换行时推荐)
novel-studio --pipeline --prompt-file ./requirement.md

# 从 stdin 读
echo "需求文本" | novel-studio --pipeline --prompt-file -

参数

参数说明
--prompt <text>单句创作需求;与 --prompt-file 互斥
--prompt-file <path>从文件读需求,- 表示 stdin
--stages <list>可选,默认 write,review,rewrite,deliver
--config <path>可选,指定配置文件

产物

  • 章节:output/novel/chapters/*.md
  • 写法资产:output/novel/meta/writing_assets.json(可编辑、复用、由弧摘要持续沉淀)
  • 人工感写法参考:内置 assets/references/human-feel-craft.md 会随 reference_pack.references.human_feel_craft 注入,迁移《同桌是只假装高冷的猫》的物件回扣、主观误判、短对话和现实支架,避免正文只靠解释和模板情绪推进。
  • reference-library 写作技巧总纲:内置 assets/references/refer-writing-techniques-digest.md 会随 reference_pack.references.writing_techniques_digest 注入,来自 data/reference-library/writing-craft 19 篇逐篇提炼,约束全书设计、大纲、人物、单章目标/阻力/代价/新增信息、事件余波和中文标点功能。
  • 本书世界:output/novel/book_world.json(地图、地点、路线、势力图谱)
  • 资源账本:output/novel/meta/resource_ledger.json(已入账事实与待确认提案分离)
  • RAG trace:output/novel/meta/rag/retrieval_trace.jsonl(召回命中原因)
  • 运行日志:项目目录下 headless.log

失败排查

  • 报「首次启动需要先在交互终端运行一次 novel-studio 完成配置引导」→ 先在交互终端跑一次 novel-studio 完成 stdin 配置,或手写 ~/.novel-studio/config.json。

© Xiaoyangy, Apache-2.0. 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 2 other files in skills/novel-write of Xiaoyangy/novel-studio.

  • SKILL.md
  • CONTEXT.md
  • context.json

Open the folder on GitHubat commit ed04a10

Compare with similar skills

Novel Write 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.

Novel Write compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Novel Write this skillXiaoyangy/novel-studio131—~441Automated safety check: PassApache-2.0
Story Multi-Perspective Reviewzenstory-ai/oh-story-claudecode7.4k3 repos~3kAutomated safety check: PassMIT
Story Toolbox Routerzenstory-ai/oh-story-claudecode7.4k1 repos~1.7kAutomated safety check: PassMIT
Short Web Fiction Trend Scanzenstory-ai/oh-story-claudecode7.4k3 repos~1.2kAutomated safety check: PassMIT
InkOS Creative HarnessNarcooo/inkos10k1 repos~1.1kAutomated safety check: PassAGPL-3.0
Novel Arteternityspring/shuohao-skills4.2k—~1.1kAutomated safety check: NotesApache-2.0

Similar skills

  • Story Multi-Perspective Review

    zenstory-ai/oh-story-claudecode

    Reviews Chinese web-novel text with several reviewer agents in parallel, falling back to a single-agent pass, and reports structure, character, prose and setting problems with fixes.

    7.4k GitHub starsUsed in 3 repos~3k tokens
    Writing & ContentAuto-check passed
  • Story Toolbox Router

    zenstory-ai/oh-story-claudecode

    Routes a Chinese web-novel writing request to the matching tool in a 13-skill toolbox, covers author habit memory, and can launch a local dashboard for browsing a project.

    7.4k GitHub starsUsed in 1 repo~1.7k tokens
    Writing & ContentAuto-check passed
  • Short Web Fiction Trend Scan

    zenstory-ai/oh-story-claudecode

    Scans popular short web-fiction rankings on Chinese platforms such as Dianzhong and Heiyan to surface trending emotional hooks, themes and topic candidates with an expiry warning.

    7.4k GitHub starsUsed in 3 repos~1.2k tokens
    Writing & ContentAuto-check passed
  • Drives long-form fiction, scripts, storyboards, interactive films and long-document translation through InkOS, with every change made by a typed action.

    10k GitHub starsUsed in 1 repo~1.1k tokens
    Writing & ContentAuto-check passed
  • Novel Art

    eternityspring/shuohao-skills

    给 AI 短剧出美术设定集(场景 + 叙事道具):场景的设计意图、一致性锚点、光照时段变体、 空景提示词;道具的戏剧功能、状态变体、尺度参照、白底无手提示词。

    4.2k GitHub stars~1.1k tokensUpdated 12 days ago
    Writing & ContentAuto-check: notes
  • Web Novel AI-Trace Remover

    zenstory-ai/oh-story-claudecode

    Rewrites AI-sounding Chinese web novel text so it reads naturally, changing as little as possible and keeping plot, names and numbers intact.

    7.4k GitHub starsUsed in 2 repos~2.6k tokens
    Writing & ContentAuto-check passed

More from Xiaoyangy/novel-studio

All 18 skills in this repo
  • Story Long Write

    Xiaoyangy/novel-studio

    长篇网文写作方法论与 novel-studio pipeline 适配器。用于把长篇开书、大纲、日更、续写、重写等需求整理为 pipeline 输入;在 novel-studio 内禁止直接生成正文。触发方式:/story-long-write、/写长篇、「帮我开书」「写大纲」「日更」「续写」「继续写」「修改第X章」「回炉」「重写第X章」。

    131 GitHub stars~9k tokensUpdated 15 days ago
    Auto-check passed
  • Story Short Write

    Xiaoyangy/novel-studio

    短篇网文写作方法论与 novel-studio pipeline 适配器。用于把短篇、盐言故事、拆文续写等需求整理为 pipeline 输入;在 novel-studio 内禁止直接生成正文。触发方式:/story-short-write、/写短篇、「帮我写一篇短篇」「写个盐言故事」。

    131 GitHub stars~5.6k tokensUpdated 15 days ago
    Auto-check passed
  • Story Douban Long Write

    Xiaoyangy/novel-studio

    豆瓣阅读原创长篇专项方法论与 novel-studio pipeline 适配器。用于把 15W-30W 字原创长篇的主题、类型、开头、文字、标签、简介和提交自检要求整理为 pipeline 输入;在 novel-studio 内禁止直接生成正文。触发方式:/story-douban-long-write、/豆瓣长篇、/豆瓣写作、「写一部豆瓣阅读原创长篇」「按豆瓣要求写长篇」。

    131 GitHub stars~1k tokensUpdated 15 days ago
    Auto-check passed
  • Story Short Analyze

    Xiaoyangy/novel-studio

    短篇网文拆文。拆解爆款短篇小说(番茄短篇 / 故事会 / 知乎盐选 / 追妻 / 世情 / 重生 / 虐渣等通俗题材)的故事核、结构、情感线、反转设计、写作手法、共鸣层次。单一全量拆解管道:跑完 Stage 2-6 产出完整拆文报告,落盘到 deconstruction-library/{书名}/,下游 story-short-write 同时读拆文报告 + 情节节点 + 写作手法 + 原文…

    131 GitHub stars~2.3k tokensUpdated 15 days ago
    Auto-check passed
  • AI Novel Audit

    Xiaoyangy/novel-studio

    审核一段/一篇小说(或任意叙事性文本)的「AI 创作度」——判断它有多大可能由 AI 生成、或 AI 参与了多少。当用户想知道一段文字是不是 AI 写的、AI 味重不重、是人工还是 AI、AI 辅助了多少、帮忙鉴别/检测/审稿 AI 生成内容、给稿件的「人味/机味」打分时,都使用本技能。触发词包括但不限于:AI 创作度、AI 味、是不是 AI 写的、AI 生成检测、人工还是 AI、鉴别…

    131 GitHub stars~3.1k tokensUpdated 15 days ago
    Auto-check passed
  • Novel Pipeline

    Xiaoyangy/novel-studio

    把各功能串成一条可恢复的流水线:(共创→)写作→评审→重写→交付,按阶段执行、断点续跑。触发:「一条龙写完整本书」「从头跑完整个流程」「中断后接着跑」,想要无人值守端到端、且能中断恢复时使用。

    131 GitHub stars~632 tokensUpdated 15 days ago
    Auto-check passed

Questions about Novel Write

What does Novel Write do?

用一句创作需求驱动 novel-studio 走可恢复 pipeline 完整创作(写作→评审→重写→导出)。触发:「帮我写本小说」「按这个设定写」「跑一次创作」,已有明确创作要求且希望无人值守端到端产出章节时使用。. Novel Write is an agent skill from Xiaoyangy/novel-studio.

When should I use Novel Write?

Novel Write fits situations like: tasks that involve Creative writing and fiction.

How do I install Novel Write in Claude Code?

Run `npx skills add Xiaoyangy/novel-studio --skill novel-write -a claude-code`. Or copy the skill folder (skills/novel-write in Xiaoyangy/novel-studio) into .claude/skills/novel-write in your project. Claude Code loads it when a task matches its description.

How do I install Novel Write in Codex?

Run `npx skills add Xiaoyangy/novel-studio --skill novel-write -a codex`. Or copy the skill folder (skills/novel-write in Xiaoyangy/novel-studio) into .agents/skills/novel-write in your project. Codex loads it when a task matches its description.

Can I use Novel Write 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 Xiaoyangy/novel-studio --skill novel-write -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/novel-write, .gemini/skills/novel-write, .github/skills/novel-write and .opencode/skills/novel-write in your project.

What does Novel Write need to run?

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

Does Novel Write 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 Novel Write 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 Novel Write use?

Novel Write is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Novel Write use?

About 441 tokens (SKILL.md is roughly 1.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 Novel Write?

Skills that share tags, products or a category with Novel Write: Story Multi-Perspective Review (zenstory-ai/oh-story-claudecode, 7.4k stars), Story Toolbox Router (zenstory-ai/oh-story-claudecode, 7.4k stars), Short Web Fiction Trend Scan (zenstory-ai/oh-story-claudecode, 7.4k stars) and InkOS Creative Harness (Narcooo/inkos, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Novel Write?

Xiaoyangy (a GitHub user) maintains it in Xiaoyangy/novel-studio, which has 131 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on September 23, 2026.

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