Agent skill

Chinese Novelist Chapter Writer

by PenglongHuang in PenglongHuang/chinese-novelist-skill

Writes long Chinese novels chapter by chapter through guided questions, outlining, drafting with cliffhangers and automatic validation, with resumable projects.

MITAuto-check: warningsWriting & Content

SKILL.md written in Chinese; this summary is our English description.

Install Chinese Novelist Chapter Writer

The automated check flagged lines worth reading first. See the safety section below.

skills CLI
$ npx skills add PenglongHuang/chinese-novelist-skill --skill chinese-novelist -a claude-code

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

GitHub CLI
$ gh skill install PenglongHuang/chinese-novelist-skill chinese-novelist --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
chinese-novelist
GitHub stars
3.3k
Token cost
~491 tokens
SKILL.md length
74 words
Files
31 (incl. scripts, references, assets)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Writes long Chinese novels chapter by chapter through guided questions, outlining, drafting with cliffhangers and automatic validation, with resumable projects.

  • Works in 3 steps: 展示而非讲述 - 用动作和对话表现,不要直接陈述 → 冲突驱动剧情 - 每章必须有冲突或转折 → 悬念承上启下 - 每章结尾必须留下钩子
  • Writing a multi-chapter Chinese web novel from a premise
  • SKILL.md covers 三大黄金法则, 特性说明, 核心流程 and 共享机制
  • Resuming an interrupted novel project

What it does

The skill supports genres such as mystery, romance, fantasy, science fiction and history, and novels of 10 to 50 chapters of roughly 3000 to 5000 characters each, with a suspense hook closing every chapter and polishing meant to remove AI traces. Three rules guide the prose: show through action and dialogue rather than telling, drive each chapter with conflict or a turn, and link chapters through suspense. Each phase has its own flow document under `references/flows/`.

The process starts with loading your preferences and detecting unfinished projects, then asks three layers of questions about core premise, customization and a title. It creates a project folder with an outline, character profiles and a writing-plan JSON and waits for your approval. You then pick serial writing, parallel sub-agents or Agent Teams, after which chapters are written without further confirmation, following the outline. A final phase checks completeness and word counts and rewrites failing chapters for up to three rounds.

When your agent uses it

  • Writing a multi-chapter Chinese web novel from a premise
  • Resuming an interrupted novel project
  • Planning an outline and character profiles before drafting
  • Checking chapter word counts and quality across a finished draft

Example prompts

  • “Write a Chinese mystery novel set in a mountain village, with a cliffhanger at the end of each chapter.”
  • “Resume my unfinished novel project and continue from the last completed chapter.”
  • “Plan an outline and character profiles for a Chinese historical romance, then wait for my approval.”
  • “Validate every chapter of my novel for word count and rewrite the weak ones.”

Workflow steps

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

  1. 展示而非讲述 - 用动作和对话表现,不要直接陈述
  2. 冲突驱动剧情 - 每章必须有冲突或转折
  3. 悬念承上启下 - 每章结尾必须留下钩子

What it can do on your machine

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

    Ships 1 file in scripts/, which the agent can run.

    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

Chinese Novelist Chapter Writer loads about 491 tokens when it runs, and up to ~39k if it reads all its reference files. Until then it costs about 38 tokens; SKILL.md has 74 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
~491
With references · SKILL.md plus every file in references/, read only if the agent opens them
~39k

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: warnings

The automated check found patterns that need a careful read before installing.

  • WarningTells the agent its actions are pre-authorized / not to stop for confirmationSKILL.md:54
    ### 第三阶段:疯狂创作(无需用户确认)

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); the scripts in this folder are not scanned.

SKILL.md

The full file from PenglongHuang/chinese-novelist-skill at commit 6a64a04, republished under its MIT licence (© PenglongHuang). 74 words, ~491 tokens.

