
Write a novel with your agent: writing agents plan volumes and chapters, draft in your style and keep your world's lore straight.
by modoojunko· WritingUnclaimed · Yours? Claim it
4 images
About
awesome-novel is an open-source writing workflow by modoojunko that turns your agent into a team of writing agents for long fiction. A director agent hands work to specialist agents for planning, prompting, drafting, reviewing and record-keeping, and every setting, outline and chapter is kept as plain Markdown in your project folder. What you can do with it - Start a new novel or import one you've already begun, and set its genre, world, characters and writing style - Plan the arc back from the ending, then volumes and chapter outlines with scene breakdowns, emotional beats and hooks for you to approve - Draft chapters from a layered prompt built from the outline, your style and its rules against AI-sounding prose - Distill the style of sample texts you provide into a style card the writer follows - Get an optional reader's review of each chapter - Archive finished chapters and update the timeline, character files and memory so later chapters stay consistent How it connects - Tell your agent "Install awesome-novel-agent for me", or clone the repo and run ./install.sh with your platform (claude-code, codex, opencode and others). Then type /awesome-novel in the folder for your novel. - It needs Python 3.9 or later; some platforms also need pyyaml. Good to know - Its instructions are in Chinese, and its genre presets centre on Chinese web fiction such as xianxia. There's an English README. - It's free for personal use under AGPL-3.0; commercial use needs the author's permission.
Skills people install alongside awesome-novel.
Once it’s added
“Help me write a novel.”
“Plan the first volume. I only know the beginning.”
“Outline the next chapter.”
“Draft the next chapter.”
“Learn the style of the samples I put in novel-samples.”
“Import my existing novel and keep writing.”
Before you add it
Reads only
Your novel's settings, outlines, chapters and memory files · Sample texts you add for style distillation
Makes changes · your agent can ask first
Creates the novel workspace and its agent definitions in your folder · Writes outlines, prompts and chapters, and updates the timeline and character files
From people who use it
Step by step
Nothing new reaches your agent until a person has looked at it.
Scanned on every change, and again when our rules improve.
Runs on your machine.
Runs on your machine.
Runs on your machine.
Runs on your machine.
npx -y degit modoojunko/awesome-novel-agent ~/.copilot/skills/awesome-novel
Runs on your machine.
npx -y degit modoojunko/awesome-novel-agent ~/.cursor/skills/awesome-novel
Runs on your machine.
npx -y degit modoojunko/awesome-novel-agent ~/.claude/skills/awesome-novel
Runs on your machine.
npx -y degit modoojunko/awesome-novel-agent ~/.agents/skills/awesome-novel
Runs on your machine.
Runs on your machine.
npx -y degit modoojunko/awesome-novel-agent ~/.gemini/skills/awesome-novel
Runs on your machine.
npx -y degit modoojunko/awesome-novel-agent .agents/skills/awesome-novel
Runs on your machine.
npx -y degit modoojunko/awesome-novel-agent ~/.openclaw/skills/awesome-novel
Runs on your machine.
npx -y degit modoojunko/awesome-novel-agent ~/.config/opencode/skills/awesome-novel
Runs on your machine.
npx -y degit modoojunko/awesome-novel-agent ~/.hermes/skills/awesome-novel
Scanned and passed · checked 2 h ago
No reviews yet. Used awesome-novel? Say how it went.
Write a reviewRewrites AI-sounding text so it reads like a person wrote it, without changing what it says or making anything up.
Two documentation skills: HADS, a tagging convention people and AI both read well, and grounded vaults that trace every claim to its source.
Tw93's writing skill: rewrites and polishes Chinese or English prose so it reads naturally, cutting stiff, AI-sounding phrasing.
Nobody has shared how they use awesome-novel yet.
Security scan
Passed
Safe to install in every agent it supports. Runs in your agent, as instructions.