Agent skill

Story

by Xiaoyangy in Xiaoyangy/novel-studio

网络小说工具箱主入口。根据用户需求自动路由到对应 skill;当用户意图不明确时触发,由路由逻辑分发到具体的拆文/写作/去AI味/审查 skill。触发方式:/story、$story、/网文、「我想写小说」「帮我写书」「写网文」。

Apache-2.0Auto-check passedWriting & Content

Install Story

skills CLI
$ npx skills add Xiaoyangy/novel-studio --skill story -a claude-code

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

GitHub CLI
$ gh skill install Xiaoyangy/novel-studio story --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/Xiaoyangy/novel-studio.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/story .claude/skills/story && 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
story
GitHub stars
131
Token cost
~721 tokens
SKILL.md length
210 words
Files
4
Skills in repo
18
Repo updated
First seen
Licence
Apache-2.0

At a glance

网络小说工具箱主入口。根据用户需求自动路由到对应 skill;当用户意图不明确时触发,由路由逻辑分发到具体的拆文/写作/去AI味/审查 skill。触发方式:/story、$story、/网文、「我想写小说」「帮我写书」「写网文」。

  • Works in 5 steps: 分析用户请求,提取意图关键词 → 匹配上表,找到对应的 skill → 如果能明确匹配,直接调用对应 skill(Claude/OpenCode 可用… → …
  • Tasks that involve Creative writing and fiction
  • SKILL.md covers novel-studio 适配优先级, 路由表, 路由流程 and 查询降级, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Story is an agent skill from Xiaoyangy/novel-studio. 网络小说工具箱主入口。根据用户需求自动路由到对应 skill;当用户意图不明确时触发,由路由逻辑分发到具体的拆文/写作/去AI味/审查 skill。触发方式:/story、$story、/网文、「我想写小说」「帮我写书」「写网文」。

Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `CONTEXT.md` and `context.json`).

It sits in Writing & Content, covering Creative writing and fiction. The repository describes itself as: 开源、本地优先的 AI 长篇小说创作引擎:多智能体世界推演、按弧规划、RAG 长程记忆、逐章审核与断点恢复 | Open-source AI novel generator for long-form fiction. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Creative writing and fiction

Example prompts

  • “/story”

