Agent skill

Novel Writer

by ZJU-REAL in ZJU-REAL/Easel

长篇小说/网文连载创作:从世界观、人设和三级大纲写到逐章正文,并用文件化状态维护伏笔、前情和跨章一致性. An agent skill from ZJU-REAL/Easel.

Apache-2.0Auto-check passedWriting & Content

Install Novel Writer

skills CLI
$ npx skills add ZJU-REAL/Easel --skill novel-writer -a claude-code

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

GitHub CLI
$ gh skill install ZJU-REAL/Easel novel-writer --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/ZJU-REAL/Easel.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/openclaw/novel-writer .claude/skills/novel-writer && 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-writer
GitHub stars
3.4k
Token cost
~1k tokens
SKILL.md length
253 words
Files
7 (incl. scripts, references)
Skills in repo
114
Repo updated
First seen
Licence
Apache-2.0

At a glance

长篇小说/网文连载创作:从世界观、人设和三级大纲写到逐章正文,并用文件化状态维护伏笔、前情和跨章一致性. An agent skill from ZJU-REAL/Easel.

  • Works in 2 steps: 搭骨架:python… → 定世界观 + 人设 + 文风:读…
  • Tasks that involve Creative writing and fiction
  • SKILL.md covers 输入, 产物结构(outputs/书名/), 执行步骤(按对话选对应子流程,不必每次全跑) and Profile 感知, plus 2 more sections
  • Runs Python scripts from its folder; calls python and python3

What it does

Novel Writer is an agent skill from ZJU-REAL/Easel. 长篇小说/网文连载创作:从世界观、人设和三级大纲写到逐章正文,并用文件化状态维护伏笔、前情和跨章一致性。 当用户说“写小说/网文/盐选故事、连载、续写下一章、小说大纲、人物设定、世界观、黄金三章”时使用。 通用文章用 article-outline/social-content;单段改风格或润色用 style-transfer/text-polisher。

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `EASEL-META.md`, `references/consistency-rules.md` and `references/platform-specs.md`).

It sits in Writing & Content, covering Creative writing and fiction and Social media posts. It works with Python. The repository describes itself as: An open-source AI agent for social media — discover trends, create content, publish everywhere, and learn what works across Xiaohongshu, Douyin, Zhihu, Bilibili, and more.🎨一个开源的… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Creative writing and fiction
  • Tasks that involve Social media posts

Example prompts

  • “写小说/网文/盐选故事、连载、续写下一章、小说大纲、人物设定、世界观、黄金三章”
  • “/novel-writer”

Requirements

  • Python 3

Workflow steps

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

  1. 搭骨架:python skills/openclaw/novel-writer/scripts/novel_ops.py scaffold --book "<书名>"
  2. 定世界观 + 人设 + 文风:读 references/web-novel-methodology.md 与 references/platform-specs.md,

What it can do on your machine

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

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

    Shell commands in SKILL.md call:

    • python
    • python3

    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 Writer loads about 1k tokens when it runs, and up to ~4.1k if it reads all its reference files. Until then it costs about 48 tokens; SKILL.md has 253 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~48
When it runs · the whole SKILL.md, loaded when a task matches
~1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.1k

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

SKILL.md

The full file from ZJU-REAL/Easel at commit ede33b8, republished under its Apache-2.0 licence (© ZJU-REAL). 253 words, ~1,048 tokens.

Download SKILL.mdSave it as .claude/skills/novel-writer/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
novel-writer
description
长篇小说/网文连载创作:从世界观、人设和三级大纲写到逐章正文,并用文件化状态维护伏笔、前情和跨章一致性。 当用户说“写小说/网文/盐选故事、连载、续写下一章、小说大纲、人物设定、世界观、黄金三章”时使用。 通用文章用 article-outline/social-content;单段改风格或润色用 style-transfer/text-polisher。
layer
produce

AI 小说 / 网文连载创作

一句灵感 → 世界观/人设 → 三级大纲 → 逐章正文。核心是长篇一致性: 用「文件即真相 + 按需加载」——AI 不靠上下文记忆,每写一章只加载相关切片, 状态全落文件、可 diff、可续写。确定性 IO(搭骨架/进度/机械查 AI 味)走 scripts/novel_ops.py,创意(设定/大纲/正文)由你 LLM 完成。

