Agent skill

Novel Diag

by Xiaoyangy in Xiaoyangy/novel-studio

诊断当前项目的 output 产物,从流程/质量/规划/上下文四维给出可执行发现,并写出脱敏报告。触发:「诊断这本书」「为什么卡住了」「检查创作有没有问题」「生成 diag 报告贴 issue」。

Apache-2.0Auto-check passedWriting & Content

Install Novel Diag

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

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

GitHub CLI
$ gh skill install Xiaoyangy/novel-studio novel-diag --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/novel-diag .claude/skills/novel-diag && 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-diag
GitHub stars
131
Token cost
~203 tokens
SKILL.md length
42 words
Files
3
Skills in repo
18
Repo updated
First seen
Licence
Apache-2.0

At a glance

诊断当前项目的 output 产物,从流程/质量/规划/上下文四维给出可执行发现,并写出脱敏报告。触发:「诊断这本书」「为什么卡住了」「检查创作有没有问题」「生成 diag 报告贴 issue」。

  • Tasks that involve Creative writing and fiction
  • SKILL.md covers 前置条件, 执行, 诊断维度 and 产物
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Novel Diag is an agent skill from Xiaoyangy/novel-studio. 诊断当前项目的 output 产物,从流程/质量/规划/上下文四维给出可执行发现,并写出脱敏报告。触发:「诊断这本书」「为什么卡住了」「检查创作有没有问题」「生成 diag 报告贴 issue」。

Its SKILL.md is about 200 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 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

  • “/novel-diag”

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 (its code samples are bash).

    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 Diag loads about 203 tokens when it runs. Until then it costs about 27 tokens; SKILL.md has 42 words of instructions outside code blocks.

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

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). 42 words, ~203 tokens.

Download SKILL.mdSave it as .claude/skills/novel-diag/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
novel-diag
description
诊断当前项目的 output 产物,从流程/质量/规划/上下文四维给出可执行发现,并写出脱敏报告。触发:「诊断这本书」「为什么卡住了」「检查创作有没有问题」「生成 diag 报告贴 issue」。

novel-diag:项目产物诊断

对当前项目(cwd 的 output 产物)做静态分析,在终端打印本地 Findings,产出可执行的 发现和改进建议,并写出一份已脱敏的 meta/diag-export.md(移除正文,仅留行为骨架), 适合贴到 GitHub issue。

前置条件

  • 已完成首次配置(见 skills/README.md)。
  • 在项目目录下运行(含 output/novel/)。

执行

bash
novel-studio --diag

诊断维度

  • 流程 — 改写循环卡顿、未消费的转向指令、阶段/流程状态异常、章节跳号、流水线证据漂移
  • 质量 — 评审维度持续低分、合同履约率、改写率、章节字数异常
  • 规划 — 伏笔停滞、指南针过时、大纲耗尽、摘要缺失
  • 上下文 — 角色消失、时间线缺口、关系数据停滞

产物

  • 终端报告:本地可读 Findings(可能包含剧情/伏笔/流程细节,不适合直接贴 issue)
  • meta/diag-export.md(脱敏行为骨架)

diag 会只读检查 meta/pipeline.json:已完成阶段若缺少 evidence、证据状态不是 verified、或证据指向的 artifact/checkpoint 已不存在,会在 Findings 中报告;它不会 自动清除阶段标记或重跑流水线。

随时对已有项目单独诊断。

© 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 2 other files in skills/novel-diag of Xiaoyangy/novel-studio.

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

Open the folder on GitHubat commit ed04a10

Compare with similar skills

Novel Diag 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 Diag compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Novel Diag this skillXiaoyangy/novel-studio131—~203Automated 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 3 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 2 days ago
    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 yesterday
    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 18 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 18 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 18 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 18 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 18 days ago
    Auto-check passed
  • Novel Pipeline

    Xiaoyangy/novel-studio

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

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

Questions about Novel Diag

What does Novel Diag do?

诊断当前项目的 output 产物,从流程/质量/规划/上下文四维给出可执行发现,并写出脱敏报告。触发:「诊断这本书」「为什么卡住了」「检查创作有没有问题」「生成 diag 报告贴 issue」。. Novel Diag is an agent skill from Xiaoyangy/novel-studio.

When should I use Novel Diag?

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

How do I install Novel Diag in Claude Code?

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

How do I install Novel Diag in Codex?

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

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

What does Novel Diag need to run?

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

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

Novel Diag 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 Novel Diag use?

About 203 tokens (SKILL.md is roughly 812 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 Diag?

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

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.