
novel-creator
Interactive novel creation workflow combining RPG-style storytelling with professional EPUB ebook production. Use when users want to: (1) Create interactive stories/RPG games with branching choices, (2) Write full novels from story concepts, (3) Generate novels with time-travel/fantasy/romance elements, (4) Convert markdown stories to EPUB ebooks, (5) Create Chinese web novels with ancient poetry paired with modern lyrics, (6) Write light novels or serialized fiction. Triggers: "write a novel", "create a story", "interactive fiction", "RPG story", "make an ebook", "穿越小说", "写小说", "创作故事", "制作电子书"
- Installs
- 772
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/mave99a/novel-skill --skill novel-creator- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads novel-creator automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Novel Creator
Transform story ideas into complete novels with EPUB output through an interactive RPG-style workflow.
Workflow
[Story Concept] → [Interactive RPG] → [Writing Plan] → [Chapters] → [EPUB]
Phase 1 Phase 2 Phase 3 Phase 4 Phase 5
Phase 1: Story Setup
Use AskUserQuestion tool to gather:
| Element | Options | Default |
|---|---|---|
| Genre | 穿越/Fantasy/Romance/Mystery | 穿越 |
| Setting | Ancient palace/Modern/Fantasy world | Palace |
| Protagonist | Name, background, abilities | - |
| Goal | What to achieve | Survive and thrive |
| Length | Chapters × words | 10 × 5000 |
Load character personas from references/personas.md based on setting.
Phase 2: Interactive RPG
Run 10-15 decision points where user makes choices via AskUserQuestion:
[Vivid scene description]
↓
AskUserQuestion with 3-4 meaningful choices
↓
[Consequence + next scene]
Required elements to weave in:
- Tech/Knowledge: Modern knowledge as "magic" (phone→照妖镜, chemistry→炼丹)
- Fantasy: Special abilities (灵觉), artifacts (蓄雷珠), prophecies
- Romance: First meeting → mutual help → feelings → confession
Track throughout:
- Key plot points and decisions
- Relationship development stages
- Items and abilities acquired
- Foreshadowing seeds planted
Phase 3: Writing Plan
Create task_plan.md with:
# Writing Plan: [Title]
## Characters
| Name | Role | Traits | Arc |
|------|------|--------|-----|
## Foreshadowing Matrix
| Element | Ch.1 Hint | Development | Payoff |
|---------|-----------|-------------|--------|
| Tech | [seed] | Ch.4 [use] | Ch.9 [climax] |
| Fantasy | [seed] | Ch.6 [reveal] | Ch.9 [power] |
| Romance | [meeting] | Ch.5 [feelings] | Ch.10 [love] |
## Poetry Pairings (Chinese novels)
| Ch | Ancient Poetry | Modern Lyrics | Theme |
|----|----------------|---------------|-------|
See references/poetry_pairs.md for suggestions.
## Chapter Outline
- [ ] Ch.1: [title] - [key scenes, ~5000 words]
...
## Progress
| Ch | Status | Words |
|----|--------|-------|
Phase 4: Chapter Writing
Write each chapter (~4000-5500 words) following this structure:
# 第X章:[押韵标题]
> *[Ancient poetry quote]*
> *——[Author]《[Title]》*
---
## 一
[Scene 1: Setting + action]
## 二
[Scene 2: Dialogue + conflict]
## 三
[Scene 3: Resolution + hook]
---
(第X章完)
---
> *"[Modern lyrics quote]"*
> *——《[Song]》*
Writing checklist:
- Vivid sensory descriptions (sight, sound, smell, touch)
- Dialogue with subtext (what's said vs. what's meant)
- Internal monologue showing modern perspective
- Proper pacing (action → dialogue → reflection)
- Foreshadowing elements per plan
- Chapter-end hook
File naming: [##]_[章节标题].md (e.g., 01_梦回千年惊鸿起.md)
Update task_plan.md progress after each chapter.
Phase 5: EPUB Generation
Run:
python3 scripts/create_epub.py
Script auto-detects chapter files in current directory and generates:
- Cover page with title/subtitle/author
- Introduction page
- All chapters with proper formatting
- Table of contents
- Chinese typography CSS
Output: [书名].epub
Quick Commands
| User says | Action |
|---|---|
| "写一部穿越小说" | Full workflow Phase 1-5 |
| "根据大纲写小说" + outline | Phase 3-5 |
| "把章节转成epub" | Phase 5 only |
| "继续写下一章" | Resume Phase 4 |
Resources
scripts/create_epub.py- EPUB generatorreferences/personas.md- Character templates by settingreferences/poetry_pairs.md- Poetry and lyrics pairings
FAQ
What does the novel-creator skill do?
Interactive novel creation workflow combining RPG-style storytelling with professional EPUB ebook production. Use when users want to: (1) Create interactive stories/RPG games with branching choices, (2) Write full novels from story concepts, (3) Generate novels with time-travel/fantasy/romance elements, (4) Convert markdown stories to EPUB ebooks, (5) Create Chinese web novels with ancient poetry paired with modern lyrics, (6) Write light novels or serialized fiction. Triggers: "write a novel", "create a story", "interactive fiction", "RPG story", "make an ebook", "穿越小说", "写小说", "创作故事", "制作电子书"
How do I install novel-creator?
Run npx skills add https://github.com/mave99a/novel-skill --skill novel-creator in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/novel-creator/ (personal) or .claude/skills/novel-creator/ (project).
Which AI agents can use novel-creator?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is novel-creator safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains novel-creator?
It is published by mave99a in mave99a/novel-skill. It has 772 recorded installs.
Popular docs & writing skills
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
lark-markdown
open.feishu.cn
飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.