只做单段风格改写见 style-transfer;只做润色去 AI 感见 text-polisher; 只做通用文章见 social-content;发知乎见 skill-zhihu-publisher。

输入

字段必填说明
灵感/题材是一句话创意,或已有设定(没给就问)
平台否知乎盐选 / 番茄 / 起点 / 小红书图文(默认按 Profile 或问)
书名否缺省由题材拟定,用作产物目录名
本次动作否立项 / 出大纲 / 写第 N 章 / 续写 / 改图文(默认按对话判断)

产物结构(outputs/书名/)

bible/    world.md characters.md voice.md canon.md   ← 硬事实(写每章必读)
outline/  overview.md volumes.md chapters.md          ← 三级大纲
state/    summary.md character-state.md plot-arcs.md progress.json/md  ← 连载状态
chapters/ 001.md 002.md ...                            ← 章节正文

脚本路径(相对项目根):skills/openclaw/novel-writer/scripts/novel_ops.py。 字数校验复用:skills/shared/scripts/wordcount.py。

执行步骤(按对话选对应子流程,不必每次全跑)

A. 立项(首次)
  1. 搭骨架:python skills/openclaw/novel-writer/scripts/novel_ops.py scaffold --book "<书名>" (生成 bible/outline/state/chapters 模板,已存在的文件不覆盖)。
  2. 定世界观 + 人设 + 文风:读 references/web-novel-methodology.md 与 references/platform-specs.md, 据题材写满 bible/world.md(力量体系/规则/硬约束)、bible/characters.md(主角+关键配角:身份/外貌/性格/目标/关系)、 bible/voice.md(视角/时态/句式节奏/用词偏好 + 本书禁用词表)。设定要可执行(能约束后续正文),不写空话。
B. 大纲(三级)
  1. overview → volumes → chapters:写 outline/overview.md(一句话卖点+核心冲突+主线+结局向)、 outline/volumes.md(分卷 arc:每卷目标/转折/卷末高潮)、outline/chapters.md(章节目录表:标题+一句话钩子+涉及伏笔)。 大纲底座可参考 skill-article-outline,但必须扩成网文三级结构 + 伏笔埋点表(登记进 bible/canon.md)。
C. 黄金三章(前 3 章单独强化)
  1. 按 references/web-novel-methodology.md 的黄金三章模板,把前三章的开局钩子、爽点、代入感、追读悬念拉满 (第 1 章 3 秒内给冲突/金手指信号;每章末留强钩子)。这三章决定留存,值得单独打磨。
D. 写单章(连载主循环)
  1. 只加载相关切片(不塞全书):读 bible/(全部,是硬约束)+ outline/chapters.md 里本章那行 + state/summary.md(前情提要)+ state/character-state.md 里相关角色。
  2. (可选)先出场景卡:复杂章节按 references/scene-card-schema.md 先列场景卡(角色/地点/冲突/story value 涨落/情绪/出口)再写正文。
  3. 写正文到 chapters/<三位数>.md:遵守 bible/voice.md 文风、章末强钩子。
  4. 字数门禁:把正文喂 python3 skills/shared/scripts/wordcount.py check --target <平台目标字数> --tolerance 0.15 -f chapters/<NNN>.md (知乎盐选/番茄单章常 2000–4000,见 platform-specs),不达标按提示增删。
  5. 去 AI 味:先跑 python skills/openclaw/novel-writer/scripts/novel_ops.py slopcheck -f chapters/<NNN>.md 机械扫(AI 味词/过度连接词/重复句首),命中处改写;再整章过一遍 text-polisher(去 AI 感模式)。
E. sync(定稿后维护状态,防跨章崩坏)
  1. 更新 state/ 与 bible/canon.md:
    • 用 text-condenser(摘要模式)把「已发生剧情」滚动压缩进 state/summary.md(下一章加载它,不是全文)。
    • 更新 state/character-state.md(角色位置/处境/关系变化)、state/plot-arcs.md(各线进度)、bible/canon.md(新事件/时间线/伏笔状态:埋下→回收)。
    • 登记进度:novel_ops.py record --book "<书名>" --chapter N --title "<标题>" --words <字数> --status done --when <今天日期> (日期从对话上下文取,脚本不自取时间以保确定性)。
  2. 一致性自查:对照 bible/canon.md 扫本章有无与既定事实/时间线/人设冲突;发现则改正文或补设定(见 references/consistency-rules.md)。
