Agent skill

Novel Reference Analysis Method

by yannikzz in yannikzz/narracat-novel-agent

A reference work analysis method providing text decomposition and five-dimension extraction framework (premise / world / characters / structure / style, with narrator voice sub-framework under…

AGPL-3.0Auto-check passedWriting & Content

Install Novel Reference Analysis Method

skills CLI
$ npx skills add yannikzz/narracat-novel-agent --skill novel-reference-analysis-method -a claude-code

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

GitHub CLI
$ gh skill install yannikzz/narracat-novel-agent novel-reference-analysis-method --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/yannikzz/narracat-novel-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agent-core/narracat/skills/novel-reference-analysis-method .claude/skills/novel-reference-analysis-method && 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-reference-analysis-method
GitHub stars
103
Token cost
~1.1k tokens
SKILL.md length
255 words
Files
2 (incl. references)
Skills in repo
7
Repo updated
First seen
Licence
AGPL-3.0

At a glance

A reference work analysis method providing text decomposition and five-dimension extraction framework (premise / world / characters / structure / style, with narrator voice sub-framework under…

  • Works in 5 steps: 分维度阅读:每次阅读聚焦一个维度(premise / world /… → 手法识别:提炼"做什么 / 如何做",而非"为什么好" → 去文本化:摘要句中不出现专名 / 桥段细节 / 金句原文 /… → …
  • Tasks that involve Creative writing and fiction
  • SKILL.md covers 用途, 文本拆解方法论, 五个分析维度 and 片段约束, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Novel Reference Analysis Method is an agent skill from yannikzz/narracat-novel-agent. A reference work analysis method providing text decomposition and five-dimension extraction framework (premise / world / characters / structure / style, with narrator voice sub-framework under style) for distilling injectable guidance from user-provided reference novels. Enforces detextualization (paraphrase mechanisms instead of copying proper nouns, signature lines, or imagery) and refuses any ≥10-character verbatim copying. Use only when /narracat:reference command analyzes texts in bible/references/. Not for…

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/text-decomposition-methodology.md`).

It sits in Writing & Content, covering Creative writing and fiction. The repository describes itself as: 面向中国网文作者的 AI 共创桌面应用 | AI-powered desktop writing studio for Chinese web novels. The licence is AGPL-3.0.

When your agent uses it

  • Tasks that involve Creative writing and fiction

Example prompts

  • “/novel-reference-analysis-method”

Workflow steps

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

  1. 分维度阅读:每次阅读聚焦一个维度(premise / world / characters / structure / style),避免一次性混合分析
  2. 手法识别:提炼"做什么 / 如何做",而非"为什么好"
  3. 去文本化:摘要句中不出现专名 / 桥段细节 / 金句原文 / 具体意象(详见下文「分析原则」§2 三类抽象规则 + §6「拒绝原文复制」)
  4. 场景化标注:每个借鉴片段附「适用场景」「借鉴点」「不应照搬」
  5. 跨文件融合:多个参考作品时先逐文件分析,再提炼共性

What it can do on your machine

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

    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 Reference Analysis Method loads about 1.1k tokens when it runs, and up to ~2.3k if it reads all its reference files. Until then it costs about 144 tokens; SKILL.md has 255 words of instructions outside code blocks.

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

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 yannikzz/narracat-novel-agent at commit 2c49f9f, republished under its AGPL-3.0 licence (© yannikzz). 255 words, ~1,128 tokens.

Download SKILL.mdSave it as .claude/skills/novel-reference-analysis-method/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
novel-reference-analysis-method
description
A reference work analysis method providing text decomposition and five-dimension extraction framework (premise / world / characters / structure / style, with narrator voice sub-framework under style) for distilling injectable guidance from user-provided reference novels. Enforces detextualization (paraphrase mechanisms instead of copying proper nouns, signature lines, or imagery) and refuses any ≥10-character verbatim copying. Use only when /narracat:reference command analyzes texts in bible/references/. Not for chapter writing or review.

novel-reference-analysis-method

本 Skill 仅供 /narracat:reference 命令显式调用。不被任何 Agent 注入,不被 setup/world/plan/write/review/rewrite 自动匹配。

本 Skill 只定义"如何分析"(方法论 + 维度框架)。"分析结果写到哪里、按什么文件结构组织"由 commands/reference.md 约定。

用途

为参考作品分析提供方法论与维度框架:从用户放在 bible/references/ 下的参考作品(.md / .txt)提炼可被后续 command 直接喂给 prompt 的高密度材料。

输出材料的特征:

  • 偏向"可注入摘要 + 可借鉴片段 + 不应继承"三段结构
  • 不是赏析报告,不写"这种写法体现了..."的赏析句式
  • 不含参考作品的专名 / 角色名 / 具体桥段细节 / 标志金句原文(仅描述手法和机制;详见「分析原则」§2「去文本化」+ §6「拒绝原文复制」)

文本拆解方法论

详见 ${CLAUDE_PLUGIN_ROOT}/skills/novel-reference-analysis-method/references/text-decomposition-methodology.md(按需 Read 加载)。

核心步骤:

  1. 分维度阅读:每次阅读聚焦一个维度(premise / world / characters / structure / style),避免一次性混合分析
  2. 手法识别:提炼"做什么 / 如何做",而非"为什么好"
  3. 去文本化:摘要句中不出现专名 / 桥段细节 / 金句原文 / 具体意象(详见下文「分析原则」§2 三类抽象规则 + §6「拒绝原文复制」)
  4. 场景化标注:每个借鉴片段附「适用场景」「借鉴点」「不应照搬」
  5. 跨文件融合:多个参考作品时先逐文件分析,再提炼共性

五个分析维度

维度分析要点
premise题材承诺、核心冲突、读者期待、情绪曲线、类型钩子
world设定密度、规则露出方式、场景质感、信息解释方式(直说 vs. 暗示)
characters角色类型、关系张力、语言指纹、动机结构、矛盾性
structure章节开合手法、转折设计、悬念布置、信息释放节奏、爽点/痛点分布
style叙事视角、句式节奏、描写密度、对话风格、修辞密度、标点偏好;叙述者腔调子项见下文

每个维度的产出形态遵循「注入摘要 / 应该影响的决策 / 可借鉴片段 / 不应继承 / 来源依据」五段结构——具体文件结构与目标路径由 commands/reference.md 定义。

style 维度的「叙述者腔调」子项分析框架

每个参考作品在 style 维度下额外提炼 5 个「叙述者腔调」子项(与 commands/reference.md 步骤 4 的 style.md 模板 5 子项一一对应;具体目标文件结构以 commands/reference.md 为准):

  1. 风格描述(200-400 字 paraphrase)

    • 分析方法:通读参考作品若干叙述段落,提炼整体气质的「做什么 / 怎么做」(语气、节奏、距离感、情感色温、与读者关系等),用自己的话重写,不直接引用作品中的描写句。
    • 输出形态:200-400 字连续散文段,全程 paraphrase,不出现专名、不出现 ≥10 字原文。
  2. 专属词汇(10-30 个 tag)

    • 分析方法:从作品中识别出反复出现、构成该腔调辨识度的词汇 palette(动词类型、修饰语习惯、声音指示词、领域术语类型等),做类型化抽象而非照搬作品原词。
    • 输出形态:10-30 个抽象 tag 列表,每个 tag 描述词汇类型(如「带肌肉感的短动词」「文白夹杂的虚词」),不写具体原词;如必须举例则需明确标注「示意,非作品原词」。
  3. 概念体系(5-15 条要点)

    • 分析方法:分析该腔调如何 frame 世界——叙述者用什么样的概念群把人、事、物组织起来(如「修行 = 江湖 = 武林」的概念合一、「江湖 / 庙堂 / 山野」的三元拆分、「人情 / 规矩 / 体面」的伦理坐标等),重在结构和坐标系,不在具体设定。
    • 输出形态:5-15 条要点列表,每条描述一个概念群或一组对应关系,不写参考作品的具体专名。
  4. 标志金句机制(3-5 条机制描述,不是金句库)

    • 分析方法:识别参考作品中能体现该叙述者腔调辨识度的若干「标志性句子」,但不收录金句本体——而是抽象出可复用的机制描述:句长区间 + 嵌入位置(独立段 / 段末点睛 / 借人物口)+ 语用功能(点题 / 转折 / 评议 / 反讽)+ 限定条件(仅在哪类场景下出现 / 多久出现一次 / 与什么前置情绪搭配)。
    • 输出形态:3-5 条机制描述。严禁列出原句,即使是「最有名的那句」也必须 paraphrase 为机制(例:「嵌入式 8-15 字短句 + 借次要人物口说出 + 用于场景结尾点睛 + 必带一处辩证转折」)。
  5. 不应继承反模式(enumerate 清单,作为抗抄袭代码扫描的源数据)

    • 分析方法:参考作品的具体专名 / 桥段类型 / 原文 ≥10 字片段 / 关系原型——只要复用就会引发抄袭风险的内容,必须尽量完整 enumerate;漏列由下游代码扫描兜底,但 produce 阶段力求穷尽。
    • 输出形态:4 类清单——专名(人名 / 地名 / 物品名 / 门派 / 招式名等具体专有名词)、桥段(标志性桥段类型描述,不是细节复述)、原文 ≥10 字(具体禁止片段 enumerate,作为后续抗抄袭代码扫描的源数据)、关系原型(如「主角 + 师门 + 师姐」的具体三元组)。

设计约束:上述 5 子项的输出全程遵循下文「分析原则」§2「去文本化」+ §6「拒绝原文复制」。「标志金句机制」子项是去文本化压力最大的位置,分析时抗拒「为了精准而摘抄原句」的诱惑——精准描述机制即可,不需要也不应当出现金句原文。

片段约束

  • 每个维度最多 3-5 个可借鉴片段
  • 单个片段建议 80-250 中文字,不超过 500 中文字
  • 每个片段必须附「适用场景」「借鉴点」「不应照搬」三项
  • 摘要句以"做什么"或"如何做"开头,避免赏析腔

分析原则

  1. 多源融合:参考作品有多个时,逐文件分析后提炼共性,避免单一作品风格主导
  2. 去文本化:摘要和借鉴点中不得出现:
    • 专名抽象为类型:参考作品的具体角色名 / 地名 / 物品名 / 门派 / 招式名一律抽象为类型(如"侠客主角 + 隐世师门",不写"陈平安 + 山下学派")
    • 金句抽象为机制:标志性句子一律抽象为机制(句长 + 嵌入位置 + 语用 + 限定,如"嵌入式 8-15 字 + 借人物口 + 可被辩证"),不写原句
    • 意象抽象为范畴:桥段细节和具体描写一律抽象为类型与范畴(如"师徒山下学派 + 主角剑修觉醒",不写具体场景;如"水墨远景 + 留白意象",不写具体描写句)
  3. 场景化标注:每个片段必须能回答"什么情境下用这个手法"
  4. 拒绝赏析腔:摘要句以"做什么"或"如何做"开头,避免"这种写法体现了..."的赏析句式
  5. 不应继承显式化:「不应继承」是审修端的项目特化黑名单,必须列出具体可识别的禁用内容(如"主角名 + 配角名组合"、"师徒关系起手"、"某类设定术语")
  6. 拒绝原文复制:分析时产出文件不应出现 ≥10 字连续参考作品原文片段。即使是"金句"也必须 paraphrase 为机制描述。原因:style.md 等 guidance 文件会长期注入后续命令与写作上下文,原文残留会触发抄袭风险。「不应继承.原文 ≥10 字」清单中列出的具体禁止片段属于黑名单源数据,不属于本条所禁的「原文残留」——它们是为下游代码扫描提供的合法 enumerate。

与其他 Skill 的关系

  • novel-style-reference:内置的真人写作范例库(写作上下文与深审用),项目无关
  • novel-reference-analysis-method(本 Skill):项目特化的参考作品分析方法论,由 /narracat:reference 调用,分析后产物即"退场",不再被任何下游 command 注入

后续 command 只读 bible/reference-guidance/*.md 文件,不重新执行参考作品分析。

© yannikzz, AGPL-3.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 1 other file (references) in agent-core/narracat/skills/novel-reference-analysis-method of yannikzz/narracat-novel-agent.

  • SKILL.md
  • references/text-decomposition-methodology.md

Open the folder on GitHubat commit 2c49f9f

Compare with similar skills

Novel Reference Analysis Method 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 Reference Analysis Method compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Novel Reference Analysis Method this skillyannikzz/narracat-novel-agent103—~1.1kAutomated safety check: PassAGPL-3.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 yannikzz/narracat-novel-agent

  • Release App

    yannikzz/narracat-novel-agent

    Cut and publish a new NarraCat-app version — bump the version number, build the Windows x64 package in CI, package + sign + notarize the macOS build locally, and publish both platforms into one…

    103 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check: notes
  • Release Guard

    yannikzz/narracat-novel-agent

    View or change NarraCat-app's internal-test release gate / remote kill switch (the release-guard Cloudflare Worker in workers/release-guard).

    103 GitHub stars~495 tokensUpdated yesterday
    Auto-check passed
  • Novel Structure

    yannikzz/narracat-novel-agent

    Narrative structure knowledge for long-form web fiction, covering emotional stakes, tension rhythm, climax layering, foreshadowing payoff pacing, value shifts and event architecture, multi-thread…

    103 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Novel Web Craft

    yannikzz/narracat-novel-agent

    Web-fiction craft material library consumed by the /write brief compressor — retention mechanics (hooks, pacing, conflict clarity, dialogue load, payoff delivery, chapter-end pull) kept as…

    103 GitHub stars~695 tokensUpdated yesterday
    Auto-check passed
  • Novel Memory Integration

    yannikzz/narracat-novel-agent

    Guide for answering natural language questions about novel content by querying NovelMemory MCP read tools from the main conversation.

    103 GitHub stars~392 tokensUpdated yesterday
    Auto-check passed
  • Novel Style Reference

    yannikzz/narracat-novel-agent

    A real-novel writing style reference library backed by the novelquerystylereference MCP tool.

    103 GitHub stars~391 tokensUpdated yesterday
    Auto-check passed

Questions about Novel Reference Analysis Method

What does Novel Reference Analysis Method do?

A reference work analysis method providing text decomposition and five-dimension extraction framework (premise / world / characters / structure / style, with narrator voice sub-framework under…. Novel Reference Analysis Method is an agent skill from yannikzz/narracat-novel-agent. A reference work analysis method providing text decomposition and five-dimension extraction framework (premise / world / characters / structure / style, with narrator voice sub-framework under style) for distilling injectable guidance from user-provided reference novels.

When should I use Novel Reference Analysis Method?

Novel Reference Analysis Method fits situations like: tasks that involve Creative writing and fiction.

How do I install Novel Reference Analysis Method in Claude Code?

Run `npx skills add yannikzz/narracat-novel-agent --skill novel-reference-analysis-method -a claude-code`. Or copy the skill folder (agent-core/narracat/skills/novel-reference-analysis-method in yannikzz/narracat-novel-agent) into .claude/skills/novel-reference-analysis-method in your project. Claude Code loads it when a task matches its description.

How do I install Novel Reference Analysis Method in Codex?

Run `npx skills add yannikzz/narracat-novel-agent --skill novel-reference-analysis-method -a codex`. Or copy the skill folder (agent-core/narracat/skills/novel-reference-analysis-method in yannikzz/narracat-novel-agent) into .agents/skills/novel-reference-analysis-method in your project. Codex loads it when a task matches its description.

Can I use Novel Reference Analysis Method 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 yannikzz/narracat-novel-agent --skill novel-reference-analysis-method -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-reference-analysis-method, .gemini/skills/novel-reference-analysis-method, .github/skills/novel-reference-analysis-method and .opencode/skills/novel-reference-analysis-method in your project.

What does Novel Reference Analysis Method need to run?

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

Does Novel Reference Analysis Method 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 Reference Analysis Method 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 Reference Analysis Method use?

Novel Reference Analysis Method is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Novel Reference Analysis Method use?

About 1.1k tokens (SKILL.md is roughly 4.5k 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 1.2k tokens, read only when the agent opens those files.

What are the alternatives to Novel Reference Analysis Method?

Skills that share tags, products or a category with Novel Reference Analysis Method: 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 Reference Analysis Method?

yannikzz (a GitHub user) maintains it in yannikzz/narracat-novel-agent, which has 103 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 7, 2026.

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