# awesome-novel

> Write a novel with your agent: writing agents plan volumes and chapters, draft in your style and keep your world's lore straight.

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.

- Type: Skill
- Made by: modoojunko
- Category: Writing
- Formats: Skills
- Version: d622c0f
- Website: https://github.com/modoojunko/awesome-novel-agent
- Source: https://github.com/modoojunko/awesome-novel-agent
- Page: https://pluginboard.ai/skills/awesome-novel

## Works with

- ChatGPT
- Claude
- Gemini
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### ChatGPT

In ChatGPT: Download the awesome-novel folder and zip it, then Plugins → Skills → Create → Upload from your computer. Business and Enterprise plans.

View the folder on GitHub: https://github.com/modoojunko/awesome-novel-agent

### Claude

In Claude (web or desktop): Download the awesome-novel folder and zip the folder itself, then upload it in Customize → Skills.

View the folder on GitHub: https://github.com/modoojunko/awesome-novel-agent

### Gemini

In Gemini: Download the awesome-novel folder, then at gemini.google.com click Customize → Skills → Create → Upload and pick the folder (or a .zip of it).

View the folder on GitHub: https://github.com/modoojunko/awesome-novel-agent

### GitHub Copilot

Run in your terminal:

```shell
npx -y degit modoojunko/awesome-novel-agent ~/.copilot/skills/awesome-novel
```

View the folder on GitHub: https://github.com/modoojunko/awesome-novel-agent

### Cursor

Run in your terminal:

```shell
npx -y degit modoojunko/awesome-novel-agent ~/.cursor/skills/awesome-novel
```

View the folder on GitHub: https://github.com/modoojunko/awesome-novel-agent

### Claude Code

Run in your terminal:

```shell
npx -y degit modoojunko/awesome-novel-agent ~/.claude/skills/awesome-novel
```

View the folder on GitHub: https://github.com/modoojunko/awesome-novel-agent

### Codex

Run in your terminal:

```shell
npx -y degit modoojunko/awesome-novel-agent ~/.agents/skills/awesome-novel
```

View the folder on GitHub: https://github.com/modoojunko/awesome-novel-agent

### Antigravity

In Antigravity: Copy the awesome-novel folder into ~/.gemini/config/skills (Antigravity app and IDE) or ~/.gemini/antigravity-cli/skills (Antigravity CLI).

View the folder on GitHub: https://github.com/modoojunko/awesome-novel-agent

### Gemini CLI

Run in your terminal:

```shell
npx -y degit modoojunko/awesome-novel-agent ~/.gemini/skills/awesome-novel
```

View the folder on GitHub: https://github.com/modoojunko/awesome-novel-agent

### Replit

Run in your terminal:

```shell
npx -y degit modoojunko/awesome-novel-agent .agents/skills/awesome-novel
```

View the folder on GitHub: https://github.com/modoojunko/awesome-novel-agent

### OpenClaw

Run in your terminal:

```shell
npx -y degit modoojunko/awesome-novel-agent ~/.openclaw/skills/awesome-novel
```

View the folder on GitHub: https://github.com/modoojunko/awesome-novel-agent

### OpenCode

Run in your terminal:

```shell
npx -y degit modoojunko/awesome-novel-agent ~/.config/opencode/skills/awesome-novel
```

View the folder on GitHub: https://github.com/modoojunko/awesome-novel-agent

### Hermes Agent

Run in your terminal:

```shell
npx -y degit modoojunko/awesome-novel-agent ~/.hermes/skills/awesome-novel
```

View the folder on GitHub: https://github.com/modoojunko/awesome-novel-agent

---
From Pluginboard (https://pluginboard.ai).
