Skip to main content
skill CX Codex

novel-writer — Claude Code skill: novels, characters, worlds

A skill for AI coding agents that helps draft, continue and revise fiction: outline a novel, design characters, build a world.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add YangsonHung/awesome-agent-skills --skill novel-writer -a claude-code
Open on GitHub

What novel-writer does

The skill starts by sorting the request: a new novel, a chapter continuation, a character, worldbuilding or a revision. It asks only the questions it needs, then follows the matching section of its instructions. For a new book it lays out a three-act structure, character cards and a chapter plan before writing.

Supporting material lives in references/ and assets/templates/: story-structure.md, character-development.md, worldbuilding.md, writing-techniques.md, genre-guides.md, plus outline.md, character-card.md and world-bible.md. Genre sections cover sci-fi, fantasy, mystery, romance and wuxia.

It is not meant for factual Q&A, legal or medical advice, or requests to imitate copyrighted work. Continuation is the part worth testing first: the skill is told to keep tone, POV and character logic consistent with what you already wrote, so feed it the existing chapters before asking for the next one. Install runs through npx skills add; GitHub Copilot uses gh skill install instead.

What it helps with

  • sketch a three-act outline for a new novel
  • continue a chapter without breaking POV or tone
  • build a character card with desire, fear and arc
  • design a magic system with rules and costs
  • revise dialogue for tension and subtext

Example prompts for the agent

  • help me write a sci-fi novel
  • write the next chapter, keep the same POV
  • design a villain and their character arc

How to install novel-writer

1Skills CLI (Vercel)

npx skills add YangsonHung/awesome-agent-skills --skill novel-writer -a claude-code

2Manually: put the files in place

~/.claude/skills/novel-writer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/novel-writer/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about novel-writer

How do I install novel-writer in Claude?

Run npx skills add YangsonHung/awesome-agent-skills --skill novel-writer -a claude-code. The skill file lands at ~/.claude/skills/novel-writer/SKILL.md.

What does novel-writer do?

It supports ideation, planning, drafting, continuation and revision of fiction, and handles character design and worldbuilding as separate workflows.

Which genres does the skill cover?

Its genre guide has sections for sci-fi, fantasy, mystery, romance and wuxia, each with its own focus such as magic rules or fair clues.

Source text

SKILL.md · MIT
---
name: novel-writer
description: Use when writing, continuing, revising, or planning novels, characters, and fictional worlds.
---

# Novel Writer

## Overview

Provide professional novel writing support covering ideation, planning, drafting, continuation, and revision. The skill handles new fiction projects, chapter continuation, character design, character arcs, worldbuilding, and prose revision across genres such as science fiction, fantasy, mystery, romance, and wuxia.

## When to Use

Use this skill when the user asks for:
- New novel creation from an idea or genre prompt
- Continuing existing chapters or scenes
- Character creation and character arc design
- Worldbuilding (magic systems, factions, settings, lore)
- Revising story content for clarity, tension, pacing, or emotional impact

## Do not use

Do not use this skill for:
- Factual Q&A tasks that are not creative writing tasks
- Legal, medical, or financial advice requests
- Requests to produce plagiarism or direct imitation of copyrighted works
- Harmful or disallowed content that violates platform safety policies

## Instructions

1. Identify request type first (new novel, continuation, character, worldbuilding, revision).
2. Ask only the minimum required questions before drafting.
3. Follow the matching workflow section in this file.
4. Reuse references and templates under `references/` and `assets/templates/`.
5. Keep tone, POV, and character logic consistent with prior content.
6. Before final output, quickly self-check plot coherence and language quality.

---

## Workflow

### Step 1: Identify Request Type

