novel-sync

novel-sync is a skill for Claude Code from chaserr/novel-craft. It costs 76 tokens per session (1,657 once invoked), scanned A, original, MIT.

A Chinese-language workflow for updating a novel's continuity notes after a chapter is written or changed. It records events, character changes, unresolved clues, and notable lines in the project's reference files.

In plain words
What is it for?
Use it after writing or editing a chapter to extract its key events, update character files, track newly planted or resolved clues, and review quotation candidates before saving changes.
Why use it?
It prevents important story details from being lost between chapters. It also keeps character records, plot clues, quotations, and previous-events summaries aligned with the actual chapter text.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: names the AskUserQuestion tool.

Part of the novel-craft plugin — 6 skills, 12 agents shipped together

Good fit Use it after writing or editing a chapter to extract its key events, update character files, track newly planted or resolved clues, and review quotation candidates before saving changes.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/chaserr/novel-craft/novel-sync
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add chaserr/novel-craft --skill novel-sync
Clone the repo
git clone --depth 1 https://github.com/chaserr/novel-craft

Made for: Claude Code.

Or install novel-craft, the plugin that ships this one along with the rest of its 6 skills, 12 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for novel-sync

README.md
[![agentmods](https://agentmods.dev/badge/skills/chaserr/novel-craft/novel-sync/github.svg)](https://agentmods.dev/skills/chaserr/novel-craft/novel-sync)
Your own site
<a href="https://agentmods.dev/skills/chaserr/novel-craft/novel-sync"><img src="https://agentmods.dev/badge/skills/chaserr/novel-craft/novel-sync/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for novel-sync

Your own site · 80×15
<a href="https://agentmods.dev/skills/chaserr/novel-craft/novel-sync"><img src="https://agentmods.dev/badge/skills/chaserr/novel-craft/novel-sync.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 76 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,657 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00076 $0.01657
Opus 5 $0.00038 $0.00829
Sonnet 5 $0.00015 $0.00331
Haiku 4.5 $0.00008 $0.00166

Measured 9d ago against content hash 5e7fe9961fd4, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

novel-sync scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/novel-sync/SKILL.md · 160 lines

How it starts

The opening of the file, as written. The whole thing — 160 lines — stays where its author put it; the contents beside it link to each section on GitHub.

novel-sync

用途:把刚写完(或刚修改)的章节信息同步到四类滚动维护的资料文件,确保下一章写作基于最新上下文。

触发场景

  • novel-write 写完一章后必须调用
  • 手动改完某章正文后调用
  • 用户主动要求"同步前情/伏笔/语录/档案"时

输入要求

  • 章节号(必须)
  • 是否覆盖式同步(默认追加 / 也可重生成该章对应条目)

执行流程

第 1 步:读取目标章节正文 + 现有四件套

  1. 找到目标章节正文文件(按 <书名>-第X章-章名.md 模式 glob)
  2. 读取:
    • 前情梳理.md
    • 伏笔清单.md
    • 经典语录.md
    • 人物档案/ 下所有文件名

第 2 步:提取本章关键信息

通读章节正文,提炼以下内容(暂存内存,不立即写盘):

2.1 章节摘要(→ 前情梳理.md)

按 200-400 字写:

  • 本章核心事件(时间地点 + 主线推进)
  • 关键关系变化(谁和谁的关系发生了什么)
  • 人物内心变化点
  • 章尾承接点(下一章从哪里开始)
  • 已埋伏笔编号
  • 已回收伏笔编号
2.2 涉及人物的状态更新(→ 人物档案/*.md)

对本章每个出场人物:

  • 新增的重要事件(一句话,按章节标注)
  • 说话方式 / 习惯动作的新发现(如有)
  • 当前情感状态的更新
  • 与其他人物的关系变化
  • 新出现的未解决问题或隐性情绪

严格规则:只记录正文里实际写出来的内容,不能把章节大纲里的"预设走向"提前写进档案。

2.3 伏笔追踪(→ 伏笔清单.md)
  • 本章新埋的伏笔:类型 / 内容 / 位置 / 预期回收章 / 风险
  • 本章回收的伏笔:找到原伏笔条目,标记"已回收:第X章 + 回收质量评估(准时有力 / 过早泄底 / 过晚已失效 / 力度不足)"
  • 本章推进但未完结的伏笔:更新"当前状态"
2.4 经典语录候选(→ 经典语录.md)

筛 0-3 句"真正值得留下的句子"。判断标准:

  • 必须离开上下文也站得住(脱离章节读仍有力量)
  • 必须不是套话(不在 RTK.md 黑名单里)
  • 必须有具体感(不是空泛抒情)
  • 每章最多 3 句,宁缺毋滥

如果本章没有合格的句子,明确写"本章无候选"。

第 3 步:用户确认(关键)

将提取的内容用结构化方式展示给用户:

【第X章 同步预览】

▼ 前情梳理新增条目
[本章摘要 200-400 字]

▼ 涉及人物档案更新
- 人物A:新增事件 [...] / 情感状态 [...]
- 人物B:新增事件 [...]
...

▼ 伏笔清单变更
新埋:F-XX [...]
回收:F-12 → 第X章回收(评估:准时有力)

▼ 经典语录候选(N 句,由你筛选)
1. 「...」
2. 「...」

请确认:
- 整体同步(全部写入)
- 部分同步(指明保留 / 删除哪几项)
- 取消同步

第 4 步:写入更新(用户确认后)

用 Edit 工具追加式写入,不覆盖已有内容:

  • 前情梳理.md:在合适位置插入"## 第X章 摘要"段落
  • 人物档案/<名字>.md:在"已发生事件"等对应小节追加新行
  • 伏笔清单.md:新条目追加 + 已有条目用 Edit 改"当前状态"
  • 经典语录.md:在合适位置追加新条目(含章节出处标注)

第 5 步:一致性自检

写入完成后,简单自检:

  • 前情梳理.md 最末条目章节号 = 本次同步章节号 ✓
  • 伏笔清单.md 里至少存在一条"已回收"记录的章节号 = 本次(如本章确有回收)✓
  • 涉及人物档案的"最后一次重要出场"字段已更新到本章 ✓

不通过则提示用户。

第 6 步:输出报告

✅ 第X章同步完成

更新的文件:
- 前情梳理.md(追加 1 条摘要)
- 人物档案:A.md / B.md / C.md
- 伏笔清单.md(新增 N 条,回收 M 条)
- 经典语录.md(新增 K 条)

⚠️ 待提醒:
- 伏笔 F-08 已埋 5 章未回收,建议在下 3 章内处理
- 人物 X 已 10 章未实质出场,注意是否被遗忘

异常处理

情况 处理
找不到目标章节正文 询问用户确认章节号或文件路径
前情梳理.md 已有该章条目 询问"覆盖 / 跳过 / 改写为补充版"
伏笔候选无法在伏笔清单里找到对应条目 标记为"疑似遗忘的回收",请用户确认
经典语录里已有几乎相同的句子 不入选,提示用户

Read the full file on GitHub · 160 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 160 lines · 76 tokens per session scan A 5e7fe9961fd4

Subscribe to this mod's changes

novel-sync is a skill published in the GitHub repository chaserr/novel-craft (2 stars, last pushed yesterday), licensed MIT. It adds 76 tokens to every session and 1,657 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.