Agent skill

Novel Style Reference

by yannikzz in yannikzz/narracat-novel-agent

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

AGPL-3.0Auto-check passedWriting & Content

Install Novel Style Reference

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

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

GitHub CLI
$ gh skill install yannikzz/narracat-novel-agent novel-style-reference --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-style-reference .claude/skills/novel-style-reference && 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-style-reference
GitHub stars
105
Token cost
~391 tokens
SKILL.md length
82 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
AGPL-3.0

At a glance

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

  • Tasks that involve Creative writing and fiction
  • SKILL.md covers 定位, 何时使用, MCP 工具调用 and 分类体系
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Novel Style Reference is an agent skill from yannikzz/narracat-novel-agent. A real-novel writing style reference library backed by the novelquerystylereference MCP tool. Returns annotated extracts from published Chinese novels indexed by technique × emotion. Use the MCP tool to fetch human-written examples that break AI templated expression patterns during chapter writing or review.

Its SKILL.md is about 390 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 Writing & Content, covering Creative writing and fiction. It works with Model Context Protocol. 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-style-reference”

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 Style Reference loads about 391 tokens when it runs. Until then it costs about 84 tokens; SKILL.md has 82 words of instructions outside code blocks.

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

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). 82 words, ~391 tokens.

Download SKILL.mdSave it as .claude/skills/novel-style-reference/SKILL.md (or your agent's skills folder).
name
novel-style-reference
description
A real-novel writing style reference library backed by the novel_query_style_reference MCP tool. Returns annotated extracts from published Chinese novels indexed by technique × emotion. Use the MCP tool to fetch human-written examples that break AI templated expression patterns during chapter writing or review.

novel-style-reference

定位

本 Skill 是系统集成壳——封装 novel_query_style_reference MCP 工具的调用说明,按手法+情感检索真人写作范例。

不提供写作原则、不替代写作技艺指导。库含 58 部华语网文的 4141 个标注段落,存于官方只读语料服务(不随包分发),工具联网检索;去标识化:只给段落与机制注解、不含出处。服务不可用或未配置凭证时返回空结果与提示,不影响写作流程。

写作链消费的范例由上下文构建工具按 technique × emotion 机械选入,不经本 Skill。

何时使用

  • 深度审读时 — 标注某段写法问题时,按对应手法调用,提供修订方向的真人参照
  • 对话讨论时 — 与用户讨论某类场景怎么写时,调用拉取真人范例
  • 不要这样用 — 全量扫描语料文件做整体阅读(违背"按需查询"原则)

MCP 工具调用

工具全名:mcp__narracat_memory__novel_query_style_reference

入参:

参数类型必填说明
techniquestring[]是手法标签(至少 1 个),值域见下方"分类体系"
emotionstring[]否情感标签(0-2 个),值域见下方"分类体系"
limitint否返回条数上限(默认 3,最大 8)

返回: StyleReferenceEntry[],每条含 id / paragraph / technique[] / emotion[] / annotation / usage_scenario(不含出处——真人范例去标识化,只提供段落与机制注解)。

调用示例:

场景:暴雨中两个陌生人初遇,需要一段对话,既紧张又带点幽默
→ novel_query_style_reference({technique:["对话设计"], emotion:["紧张","幽默"]})
→ 返回 2-3 条同类对话范例
→ 参考范例的节奏与潜台词写法,不照搬段落内容

分类体系

手法维度(8 类)

对话设计 / 心理刻画 / 环境描写 / 动作细节 / 节奏控制 / 情感渲染 / 视角运用 / 悬念设置

情感维度(8 类)

紧张 / 悲伤 / 愤怒 / 暧昧 / 幽默 / 温暖 / 释然 / 震撼

「幽默」是情感不是手法,勿放进 technique。学范例时提炼机制、节奏与语用决策,不复制原文、专名或桥段。

© 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

Just SKILL.md in agent-core/narracat/skills/novel-style-reference of yannikzz/narracat-novel-agent.

Open the folder on GitHubat commit 2c49f9f

Compare with similar skills

Novel Style Reference 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 Style Reference compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Novel Style Reference this skillyannikzz/narracat-novel-agent105—~391Automated safety check: PassAGPL-3.0
Scenario Orbit Viewsscenario-labs/skills946—~2.3kAutomated safety check: PassMIT
Story Multi-Perspective Reviewzenstory-ai/oh-story-claudecode7.4k3 repos~3kAutomated safety check: PassMIT
Short Web Fiction Trend Scanzenstory-ai/oh-story-claudecode7.4k2 repos~1.2kAutomated safety check: PassMIT
InkOS Creative HarnessNarcooo/inkos10k1 repos~1.1kAutomated safety check: PassAGPL-3.0
Novel Arteternityspring/shuohao-skills4.3k—~1.1kAutomated safety check: NotesApache-2.0

Similar skills

  • Scenario Orbit Views

    scenario-labs/skills

    A skill your agent uses when a single image of a character, creature, prop, vehicle, or building must be seen from new camera angles through the Scenario MCP server: turnarounds, a 360 orbit, views…

    946 GitHub stars~2.3k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • 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
  • 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 2 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.3k GitHub stars~1.1k tokensUpdated 2 days ago
    Writing & ContentAuto-check: notes
  • Sepia

    Nanako0129/sepia

    Make AI-generated writing read as human-written, in fiction and in professional prose.

    3.1k GitHub stars~3.6k tokensUpdated yesterday
    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…

    105 GitHub stars~1.6k tokensUpdated 3 days ago
    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).

    105 GitHub stars~495 tokensUpdated 3 days ago
    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…

    105 GitHub stars~1.7k tokensUpdated 3 days ago
    Auto-check passed
  • Novel Reference Analysis Method

    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…

    105 GitHub stars~1.1k tokensUpdated 3 days ago
    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…

    105 GitHub stars~695 tokensUpdated 3 days ago
    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.

    105 GitHub stars~392 tokensUpdated 3 days ago
    Auto-check passed

Questions about Novel Style Reference

What does Novel Style Reference do?

A real-novel writing style reference library backed by the novelquerystylereference MCP tool. Novel Style Reference is an agent skill from yannikzz/narracat-novel-agent. A real-novel writing style reference library backed by the novelquerystylereference MCP tool.

When should I use Novel Style Reference?

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

How do I install Novel Style Reference in Claude Code?

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

How do I install Novel Style Reference in Codex?

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

Can I use Novel Style Reference 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-style-reference -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-style-reference, .gemini/skills/novel-style-reference, .github/skills/novel-style-reference and .opencode/skills/novel-style-reference in your project.

What does Novel Style Reference need to run?

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

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

Novel Style Reference 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 Style Reference use?

About 391 tokens (SKILL.md is roughly 1.6k 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 Style Reference?

Skills that share tags, products or a category with Novel Style Reference: Scenario Orbit Views (scenario-labs/skills, 946 stars), Story Multi-Perspective Review (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 Style Reference?

yannikzz (a GitHub user) maintains it in yannikzz/narracat-novel-agent, which has 105 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.