F.(可选)next 剧情推演
  1. 卡剧情时,生成 2–3 个后续章纲分支(不同走向/爽点/反转),列优劣供用户选,选定再写。
G.(可选)改小红书图文连载
  1. 把某章交给 card-xiaohongshu 或 xhs-note-creator,拆成 3–9 张竖版卡片连载(每卡一个情绪节点,末卡留钩子)。

Profile 感知

  • 有 Profile:platforms.md 定平台与单章字数/更新频率;style.md 融进 bible/voice.md 文风; identity.md/audience.md 定题材调性与目标读者;preferences.md 红线(题材/敏感内容)过滤。
  • 无 Profile:先问平台与题材偏好;默认第三人称、单章 ~3000 字、章末强钩子的通用网文风。

规则

  1. 文件即真相:设定/状态以 bible/ state/ 文件为准,不靠对话记忆;冲突时以 canon 为准。
  2. 按需加载:写每章只读相关切片,避免全书塞上下文导致漂移/超长。
  3. 一致性优先:人设/世界观/伏笔跨章不崩是网文命脉,宁可慢也不崩。
  4. 去 AI 味:机械 slopcheck + text-polisher 双保险;文风统一靠 bible/voice.md。
  5. 不覆盖已写内容:scaffold 幂等、record upsert;正文/设定改动用增量编辑,别整篇重写抹掉用户改动。
  6. 不编造设定:拿不准的世界观细节先问或先在 bible 补定义,再写正文。

参考来源

见 EASEL-META.md。方法论沉淀自 autonovel(模板体系/双免疫去 slop)、马良 MaliangAINovalWriter (三级大纲/黄金三章/剧情推演)、AI_NovelGenerator(定稿更新状态+一致性校验)、GOAT-Storytelling-Agent (场景卡分解替代长上下文)——均为「文件即真相 + 按需加载」思路,最适合纯文件工具的 Easel。

© ZJU-REAL, 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 6 other files (scripts, references) in skills/openclaw/novel-writer of ZJU-REAL/Easel.

  • SKILL.md
  • EASEL-META.md
  • references/consistency-rules.md
  • references/platform-specs.md
  • references/scene-card-schema.md
  • references/web-novel-methodology.md
  • scripts/novel_ops.py

Open the folder on GitHubat commit ede33b8

Compare with similar skills

Novel Writer 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 Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Novel Writer this skillZJU-REAL/Easel3.4k—~1kAutomated safety check: PassApache-2.0
Inputs V2 New Modulesaezlab/pypath164—~728Automated safety check: PassGPL-3.0
Python Manager Discoverymicrosoft/vscode-python-environments141—~2.7kAutomated safety check: PassMIT
Content Creatorthatrebeccarae/claude-marketing161—~1.1kAutomated safety check: PassMIT
Creative Writingspytensor/openmozi456—~373Automated safety check: PassMIT
Schedule Socialindranilbanerjee/digital-marketing-pro8621 repos~3.4kAutomated safety check: PassMIT

Similar skills

  • Inputs V2 New Module

    saezlab/pypath

    Create a new pypath inputsv2 module for an external database.

    164 GitHub stars~728 tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Python Manager Discovery

    microsoft/vscode-python-environments

    Official

    Environment manager-specific discovery patterns and known issues.

    141 GitHub stars~2.7k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Content Creator

    thatrebeccarae/claude-marketing

    Comprehensive content marketing toolkit with brand voice analysis, SEO optimization scripts, content frameworks, social media strategy, and content calendar planning.

    161 GitHub stars~1.1k tokensUpdated 4 mo ago
    Writing & ContentAuto-check passed
  • Creative Writing

    spytensor/openmozi

    Creative content workflow: brief, research, outline, draft, refine.

    456 GitHub stars~373 tokensUpdated 2 mo ago
    Writing & ContentAuto-check passed
  • Schedule Social

    indranilbanerjee/digital-marketing-pro

    Schedule social posts to connected platforms at best times, approval-gated.

    862 GitHub starsUsed in 1 repo~3.4k tokens
    Writing & ContentAuto-check passed
  • Script Comparative Review Against Hits

    Supreme-Ultimate/novel-to-script-team

    Chinese-language skill that scores a generated short-drama script against a reference hit script on rhythm, dialogue style, emotional impact and structure, with PASS/FAIL thresholds.

    175 GitHub stars~1.8k tokensUpdated 5 mo ago
    Media & CreativeAuto-check passed

