Agent skill

Novel Memory Integration

by yannikzz in yannikzz/narracat-novel-agent

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

AGPL-3.0Auto-check passedWriting & Content

Install Novel Memory Integration

skills CLI
$ npx skills add yannikzz/narracat-novel-agent --skill novel-memory-integration -a claude-code

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

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

At a glance

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

  • The user asks about character state
  • SKILL.md covers 工具速查, 选择工具, 无结果与异常 and 边界
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Chapter summaries

What it does

Novel Memory Integration is an agent skill from yannikzz/narracat-novel-agent. Guide for answering natural language questions about novel content by querying NovelMemory MCP read tools from the main conversation. Use when the user asks about character state, relationships, chapter summaries, arc progress, foreshadowing status, or review verdicts of the current novel project.

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

  • The user asks about character state
  • Chapter summaries
  • Foreshadowing status
  • Review verdicts of the current novel project

Example prompts

  • “/novel-memory-integration”

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 Memory Integration loads about 392 tokens when it runs. Until then it costs about 81 tokens; SKILL.md has 85 words of instructions outside code blocks.

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

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). 85 words, ~392 tokens.

Download SKILL.mdSave it as .claude/skills/novel-memory-integration/SKILL.md (or your agent's skills folder).
name
novel-memory-integration
description
Guide for answering natural language questions about novel content by querying NovelMemory MCP read tools from the main conversation. Use when the user asks about character state, relationships, chapter summaries, arc progress, foreshadowing status, or review verdicts of the current novel project.

当用户用自然语言询问小说内容(角色、情节、设定、伏笔、审校结果)时,调用 NovelMemory MCP 读工具检索后作答。

工具速查

工具用途典型问题
novel_query混合检索(全文+语义,最通用)"关于古戒指的线索有哪些"
novel_chapter_summary章节摘要(单章或范围)"第20章讲了什么" / "最近三章发生了什么"
novel_character_state角色截至某章的状态"张三在第30章是什么身份"
novel_relationship两个角色的关系"张三和李四什么关系"
novel_foreshadowing_status伏笔状态"还有哪些伏笔没揭示"
novel_get_arc章节所属 arc 的核心问题与区间"当前这个剧情单元在讲什么"
novel_get_review某章审校结论与遗留问题"第12章审校通过了吗"
novel_writing_context写作前上下文聚合"为下一章做写作准备"

选择工具

  • 问题指向某章 / 某伏笔 → 用对应专用工具填章号 / id。
  • 问题指向某角色(novel_character_state / novel_relationship)→ 先 Read 该角色档案 bible/characters/<名>.md 顶部 character_identity 取 character_uid,再按 uid 调用。
  • 模糊或开放问题 → novel_query,用短查询词(人名、物件名、事件短语),不要把整段话塞进去。
  • 跨维度问题 → 组合调用:先用专用工具拿事实,再用 novel_query 补相关段落。

例:「张三和李四的关系这几章怎么变的」→ Read 两角色档案取各自 character_uid → novel_relationship 拿当前状态 + novel_chapter_summary 拉相关章摘要,对照作答。

无结果与异常

  • novel_query 无结果 → 换更短、更具体的查询词重试一次。
  • 仍无结果 → 告知用户该信息未入库,建议直接读 manuscript/ 对应章节。
  • 工具报错 → 检查 .narracat/config.yaml 是否存在、novel_id 是否配置。

边界

  • 查询结果反映已入库状态;刚写完尚未收尾入库的章节直接读 manuscript/。
  • 本场景只读不写;所有结构化写入由各 agent 持有的提交工具完成。

© 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-memory-integration of yannikzz/narracat-novel-agent.

Open the folder on GitHubat commit 2c49f9f

Compare with similar skills

Novel Memory Integration 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 Memory Integration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Novel Memory Integration this skillyannikzz/narracat-novel-agent105—~392Automated 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 Style Reference

    yannikzz/narracat-novel-agent

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

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

Questions about Novel Memory Integration

What does Novel Memory Integration do?

Guide for answering natural language questions about novel content by querying NovelMemory MCP read tools from the main conversation. Novel Memory Integration is an agent skill from yannikzz/narracat-novel-agent. Guide for answering natural language questions about novel content by querying NovelMemory MCP read tools from the main conversation.

When should I use Novel Memory Integration?

Novel Memory Integration fits situations like: the user asks about character state; chapter summaries; foreshadowing status; review verdicts of the current novel project.

How do I install Novel Memory Integration in Claude Code?

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

How do I install Novel Memory Integration in Codex?

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

Can I use Novel Memory Integration 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-memory-integration -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-memory-integration, .gemini/skills/novel-memory-integration, .github/skills/novel-memory-integration and .opencode/skills/novel-memory-integration in your project.

What does Novel Memory Integration need to run?

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

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

Novel Memory Integration 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 Memory Integration use?

About 392 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 Memory Integration?

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

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.