Agent skill

Novel Check

by Xiaoyangy in Xiaoyangy/novel-studio

LLM 连通性自检:对默认模型与各角色模型做一次最小真实调用,逐一报告 provider/model 是否真的可用。触发:「检查 LLM 能不能用」「测试模型连通」「创作前先确认配置」「为什么一调用就报错」,排查代理未启动 / key 失效 / baseurl 写错时使用。

Apache-2.0Auto-check passedWriting & Content

Install Novel Check

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

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

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

At a glance

LLM 连通性自检:对默认模型与各角色模型做一次最小真实调用,逐一报告 provider/model 是否真的可用。触发:「检查 LLM 能不能用」「测试模型连通」「创作前先确认配置」「为什么一调用就报错」,排查代理未启动 / key 失效 / baseurl 写错时使用。

  • Tasks that involve Creative writing and fiction
  • SKILL.md covers 前置条件, 执行, 参数 and 输出与退出码, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Novel Check is an agent skill from Xiaoyangy/novel-studio. LLM 连通性自检:对默认模型与各角色模型做一次最小真实调用,逐一报告 provider/model 是否真的可用。触发:「检查 LLM 能不能用」「测试模型连通」「创作前先确认配置」「为什么一调用就报错」,排查代理未启动 / key 失效 / baseurl 写错时使用。

Its SKILL.md is about 330 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-check”

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 Check loads about 325 tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 77 words of instructions outside code blocks.

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

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). 77 words, ~325 tokens.

Download SKILL.mdSave it as .claude/skills/novel-check/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
novel-check
description
LLM 连通性自检:对默认模型与各角色模型做一次最小真实调用,逐一报告 provider/model 是否真的可用。触发:「检查 LLM 能不能用」「测试模型连通」「创作前先确认配置」「为什么一调用就报错」,排查代理未启动 / key 失效 / base_url 写错时使用。

novel-check:LLM 连通性自检

加载配置,为默认模型与各角色模型(coordinator / architect / writer / editor)做一次最小真实 Generate 往返,逐一报告是否可用。创作前先跑它,把「配置看起来对、但一调用就崩」的问题前置。

前置条件

  • 已完成首次配置(见 skills/README.md)。

执行

bash
# 自检当前配置的所有模型目标(按 provider/model 去重,每个只 ping 一次)
novel-studio --check

# 调长单次超时(默认 30s)
novel-studio --check --timeout 60s

# 只验证某个备用 provider(不改配置),确认它能用作 fallback
novel-studio --check --provider minimax --model MiniMax-M3

参数

参数默认说明
--timeout <dur>30s单次连通性调用的超时
--provider <name>—只测指定 provider(配置里 providers 的 key 名),需配 --model
--model <model>—配合 --provider 指定要测的模型名

输出与退出码

  • 逐目标:✓ provider/model [角色(主/兜底)] 耗时 或 ✗ ... 错误原因(主模型与配置的兜底都会测)
  • 按角色汇总:✓ 主可用 / ⚠ 主挂但走兜底 / ✗ 主与兜底都挂
  • 退出码:每个具名角色都至少有一条可用路径 → 0(含"降级可用",即主挂走兜底); 某具名角色主与兜底全挂 → 非 0,并提示常见原因(代理未启动 / api_key 失效 / base_url 写错)

配了 roles.<role>.fallbacks 兜底时,自检会一并验证兜底是否真的可用, 让你在主 provider 挂掉时确认"还能不能降级创作"。

典型失败

  • connection refused → 该 provider 的 base_url 指向的服务(如本地代理)没启动
  • 401 / invalid api key → api_key 失效或写错
  • 模型返回空响应 → 连接通但模型名 / 代理路由有问题

© 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-check of Xiaoyangy/novel-studio.

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

Open the folder on GitHubat commit ed04a10

Compare with similar skills

Novel Check 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 Check compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Novel Check this skillXiaoyangy/novel-studio131—~325Automated 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 Novel Check

What does Novel Check do?

LLM 连通性自检:对默认模型与各角色模型做一次最小真实调用,逐一报告 provider/model 是否真的可用。触发:「检查 LLM 能不能用」「测试模型连通」「创作前先确认配置」「为什么一调用就报错」,排查代理未启动 / key 失效 / baseurl 写错时使用。. Novel Check is an agent skill from Xiaoyangy/novel-studio.

When should I use Novel Check?

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

How do I install Novel Check in Claude Code?

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

How do I install Novel Check in Codex?

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

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

What does Novel Check need to run?

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

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

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

About 325 tokens (SKILL.md is roughly 1.3k 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 Check?

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

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.