| Task Type | User Example | Action |
|-----------|--------------|--------|
| New novel | "help me write a sci-fi novel" | Go to [Create New Novel](#create-new-novel) |
| Continue chapter | "write the next chapter" | Go to [Continue Chapter](#continue-chapter) |
| Character design | "design a villain" | Go to [Character Design](#character-design) |
| Worldbuilding | "build a magic system" | Go to [Worldbuilding](#worldbuilding) |
| Content revision | "revise this dialogue" | Direct optimization |

---

## Create New Novel

### Writing Process

```
1. Gather Info → 2. Build Framework → 3. Character Design → 4. Chapter Planning → 5. Start Writing
```

### 1. Gather Basic Information

Ask the user for key details (avoid asking too much at once):

**Required:**
- Genre (sci-fi/fantasy/mystery/romance/wuxia etc.)
- Core concept or inspiration
- Target length (short/medium/long)

**Optional (ask progressively):**
- Protagonist setting
- Desired emotional tone
- Special requirements

### 2. Build Framework

Create a story outline using the **Three-Act Structure**:

- **Act 1 (25%)**: Setup → Inciting Incident → Crossing the Threshold
- **Act 2 (50%)**: Challenges → Midpoint → Crisis → Preparation
- **Act 3 (25%)**: Climax → Resolution → New Normal

**Detailed structure guide**: See [references/story-structure.md](references/story-structure.md)

### 3. Character Design

Create character cards for core characters:

- **Protagonist**: Core desire, core fear, character arc
- **Antagonist**: Motivation, conflict with protagonist
- **Key supporting characters**: Functional role

**Detailed character guide**: See [references/character-development.md](references/character-development.md)

### 4. Chapter Planning

Plan specific chapters based on the outline, clarifying for each:
- POV (perspective)
- Scene location
- Plot points
- Connection to overall story

### 5. Start Writing

Write chapter by chapter according to the plan:
- Maintain consistent perspective
- Vivid scene details
- Dialogue that advances plot
- Appropriate foreshadowing

---

## Continue Chapter

### Pre-writing Preparation

1. **Understand existing content**
   - Read existing chapters
   - Review current plot progress
   - Confirm character status and relationships

2. **Confirm continuation direction**
   - What's the goal of the next chapter?
   - What events need to happen?
   - What's the emotional direction?

### Continuation Guidelines

- Connect to previous plot and atmosphere
- Maintain consistent character personalities
- Advance main or subplots
- End with a hook

---

## Character Design

### Design Process

1. **Determine character function**
   - Protagonist/antagonist/supporting?
   - Role in the story?

2. **Fill in character dimensions**
   - Basic info (name, age, appearance)
   - Core desires and fears
   - Strengths and weaknesses
   - Unique identifiers (speech patterns, habitual gestures)

3. **Design character arc**
   - Starting state
   - Changes experienced
   - Ending state

4. **Build relationship network**
   - Relationships with other characters
   - Conflicts and bonds

**Use template**: [assets/templates/character-card.md](assets/templates/character-card.md)

---

## Worldbuilding

### Building Layers

1. **Physical World**
   - Geography
   - Climate and ecology
   - Important locations

2. **Social Systems**
   - Political structure
   - Economic system
   - Cultural customs

3. **Special Systems**
   - Magic system (fantasy)
   - Technology setting (sci-fi)
   - Martial arts system (wuxia)

4. **Historical Background**
   - Important events
   - Legends and myths

### Building Principles

- **Serve the story**: Only build what the story needs
- **Internal consistency**: Rules shouldn't contradict
- **Show don't tell**: Reveal the world through plot

**Detailed guide**: See [references/worldbuilding.md](references/worldbuilding.md)

**Use template**: [assets/templates/world-bible.md](assets/templates/world-bible.md)

---

## Genre-Specific Guidance

| Genre | Key Points | Detailed Guide |
|-------|------------|----------------|
| Sci-Fi | Internal logic of scientific setting | [genre-guides.md#sci-fi](references/genre-guides.md) |
| Fantasy | Magic rules and costs | [genre-guides.md#fantasy](references/genre-guides.md) |
| Mystery | Fair clues, surprising truth | [genre-guides.md#mystery](references/genre-guides.md) |
| Romance | Character chemistry, emotional layers | [genre-guides.md#romance](references/genre-guides.md) |
| Wuxia | Martial arts system, jianghu conflicts | [genre-guides.md#wuxia](references/genre-guides.md) |

---

## Writing Techniques

Key techniques at a glance:

- **Narrative POV**: First person/third person limited/omniscient, choose based on story needs
- **Scene building**: Time + location + characters + conflict + change
- **Dialogue writing**: Advance plot, reveal character, contain subtext
- **Pacing**: Balance tension and release, buffer after climaxes
- **Suspense & foreshadowing**: Plant early, pay off later

**Detailed techniques**: See [references/writing-techniques.md](references/writing-techniques.md)

---

## Available Templates

| Template | Purpose |
|----------|---------|
| [outline.md](assets/templates/outline.md) | Complete novel outline |
| [character-card.md](assets/templates/character-card.md) | Character profile card |
| [world-bible.md](assets/templates/world-bible.md) | Worldbuilding document |
| [chapter.md](assets/templates/chapter.md) | Chapter planning and writing |

---

## Output Guidelines

### Outline Output
- Clear structure, distinct layers
- Key plot points clearly defined
- Easy to expand upon

### Prose Output
- Write in the target language
- Appropriate paragraph breaks
- Proper dialogue formatting
- Avoid overly formal language, maintain readability

### Format Example
```
Chapter 1: Dark Descent

Neon lights blurred into halos through the rain. Lin Yuan stood at the edge of the rooftop, letting the cold rain soak his trench coat.

"You came." A familiar voice spoke from behind.

He turned to see a dark figure emerging from the stairwell.
```

© YangsonHung · MIT · YangsonHung/awesome-agent-skills

Similar skills

Everything for Writing and docs →

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor