Agent skill

Qiaomu Novel Generator

by joeseesun in joeseesun/qiaomu-novel-generator

Generate original, complete, highly gripping Chinese short fiction from a story theme, character setup, synopsis, trope, classic-plot inspiration, or draft excerpt.

MITAuto-check passedWriting & Content

Install Qiaomu Novel Generator

skills CLI
$ npx skills add joeseesun/qiaomu-novel-generator --skill qiaomu-novel-generator -a claude-code

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

GitHub CLI
$ gh skill install joeseesun/qiaomu-novel-generator qiaomu-novel-generator --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
qiaomu-novel-generator
GitHub stars
394
Token cost
~2.5k tokens
SKILL.md length
1,232 words
Files
25 (incl. scripts, references, assets)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Generate original, complete, highly gripping Chinese short fiction from a story theme, character setup, synopsis, trope, classic-plot inspiration, or draft excerpt.

  • Works in 12 steps: Intent Hook: identify the input type,… → Source Research Hook: when the user… → Inspiration Remix Hook: when the user… → …
  • The user asks for 小说
  • SKILL.md covers Operating Mode, Hooked Workflow, Output Defaults and Revision Modes, plus 2 more sections
  • Calls python3

What it does

Qiaomu Novel Generator is an agent skill from joeseesun/qiaomu-novel-generator. Generate original, complete, highly gripping Chinese short fiction from a story theme, character setup, synopsis, trope, classic-plot inspiration, or draft excerpt. Use when the user asks for 小说, 短篇小说, 故事, 网文样章, 开篇钩子, 悬念改写, 人物欲望强化, 情节升级, 续写, 经典桥段重构, or wants a blend of excellent writers' general narrative techniques without copying protected text or imitating a living author's distinctive style.

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 29 other files, including scripts, reference files and assets (for example `README.md`, `agents/interface.yaml` and `agents/openai.yaml`).

It sits in Writing & Content, covering Creative writing and fiction. The repository describes itself as: Generate complete, gripping original Chinese short fiction from story ideas with reusable narrative craft hooks. The licence is MIT.

When your agent uses it

  • The user asks for 小说
  • Wants a blend of excellent writers general narrative techniques without copying protected text
  • Imitating a living authors distinctive style

Example prompts

  • “/qiaomu-novel-generator”

Requirements

  • Python 3

Workflow steps

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

  1. Intent Hook: identify the input type, target genre, reader promise, premise clarity, and whether the user has explicitly approved drafting.
  2. Source Research Hook: when the user explicitly asks to search or names a reference that needs current/public context, use…
  3. Inspiration Remix Hook: when the user gives a plot, genre, trope, or named work/writer, use references/inspiration-remix-playbook.md to…
  4. Story Engine Library Hook: select the primary emotional payoff, high-pressure relationship, conflict arena, 2-4 plot engines, escalation…
  5. Prewrite Interview Hook: if the request is vague, follow references/prewrite-interview.md and ask with short numbered choices. Do not…
  6. Story Strategy Hook: if the premise is usable but the outline is not confirmed, provide classic inspiration options, 小说如何吸引人, and a…
  7. Story Engine Hook: after confirmation, extract
  8. Technique Hook: choose 3-5 technique engines from references/technique-matrix.md. Use a mix, not a stack of author imitations.
  9. Plan Hook: build a compact story plan
  10. Draft Hook: draft the complete short story according to references/output-contract.md.
  11. Anti-AI Language Hook: apply references/anti-ai-language.md; rewrite formulaic narration before returning.
  12. Quality Hook: self-check against references/quality-checklist.md and the relevant rubric in references/genre-quality-rubric.md. Revise…

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • x.com
    • github.com

    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

Qiaomu Novel Generator loads about 2.5k tokens when it runs, and up to ~20k if it reads all its reference files. Until then it costs about 105 tokens; SKILL.md has 1,232 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~105
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~20k

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

SKILL.md

The full file from joeseesun/qiaomu-novel-generator at commit d7b42cb, republished under its MIT licence (© joeseesun). 1,232 words, ~2,534 tokens.