Workflow steps

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

  1. 分析用户请求,提取意图关键词
  2. 匹配上表,找到对应的 skill
  3. 如果能明确匹配,直接调用对应 skill(Claude/OpenCode 可用 Skill("skill-name") 或 slash command;Codex 用 $skill-name / /skills;OpenClaw 用 /skill skill-name…
  4. 如果无法匹配,询问用户想做什么(从上表中选择)
  5. 如果用户说"我想写小说"但未指定长篇/短篇,询问篇幅类型后再路由

What it can do on your machine

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

Story loads about 721 tokens when it runs. Until then it costs about 31 tokens; SKILL.md has 210 words of instructions outside code blocks.

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

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 Xiaoyangy/novel-studio at commit ed04a10, republished under its Apache-2.0 licence (© Xiaoyangy). 210 words, ~721 tokens.

Download SKILL.mdSave it as .claude/skills/story/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
story
description
网络小说工具箱主入口。根据用户需求自动路由到对应 skill;当用户意图不明确时触发,由路由逻辑分发到具体的拆文/写作/去AI味/审查 skill。触发方式:/story、$story、/网文、「我想写小说」「帮我写书」「写网文」。

story:网文工具箱路由

你是网文工具箱的路由入口。用户的请求模糊时由你分发到具体 skill。

novel-studio 适配优先级

当前仓库内存在 cmd/novel-studio 时,原生写作请求必须路由到 novel-studio pipeline:

  • 长篇 / 短篇 / 续写 / 重写 / 评审 / 完稿导出:必须路由到 novel-pipeline、novel-write、novel-review、novel-rewrite 或专项 novel-douban-write。
  • 即使用户显式点名 story-long-write、story-short-write 或用“继续生成正文”等自然语言描述,也必须把这些 skill 当作方法论和 prompt 增强参考,最终执行 novel-studio --pipeline。
  • 禁止直接生成、续写或改写正文;不要绕过 novel-studio --pipeline 直接手写章节文件。
  • 拆文、去 AI 味、审查等非写作执行能力仍按下表路由。

路由表

Codex CLI 中优先使用 $story-* 或 /skills 触发;Claude Code / OpenCode 继续使用 /story-*;OpenClaw 可用 /skill story-* 或自然语言点名 skill。下表以 slash command 展示,Codex 可将 /story-long-write 等价替换为 $story-long-write,OpenClaw 可将其等价替换为 /skill story-long-write。

用户意图关键词示例路由到
豆瓣原创长篇豆瓣长篇、豆瓣阅读、豆瓣写作、15W-30W 原创长篇novel-douban-write / novel-pipeline
写长篇开书、写大纲、长篇、连载、日更、续写、继续生成novel-write / novel-pipeline
写短篇短篇、盐言、一万字、故事成稿novel-write / novel-pipeline
短篇拆文拆短篇、分析这个故事/story-short-analyze
去 AI 味去 AI 味、太 AI、去味/story-deslop
环境部署准备写书、搭环境、初始化/story-setup
切换/列出书目切书、换书、列出我的书、我在写哪几本、切换项目见下方「多书切换」
查故事资料查角色、查伏笔、查进度、查设定、什么状态、写到哪了spawn story-explorer agent(结构化 prompt:项目目录:{dir}\n查询类型:{根据意图选择}\n查询参数:{用户查询});agent 不可用时见下方「查询降级」
查资料查资料、帮我查资料、调研、搜索一下、搜一下spawn story-researcher agent;agent 不可用时见下方「查询降级」

路由流程

  1. 分析用户请求,提取意图关键词
  2. 匹配上表,找到对应的 skill
  3. 如果能明确匹配,直接调用对应 skill(Claude/OpenCode 可用 Skill("skill-name") 或 slash command;Codex 用 $skill-name / /skills;OpenClaw 用 /skill skill-name 或自然语言点名)
  4. 如果无法匹配,询问用户想做什么(从上表中选择)
  5. 如果用户说"我想写小说"但未指定长篇/短篇,询问篇幅类型后再路由

查询降级

「查故事资料」「查资料」走 agent 前先做轻量可用性检查(路由只做这一层,不承担全局部署策略):当前不在子代理上下文、Agent/Task 工具可用、且 .claude/agents/{story-explorer|story-researcher}.md、.opencode/agents/{story-explorer|story-researcher}.md 或 .codex/agents/{story-explorer|story-researcher}.toml 存在 → 可尝试 spawn。任一不满足,或 Codex 运行时返回 unknown agent_type / 未暴露 custom-agent registry,则降级,不硬失败:

  • story-explorer 不可用 → 主线程直接用 Read/Grep 从项目文件检索(角色状态/伏笔/进度/设定),回答前标注 Fallback: agent unavailable -> direct lookup;项目尚未部署时提示先 /story-setup(Codex 中用 $story-setup)。
  • story-researcher 不可用 → 主线程用现有检索/回答能力完成,同样标注 Fallback: agent unavailable -> direct lookup。

项目状态感知

路由前先检查当前项目状态:

  • 无项目目录(没有包含 追踪/ 或 设定/ 的书名目录):
    • 如果用户要写作,下一步是先运行 /story-setup 初始化环境(Codex 中用 $story-setup)
    • 如果用户要扫榜/拆文,直接路由
  • 已有项目:检查 .story-deployed 标记,如未部署则先运行 /story-setup(Codex 中用 $story-setup)

多书切换

用户想切换或查看在写的书时(一个项目可同时有多本):

  1. 在项目根查找所有书目录:包含 追踪/ 或 设定/ 子目录的目录(含 长篇/、短篇/ 下的子目录)。
  2. 列出书名,并标出当前 .active-book 指向的那本。
  3. 让用户选择,把所选书的相对路径写入项目根 .active-book(覆盖原内容)。
  4. 只发现一本时直接确认为活跃书,无需询问。

© Xiaoyangy, 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 3 other files in skills/story of Xiaoyangy/novel-studio.

  • SKILL.md
  • CONTEXT.md
  • VERSION
  • context.json

Open the folder on GitHubat commit ed04a10

Compare with similar skills

Story 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.

Story compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Story this skillXiaoyangy/novel-studio131—~721Automated safety check: PassApache-2.0
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
SepiaNanako0129/sepia3.1k—~3.6kAutomated safety check: PassMIT

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
  • 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
  • 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 stars~1.7k tokensUpdated today
    Writing & ContentAuto-check passed

More from Xiaoyangy/novel-studio

All 18 skills in this repo
  • Story Long Write

    Xiaoyangy/novel-studio

    长篇网文写作方法论与 novel-studio pipeline 适配器。用于把长篇开书、大纲、日更、续写、重写等需求整理为 pipeline 输入;在 novel-studio 内禁止直接生成正文。触发方式:/story-long-write、/写长篇、「帮我开书」「写大纲」「日更」「续写」「继续写」「修改第X章」「回炉」「重写第X章」。

    131 GitHub stars~9k tokensUpdated 17 days ago
    Auto-check passed
  • Story Short Write

    Xiaoyangy/novel-studio

    短篇网文写作方法论与 novel-studio pipeline 适配器。用于把短篇、盐言故事、拆文续写等需求整理为 pipeline 输入;在 novel-studio 内禁止直接生成正文。触发方式:/story-short-write、/写短篇、「帮我写一篇短篇」「写个盐言故事」。

    131 GitHub stars~5.6k tokensUpdated 17 days ago
    Auto-check passed
  • Story Douban Long Write

    Xiaoyangy/novel-studio

    豆瓣阅读原创长篇专项方法论与 novel-studio pipeline 适配器。用于把 15W-30W 字原创长篇的主题、类型、开头、文字、标签、简介和提交自检要求整理为 pipeline 输入;在 novel-studio 内禁止直接生成正文。触发方式:/story-douban-long-write、/豆瓣长篇、/豆瓣写作、「写一部豆瓣阅读原创长篇」「按豆瓣要求写长篇」。

    131 GitHub stars~1k tokensUpdated 17 days ago
    Auto-check passed
  • Story Short Analyze

    Xiaoyangy/novel-studio

    短篇网文拆文。拆解爆款短篇小说(番茄短篇 / 故事会 / 知乎盐选 / 追妻 / 世情 / 重生 / 虐渣等通俗题材)的故事核、结构、情感线、反转设计、写作手法、共鸣层次。单一全量拆解管道:跑完 Stage 2-6 产出完整拆文报告,落盘到 deconstruction-library/{书名}/,下游 story-short-write 同时读拆文报告 + 情节节点 + 写作手法 + 原文…

    131 GitHub stars~2.3k tokensUpdated 17 days ago
    Auto-check passed
  • AI Novel Audit

    Xiaoyangy/novel-studio

    审核一段/一篇小说(或任意叙事性文本)的「AI 创作度」——判断它有多大可能由 AI 生成、或 AI 参与了多少。当用户想知道一段文字是不是 AI 写的、AI 味重不重、是人工还是 AI、AI 辅助了多少、帮忙鉴别/检测/审稿 AI 生成内容、给稿件的「人味/机味」打分时,都使用本技能。触发词包括但不限于:AI 创作度、AI 味、是不是 AI 写的、AI 生成检测、人工还是 AI、鉴别…

    131 GitHub stars~3.1k tokensUpdated 17 days ago
    Auto-check passed
  • Novel Pipeline

    Xiaoyangy/novel-studio

    把各功能串成一条可恢复的流水线:(共创→)写作→评审→重写→交付,按阶段执行、断点续跑。触发:「一条龙写完整本书」「从头跑完整个流程」「中断后接着跑」,想要无人值守端到端、且能中断恢复时使用。

    131 GitHub stars~632 tokensUpdated 17 days ago
    Auto-check passed

Questions about Story

What does Story do?

网络小说工具箱主入口。根据用户需求自动路由到对应 skill;当用户意图不明确时触发,由路由逻辑分发到具体的拆文/写作/去AI味/审查 skill。触发方式:/story、$story、/网文、「我想写小说」「帮我写书」「写网文」。. Story is an agent skill from Xiaoyangy/novel-studio.

When should I use Story?

Story fits situations like: tasks that involve Creative writing and fiction.

How do I install Story in Claude Code?

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

How do I install Story in Codex?

Run `npx skills add Xiaoyangy/novel-studio --skill story -a codex`. Or copy the skill folder (skills/story in Xiaoyangy/novel-studio) into .agents/skills/story in your project. Codex loads it when a task matches its description.

Can I use Story 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 Xiaoyangy/novel-studio --skill story -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/story, .gemini/skills/story, .github/skills/story and .opencode/skills/story in your project.

What does Story need to run?

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

Does Story 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 Story 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 Story use?

Story 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 Story use?

About 721 tokens (SKILL.md is roughly 2.9k 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 Story?

Skills that share tags, products or a category with Story: 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), InkOS Creative Harness (Narcooo/inkos, 10k stars) and Novel Art (eternityspring/shuohao-skills, 4.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Story?

Xiaoyangy (a GitHub user) maintains it in Xiaoyangy/novel-studio, which has 131 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on September 23, 2026.

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