Download SKILL.mdSave it as .claude/skills/chinese-novelist/SKILL.md (or your agent's skills folder). This skill also uses 30 other files; get the full folder from GitHub.
name
chinese-novelist
description
分章节创作引人入胜的中文小说。支持各种题材(悬疑/言情/奇幻/科幻/历史等),支持10-50章长篇创作,每章3000-5000字,结尾设置悬念钩子。强调深度润色去除AI痕迹,确保文字自然流畅。 当用户要求:写小说、创作故事、分章节写作、连续剧情、章节悬念、长篇小说时使用。
metadata.trigger
创作中文小说、分章节故事、长篇小说创作
metadata.source
基于小说创作最佳实践设计

Chinese Novelist: 中文小说创作助手

三大黄金法则

  1. 展示而非讲述 - 用动作和对话表现,不要直接陈述
  2. 冲突驱动剧情 - 每章必须有冲突或转折
  3. 悬念承上启下 - 每章结尾必须留下钩子

特性说明

  • 中断续写:自动检测未完成项目,从断点继续创作
  • 自动校验:创作完成后自动检查字数和质量,不合格自动修复
  • 并行写作(可选):支持子Agent并行写作,通过 02-写作计划.json 协调状态

核心流程

进入每个阶段时,先阅读对应的流程文档以获取详细执行指令。

第0步:初始化与偏好加载

读取用户偏好,检测未完成项目(中断续写),展示个性化欢迎。 → 详见 phase0-initialization.md

第一阶段:三层递进式问答

通过递进式问答收集创作需求,确定小说定位与标题:

  • 核心定位(必答,Q1-Q3):题材创意、主角设定、核心冲突 → 详见 phase1-layer1-core.md
  • 深度定制与规格(Q4-Q8):世界观、视角基调、核心主题、读者定位、章节数量、配置确认 → 详见 phase1-layer2-customize.md
  • 标题生成:AI 基于创意元素生成候选标题,用户选择或自定义 → 详见 phase1-layer3-title.md
第二阶段:规划 + 二次确认

创建项目文件夹(./chinese-novelist/{timestamp}-{小说名称}/),生成大纲、人物档案和写作计划JSON,等待用户确认。 → 详见 phase2-planning.md

第2.5步:写作模式选择

规划确认后,选择写作模式:

  • 逐章串行(serial):主 Agent 自己逐章写,全程无中断
  • 子Agent并行(subagent-parallel):将章节分成批次,派生子 Agent 并行写作
  • Agent Teams(agent-teams):Claude Code 多 Agent 协作模式,Agent 间可通讯(需手动开启)

→ 详见 phase3-writing.md

第三阶段:疯狂创作(无需用户确认)

切记,一旦进入这个阶段,所有过程都禁止向用户确认。用户就是你的读者,你必须把完整的小说创作完成才能与用户报告

根据用户选择的写作模式(串行/并行/Teams)逐章执行创作流程。每章创作前必须读取 01-大纲.md 中对应章节的规划信息,严格按大纲创作。支持中断续写。 → 详见 phase3-writing.md

第四阶段:自动校验与修复(无需用户确认)

全程无需用户介入,自动检查所有章节完成度和字数,不合格章节自动重写(最多3轮)。 → 详见 phase4-validation.md

共享机制

偏好系统、写作计划系统、黄金法则详解、字数检查脚本等跨阶段共享机制。 → 详见 shared-infrastructure.md

© PenglongHuang, MIT. 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 30 other files (scripts, references, assets) in the repository root of PenglongHuang/chinese-novelist-skill.

  • SKILL.md
  • .github/FUNDING.yml
  • LICENSE
  • README.md
  • assets/infistar-banner.png
  • assets/memory-demo.png
  • assets/phase1-qa.png
  • assets/phase2-plan.png
  • assets/phase3-writing.png
  • assets/phase4-done.png
  • references/flows/phase0-initialization.md
  • references/flows/phase1-layer1-core.md
  • references/flows/phase1-layer2-customize.md
  • references/flows/phase1-layer3-title.md
  • references/flows/phase2-planning.md
  • references/flows/phase3-writing.md
  • references/flows/phase4-validation.md
  • … and 14 more

Open the folder on GitHubat commit 6a64a04

Compare with similar skills

Chinese Novelist Chapter Writer 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.

Chinese Novelist Chapter Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Chinese Novelist Chapter Writer this skillPenglongHuang/chinese-novelist-skill3.3k—~491Automated safety check: WarnMIT
Chinese Novel Writing Systemleenbj/novel-creator-skill671—~3.9kAutomated safety check: PassNone
Sun-Style Restrained Narrative WritingKKKKhazix/sun-style-writing403—~1.7kAutomated safety check: PassMIT
Long Story AnalysisNarcooo/inkos10k—~364Automated safety check: PassAGPL-3.0
Short Web Fiction Writeruu201/character-arc583—~3.7kAutomated safety check: PassMIT
Narrative Continuity CriticUfukNode/Noustiny181—~2.3kAutomated safety check: PassMIT

Similar skills

  • Chinese Novel Writing System

    leenbj/novel-creator-skill

    Guides long-form Chinese novel writing from a rough idea through outlines, chapter drafts and quality gates, with file-based memory for a story meant to reach 300万字.

    671 GitHub stars~3.9k tokensUpdated 7 mo ago
    Writing & ContentAuto-check passed
  • Sun-Style Restrained Narrative Writing

    KKKKhazix/sun-style-writing

    Writes Chinese first-person nonfiction in a restrained plain-description style: short sentences, exact numbers, objects that carry feeling and silence at the peak.

    403 GitHub stars~1.7k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Long Story Analysis

    Narcooo/inkos

    Breaks down a full novel or long sample into story mechanisms and style traits the agent can reuse as craft, without copying names or wording.

    10k GitHub stars~364 tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Short Web Fiction Writer

    uu201/character-arc

    Walks an agent through writing a complete short web novel in Chinese, starting from the emotion the reader should feel and building around one twist.

    583 GitHub stars~3.7k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Grades whether a downstream story beat still holds after an upstream insertion, returning a strict JSON verdict of still_valid, needs_rewrite or must_delete.

    181 GitHub stars~2.3k tokensUpdated 5 mo ago
    Writing & ContentAuto-check passed
  • Short Web Novel Deconstruction

    zenstory-ai/oh-story-claudecode

    Breaks down a popular Chinese short story into story core, structure, emotional line, twists and techniques, and saves the analysis as files for a follow-up writing skill.

    7.4k GitHub starsUsed in 1 repo~2k tokens
    Writing & ContentAuto-check passed

Questions about Chinese Novelist Chapter Writer

What does Chinese Novelist Chapter Writer do?

Writes long Chinese novels chapter by chapter through guided questions, outlining, drafting with cliffhangers and automatic validation, with resumable projects. The skill supports genres such as mystery, romance, fantasy, science fiction and history, and novels of 10 to 50 chapters of roughly 3000 to 5000 characters each, with a suspense hook closing every chapter and polishing meant to remove AI traces. Three rules guide the prose: show through action and dialogue rather than telling, drive each chapter with conflict or a turn, and link chapters through suspense.

When should I use Chinese Novelist Chapter Writer?

Chinese Novelist Chapter Writer fits situations like: writing a multi-chapter Chinese web novel from a premise; resuming an interrupted novel project; planning an outline and character profiles before drafting; checking chapter word counts and quality across a finished draft.

How do I install Chinese Novelist Chapter Writer in Claude Code?

Run `npx skills add PenglongHuang/chinese-novelist-skill --skill chinese-novelist -a claude-code`. Or copy the skill folder (the PenglongHuang/chinese-novelist-skill repository) into .claude/skills/chinese-novelist in your project. Claude Code loads it when a task matches its description.

How do I install Chinese Novelist Chapter Writer in Codex?

Run `npx skills add PenglongHuang/chinese-novelist-skill --skill chinese-novelist -a codex`. Or copy the skill folder (the PenglongHuang/chinese-novelist-skill repository) into .agents/skills/chinese-novelist in your project. Codex loads it when a task matches its description.

Can I use Chinese Novelist Chapter Writer 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 PenglongHuang/chinese-novelist-skill --skill chinese-novelist -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/chinese-novelist, .gemini/skills/chinese-novelist, .github/skills/chinese-novelist and .opencode/skills/chinese-novelist in your project.

What does Chinese Novelist Chapter Writer need to run?

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

Does Chinese Novelist Chapter Writer 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 Chinese Novelist Chapter Writer safe to install?

Our automated static check of SKILL.md flagged 1 warning(s): tells the agent its actions are pre-authorized / not to stop for confirmation. Read the flagged lines before installing; the check is not a guarantee either way. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Chinese Novelist Chapter Writer use?

Chinese Novelist Chapter Writer is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Chinese Novelist Chapter Writer use?

About 491 tokens (SKILL.md is roughly 2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 39k tokens, read only when the agent opens those files.

What are the alternatives to Chinese Novelist Chapter Writer?

Skills that share tags, products or a category with Chinese Novelist Chapter Writer: Chinese Novel Writing System (leenbj/novel-creator-skill, 671 stars), Sun-Style Restrained Narrative Writing (KKKKhazix/sun-style-writing, 403 stars), Long Story Analysis (Narcooo/inkos, 10k stars) and Short Web Fiction Writer (uu201/character-arc, 583 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Chinese Novelist Chapter Writer?

PenglongHuang (a GitHub user) maintains it in PenglongHuang/chinese-novelist-skill, which has 3,349 GitHub stars. The repository was last updated on October 6, 2026.

Source: PenglongHuang/chinese-novelist-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.