Download SKILL.mdSave it as .claude/skills/qiaomu-novel-generator/SKILL.md (or your agent's skills folder). This skill also uses 24 other files; get the full folder from GitHub.
name
qiaomu-novel-generator
description
Generate original, complete, highly gripping Chinese short fiction from a story theme, character setup, synopsis, trope, classic-plot inspiration, or draft excerpt. Use when the user asks for 小说, 短篇小说, 故事, 网文样章, 开篇钩子, 悬念改写, 人物欲望强化, 情节升级, 续写, 经典桥段重构, or wants a blend of excellent writers' general narrative techniques without copying protected text or imitating a living author's distinctive style.

Qiaomu Novel Generator

把一句主题、人物设定、梗概、经典作品信号或已有片段,先通过必要的搜索/桥段拆解收敛成吸引人的剧情策略和大纲,再生成原创、完整、强钩子、高张力、低 AI 味的中文短篇小说。

Copyright (c) 向阳乔木 X: https://x.com/vista8 GitHub: https://github.com/joeseesun/

Operating Mode

Run as a production-lite fiction writing skill.

Default assumptions:

  • The user ultimately wants a complete Chinese short story, but a vague premise should be clarified through compact choices before drafting.
  • Default output length is 1800-4000 Chinese characters unless the user asks for a different length.
  • Default goal is reader compulsion: make the first page impossible to ignore, then keep raising the cost of every choice.
  • Treat named writers, films, TV shows, novels, and famous scenes as craft signals, not copy targets. Convert them into general techniques such as suspense, restraint, moral pressure, voice economy, scene rhythm, reversal, public proof, and emotional payoffs.
  • Do not directly imitate a living author's distinctive style. Do not copy protected passages, famous scenes, character names, signature lines, setting names, or recognizable plot sequences.
  • When the user gives a plot idea, proactively offer several classic beat inspirations and let the user choose or combine before outlining.
  • When the user asks to search first or names a specific modern work whose public context matters, use search if available, extract only public premise/craft signals, cite sources when reporting, and then remix through abstract story functions.
  • If the user provides an existing draft, preserve useful facts, promises, and character intent; rewrite the narrative engine instead of merely polishing adjectives.
  • Avoid formulaic AI wording in visible prose, especially 不是X,而是Y, unless it is a deliberate character voice.
  • A strong opening hook must not create the wrong genre contract. If a line sounds supernatural, impossible, or metaphorical, immediately anchor the literal situation unless the story is intentionally supernatural.

Hooked Workflow

Use hooks as fixed checkpoints. They are conceptual hooks, not mandatory runtime APIs. Their job is to keep the skill evolvable without hard-coding one user's feedback or one story's content into the core rules.

  1. Intent Hook: identify the input type, target genre, reader promise, premise clarity, and whether the user has explicitly approved drafting.
  2. Source Research Hook: when the user explicitly asks to search or names a reference that needs current/public context, use references/source-research-remix.md to gather 3-6 public signals and reduce them to a Research Intake Card.
  3. Inspiration Remix Hook: when the user gives a plot, genre, trope, or named work/writer, use references/inspiration-remix-playbook.md to offer classic beat/style-signal choices before outlining. Reduce references to functions and craft sliders.
  4. Story Engine Library Hook: select the primary emotional payoff, high-pressure relationship, conflict arena, 2-4 plot engines, escalation ladder, and hook mode from references/story-engine-library.md.
  5. Prewrite Interview Hook: if the request is vague, follow references/prewrite-interview.md and ask with short numbered choices. Do not draft the full story yet.
  6. Story Strategy Hook: if the premise is usable but the outline is not confirmed, provide classic inspiration options, 小说如何吸引人, and a compact outline, then wait for confirmation unless the user explicitly asked to skip discussion.
  7. Story Engine Hook: after confirmation, extract:
    • protagonist desire
    • visible obstacle
    • hidden pressure
    • moral or emotional cost
    • reader promise
    • final aftertaste
  8. Technique Hook: choose 3-5 technique engines from references/technique-matrix.md. Use a mix, not a stack of author imitations.
  9. Plan Hook: build a compact story plan:
    • first disturbance within the first 3 paragraphs
    • protagonist makes an active choice
    • conflict escalates at least 3 times
    • each scene reveals one new fact or removes one safe option
    • final turn reframes the opening
  10. Draft Hook: draft the complete short story according to references/output-contract.md.
  11. Anti-AI Language Hook: apply references/anti-ai-language.md; rewrite formulaic narration before returning.
  12. Quality Hook: self-check against references/quality-checklist.md and the relevant rubric in references/genre-quality-rubric.md. Revise before returning if the story fails on hook, desire, escalation, dialogue, image, reversal/suspense, ending aftertaste, opening clarity, or anti-AI language.
  13. Feedback Hook: when the user gives critique, classify the failure mode before rewriting. Do not only patch the current paragraph.
  14. Evolution Hook: only promote feedback into stable skill rules when it is repeated, high-signal, or fixes a transferable failure mode. See references/evolution-loop.md.
  15. If writing a sample, deliverable, or file artifact, run python3 scripts/validate_skill.py from the skill directory before calling it done. When a draft file exists, optionally run python3 scripts/evaluate_story.py <draft-file> for a lightweight metrics report.
Show full SKILL.md (540 more words)Show less

Output Defaults

For a vague new-story request, output a compact option card first. The user should be able to reply 按默认 or 1B 2A 3C.

For a usable premise that has not been confirmed, output:

text
## 经典桥段启发

[3-6 options reduced to reusable functions]

## 小说如何吸引人

[strategy bullets]

## 大纲

[compact outline]

确认后我再写正文。

After the user confirms, or if the user explicitly asks to skip discussion and write directly, output:

text
《标题》

[完整小说正文]

Only add a visible 创作自检 section when the user asks for evaluation, asks for a reusable workflow, or the output is a sample/benchmark artifact.

If the user asks for "按某作家风格", briefly translate the request into craft terms before writing:

text
我会使用可泛化技法:短句留白、对白推进、危险感、命运压力和反转结构;不复刻具体作者的独特表达或已有情节。

Then write the story.

If the user names a living author, do not promise exact imitation. Translate to craft features and continue with an original story.

Revision Modes

Use the same skill for:

  • 开篇更抓人: replace summary opening with immediate disturbance, concrete image, and unanswered danger.
  • 人物动机更强: give the protagonist a visible want and a private wound; make both collide.
  • 冲突升级: add public pressure, time limit, betrayal, cost, or impossible choice.
  • 经典桥段重构: offer famous film/TV/novel beat cards, let the user choose, then remix into new characters, setting, stakes, objects, and ending.
  • 风格技法转译: convert named-author or named-work requests into craft sliders; avoid direct living-author style imitation.
  • 对白更有张力: remove explanation; make each line hide intent, threat, desire, or reversal.
  • 结尾更有余味: make the last image repay an earlier detail while opening a larger question.
  • 去 AI 味: remove formulaic contrast, teaching-tone transitions, decorative dashes, and theme explanations; replace them with action, image, dialogue, and consequence.
  • 开篇误读: if a poetic or compressed hook makes readers misunderstand the literal event or genre, rewrite with a concrete anchor in the same sentence or next sentence.
  • 改成完整短篇: convert outline or fragment into a beginning-middle-end story, not a synopsis.
  • 用户反馈迭代: classify the critique, choose one dominant failure mode, rewrite against that failure, then decide whether the lesson is only task-local or should be added to skill references.

Boundaries

  • Do not copy protected text, famous scenes, unique names, signature artifacts, or recognizable plot beats from copyrighted fiction.
  • Do not copy a recognizable sequence of beats from one source. If using inspiration, change at least setting, relationship, stakes, object/rule, and ending.
  • Do not present a story as "in the exact style of" a living author. Transform the request into general craft features.
  • Do not use real private persons as fictional criminals, villains, abusers, or scandal subjects without clear fictionalization and safety framing.
  • Do not output sexual content involving minors, explicit sexual coercion, instructions for real violence, or content that glamorizes criminal abuse.
  • For sensitive requests, pivot to fictionalized, non-instructional, emotionally focused storytelling.

Reference Files

  • references/technique-matrix.md: technique engines and author-signal-to-craft translation.
  • references/source-research-remix.md: search-first protocol for turning public source context into abstract remix cards.
  • references/inspiration-remix-playbook.md: classic film/TV/novel beat cards, style-signal translation, and remix boundary.
  • references/story-engine-library.md: emotional payoff types, high-pressure relationships, plot engines, escalation ladders, arenas, and hook bank.
  • references/prewrite-interview.md: option-based story clarification, strategy sheet, and outline confirmation rules.
  • references/output-contract.md: story output shape, length, and drafting rules.
  • references/anti-ai-language.md: anti-trope language gate for formulaic AI wording.
  • references/quality-checklist.md: seven-part self-check and repair rules.
  • references/genre-quality-rubric.md: genre-aware quality rubrics for loading the right reader promise.
  • references/evolution-loop.md: hook-based feedback, rule promotion, and anti-overfitting process.
  • examples/sample-01-wuxia-suspense.md:江湖悬疑完整短篇样例与自评。
  • examples/sample-02-sci-fi-memory.md:近未来科幻完整短篇样例与自评。
  • scripts/validate_skill.py: local structural validator for required files and sample self-evaluations.
  • scripts/evaluate_story.py: optional draft metrics reporter for abstraction, dialogue, scene, and hook signals.

© joeseesun, 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 24 other files (scripts, references, assets) in the repository root of joeseesun/qiaomu-novel-generator.

  • SKILL.md
  • .gitignore
  • LICENSE
  • README.md
  • agents/interface.yaml
  • agents/openai.yaml
  • assets/qiaomu-profile/qiaomu_avatar.jpeg
  • assets/qiaomu-profile/qiaomu_reward_qr.png
  • assets/qiaomu-profile/qiaomu_wechat_public_account_qr.jpg
  • examples/sample-01-wuxia-suspense.md
  • examples/sample-02-sci-fi-memory.md
  • manifest.json
  • references/anti-ai-language.md
  • references/evolution-loop.md
  • references/genre-quality-rubric.md
  • references/inspiration-remix-playbook.md
  • … and 9 more

Open the folder on GitHubat commit d7b42cb

Compare with similar skills

Qiaomu Novel Generator 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.

Qiaomu Novel Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Qiaomu Novel Generator this skilljoeseesun/qiaomu-novel-generator394—~2.5kAutomated 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
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 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 yesterday
    Writing & ContentAuto-check passed

Questions about Qiaomu Novel Generator

What does Qiaomu Novel Generator do?

Generate original, complete, highly gripping Chinese short fiction from a story theme, character setup, synopsis, trope, classic-plot inspiration, or draft excerpt. Qiaomu Novel Generator is an agent skill from joeseesun/qiaomu-novel-generator. Generate original, complete, highly gripping Chinese short fiction from a story theme, character setup, synopsis, trope, classic-plot inspiration, or draft excerpt.

When should I use Qiaomu Novel Generator?

Qiaomu Novel Generator fits situations like: the user asks for 小说; wants a blend of excellent writers general narrative techniques without copying protected text; imitating a living authors distinctive style.

How do I install Qiaomu Novel Generator in Claude Code?

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

How do I install Qiaomu Novel Generator in Codex?

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

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

What does Qiaomu Novel Generator need to run?

Going by SKILL.md and its folder, Qiaomu Novel Generator needs the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Qiaomu Novel Generator access the network?

SKILL.md names 2 domains. As links in the text: x.com and github.com. This is read from the text; nothing was executed.

Is Qiaomu Novel Generator 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Qiaomu Novel Generator use?

Qiaomu Novel Generator 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 Qiaomu Novel Generator use?

About 2.5k tokens (SKILL.md is roughly 10k 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 17k tokens, read only when the agent opens those files.

What are the alternatives to Qiaomu Novel Generator?

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

joeseesun (a GitHub user) maintains it in joeseesun/qiaomu-novel-generator, which has 394 GitHub stars. The repository was last updated on June 14, 2026.

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