qiaomu-novel-generator skill

A skill for original Chinese short fiction: you pick a plot strategy and outline first, then it writes and runs quality checks

  • 397 ★ on the repository
  • Last commit
  • MIT
Skill

Minimal access

Why this level

  • The skill supplies instructions for text and runs nothing itself
  • To look up reference works the agent may use the network if the environment allows
All reasons and checks

joeseesun/qiaomu-novel-generator

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/qiaomu-novel-generator

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Minimal accessThe tool runs nothing and makes no network calls.

  • The skill supplies instructions for text and runs nothing itself
  • To look up reference works the agent may use the network if the environment allows

This is third-party code. Review the repository files before installing.

What it does

qiaomu-novel-generator writes original short stories in Chinese, from wuxia and xianxia to mystery, sci-fi and office intrigue. Before the prose, the skill turns your idea into a plot strategy: what is promised to the reader, which relationships press on the hero, where the conflict plays out, which devices lift the plot and what aftertaste the ending leaves. You choose options with short replies such as "default", "1B 2A 3C" or "sharper". Then come an outline for confirmation and the full text. The skill breaks famous plots into functions and reassembles them without copying characters, lines or event chains. To build on a known work it can search for public information first, if the environment allows search. Each story is checked against criteria: a hook at the start, the hero's desire, rising conflict, dialogue tension, the ending, clarity of the opening and freedom from templated phrasing typical of generation. The package includes reference guides on techniques, sample stories in `examples/` and an `evaluate_story.py` script that checks a text against the rules.

Who it is for. Authors of Chinese prose and web novels and short-drama writers who want a structural co-writer that helps plan the plot before writing.

Good fit when

  • You have only a genre and a mood with no plot and want a choice of plot strategies
  • You need a finished wuxia or xianxia story with a hook at the start and a strong ending
  • You want to move a favorite plot into office intrigue without repeating the original's characters and scenes
  • A finished draft feels formulaic and needs a check for stock phrasing and a clear opening

Not a fit when

  • You need text in Russian or English: the skill is built for Chinese prose
  • You need a multi-volume novel by chapters: the skill targets a short story, and the catalog has others for long forms
  • You want to imitate a living author's style line by line: the author's boundary forbids that
  • You need a retelling or continuation of someone else's copyrighted text

Example request

Use qiaomu-novel-generator to write a complete wuxia short story in Chinese about a scholar with no martial skill who stumbles into a deadly trap

Limitations

The skill works with Chinese text, and its interface and reference guides are in Chinese. To search open sources before writing, the agent's environment needs network access. The author states that the skill copies no protected text and imitates no living authors' style. Checking that is up to you. The `validate_skill.py` and `evaluate_story.py` scripts are meant to be run by hand from the skill folder. The repository was last changed in June 2026.

How to disable. Delete the `qiaomu-novel-generator` folder from `.agents/skills/` in the project or the home directory.

FAQ

How does the plot choice before the text work?

The skill gives short option groups: the main emotion, the pressure relationship and the conflict arena. You answer with codes like `1B 2A 3C` or the word "default", and only then does it write the outline and story.

Does the skill copy famous works?

No, by the author's statement it takes only plot functions: a fall and return, a shadow trade, a public trial. It does not carry the original's characters, lines, named scenes or event chains into the new story.

What does the check for stock phrasing mean?

The skill removes stock contrast formulas, summing-up lines and decorative dashes, and fixes an opening whose imagery misleads about the genre. The author gives a concrete example in the description.

Can a finished text be checked with the script?

Yes, `python3 scripts/evaluate_story.py examples/sample-01-wuxia-suspense.md --fail-on-warning` scores a story against the rules and fails on a warning. Put your own file in place of the sample.

Which agents fit?

Any agent that supports skills, such as Codex or Claude Code. The package includes `agents/openai.yaml` for Codex and `agents/interface.yaml`.

Discussion

No questions or reviews yet.

Skills

A skill helps Codex plan Chinese web fiction, revise scenes and check character actions against earlier chapters

SkillExtended access1KRepository stars

A skill for writing a complete Chinese novel chapter by chapter: three-layer intake, preference memory, cliffhangers and automatic validation

SkillExtended access4.8KRepository stars

31 skills for screen stories: novel screening, plot and character analysis, adaptation scoring and a vertical series script

SkillExtended access508Repository stars

A Codex and Claude skill for short Chinese fiction from topic choice to release and review: the human decides, AI speeds up

SkillMinimal access210Repository stars

A novel-writing skill with nine agents: setting, volume and chapter plans, prose, a machine-style check and an archive with character memory

SkillExtended access866Repository stars

A skill for multi-volume novels: 30-plus protocol files keep world, characters and style consistent from chapter to chapter

SkillMinimal access159Repository stars

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialRepository starsMain difference
qiaomu-novel-generator (this card)no397
chinese-novelistno4,813writes a whole novel by chapters with preference memory, while this is a short story with a chosen plot strategy
Chinese-WebNovel-Skillno1,006helps plan a novel and check characters against chapters, while this is one story checked against criteria
Webnovel Writerno7,939a plugin for long web novels with character memory, while this is a skill for short stories

README in short

The description in Chinese and English explains how the skill differs from ordinary generators, shows the reply format and two sample stories. Then come installation, prerequisites, sample requests, a process diagram, a table of plot engines, quality criteria, usage boundaries and troubleshooting.

README badge

Original SKILL.md

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

Report a problem