More from ZJU-REAL/Easel

All 114 skills in this repo
  • Gzh Design

    ZJU-REAL/Easel

    微信公众号文章排版引擎:把 Markdown / Word(.docx) / PDF / 纯文本转成可直接粘贴进公众号编辑器的 HTML,自动章节编号、关键词标记、引言卡、目录、代码块、图片/GIF、作者签名;主题从 references/theme-index.md…

    3.4k GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • 微信公众号文章自动创作与发布工具。给定参考文章、文字或文档,自动搜索整理全网相关信息、生成图文并茂的公众号文章,并发布到微信公众号草稿箱。特别强调反 AI 检测写作。

    3.4k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Card Design

    ZJU-REAL/Easel

    社媒卡片视觉设计系统:提供配色、中文字体层级、满画幅布局、品类骨架和死空白/密度质检,避免模板化 PPT 与廉价 AI 感。

    3.4k GitHub stars~657 tokensUpdated today
    Auto-check passed
  • Ecom Details Image

    ZJU-REAL/Easel

    生成电商商品视觉方案:主图概念、场景图、详情页视觉方向和 AI 生图 Prompt. An agent skill from ZJU-REAL/Easel.

    3.4k GitHub stars~1.1k tokensUpdated today
    Auto-check: notes
  • Infographic

    ZJU-REAL/Easel

    将数据或文字内容转化为可视化信息图,支持静态(AntV)和动画 GIF 两种模式。当用户需要制作信息图、数据可视化、流程图、对比图、动画图表、GIF 图表、思维导图、SWOT 分析图时调用。本地渲染信息图/GIF 动画;要单张静态图片 URL 用 chart-visualization,要 CSV/JSON→整页报告用 data-report

    3.4k GitHub stars~643 tokensUpdated today
    Auto-check passed
  • Paper Explainer

    ZJU-REAL/Easel

    科研论文解读:解析 arXiv/PDF 的公式与图表,提炼问题、贡献、方法、关键图和结论,再产出 B站/视频号解读视频或知乎/公众号图文。

    3.4k GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Works with

Questions about Novel Writer

What does Novel Writer do?

长篇小说/网文连载创作:从世界观、人设和三级大纲写到逐章正文,并用文件化状态维护伏笔、前情和跨章一致性. An agent skill from ZJU-REAL/Easel. Novel Writer is an agent skill from ZJU-REAL/Easel.

When should I use Novel Writer?

Novel Writer fits situations like: tasks that involve Creative writing and fiction; tasks that involve Social media posts.

How do I install Novel Writer in Claude Code?

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

How do I install Novel Writer in Codex?

Run `npx skills add ZJU-REAL/Easel --skill novel-writer -a codex`. Or copy the skill folder (skills/openclaw/novel-writer in ZJU-REAL/Easel) into .agents/skills/novel-writer in your project. Codex loads it when a task matches its description.

Can I use Novel Writer 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 ZJU-REAL/Easel --skill novel-writer -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-writer, .gemini/skills/novel-writer, .github/skills/novel-writer and .opencode/skills/novel-writer in your project.

What does Novel Writer need to run?

Going by SKILL.md and its folder, Novel Writer needs Python for the scripts in its folder and the command-line tools its instructions call (python and python3). Our summary lists: Python 3.

Does Novel Writer 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 Writer 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Novel Writer use?

Novel Writer 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 Writer use?

About 1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.1k tokens, read only when the agent opens those files.

What are the alternatives to Novel Writer?

Skills that share tags, products or a category with Novel Writer: Inputs V2 New Module (saezlab/pypath, 164 stars), Python Manager Discovery (microsoft/vscode-python-environments, 141 stars), Content Creator (thatrebeccarae/claude-marketing, 161 stars) and Creative Writing (spytensor/openmozi, 456 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Novel Writer?

ZJU-REAL (a GitHub organization) maintains it in ZJU-REAL/Easel, which has 3,441 GitHub stars. The repository holds 114 skills in this directory. The repository was last updated on October 11, 2026.

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