Agent skill

Plan Novel

by forsonny in forsonny/Claude-Code-Novel-Writer

Create or substantially revise a novel premise, structure, chapter plan, character arcs, and required world foundations.

No licenceAuto-check passedWriting & Content

Install Plan Novel

skills CLI
$ npx skills add forsonny/Claude-Code-Novel-Writer --skill plan-novel -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install forsonny/Claude-Code-Novel-Writer plan-novel --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/forsonny/Claude-Code-Novel-Writer.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/plan-novel .claude/skills/plan-novel && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
plan-novel
GitHub stars
137
Token cost
~316 tokens
SKILL.md length
133 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
None found

At a glance

Create or substantially revise a novel premise, structure, chapter plan, character arcs, and required world foundations.

  • Works in 10 steps: Resolve the repository root and inspect… → Treat substantial manuscript prose as… → Read .agents/roles/plot-architect.md. → …
  • Major structural replan
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Creative writing and fiction

What it does

Plan Novel is an agent skill from forsonny/Claude-Code-Novel-Writer. Create or substantially revise a novel premise, structure, chapter plan, character arcs, and required world foundations. Use for a new novel or major structural replan.

Its SKILL.md is about 320 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Creative writing and fiction. The repository describes itself as: Use Claude Code CLI to write full novels.

When your agent uses it

  • Major structural replan
  • Tasks that involve Creative writing and fiction

Example prompts

  • “/plan-novel”

Workflow steps

10 steps, taken from the first numbered list in SKILL.md.

  1. Resolve the repository root and inspect planning/, characters/, worldbuilding/, and manuscript/chapters/.
  2. Treat substantial manuscript prose as canon unless the user explicitly requests a retcon.
  3. Read .agents/roles/plot-architect.md.
  4. If the harness exposes a named plot-architect specialist, delegate a bounded planning task to it. Otherwise perform that role directly.
  5. Use character-developer and worldbuilder only for foundations that materially affect the plan.
  6. Create causally connected chapter purposes, turning points, setups, payoffs, and character decisions.
  7. Write or update planning/novel-outline.json.
  8. Record unresolved creative choices as explicit questions or provisional decisions, not hidden assumptions.
  9. Run ./sync-state.sh when tracking needs initialization or reconciliation.
  10. Summarize the premise, structural shape, major arcs, chapter count, open decisions, and next recommended drafting action.

What it can do on your machine

Read from SKILL.md and the folder at commit 017cd8b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Plan Novel loads about 316 tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 133 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~316

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 133 words (~316 tokens).

“Use any premise, constraints, or priorities supplied with the invocation.”

— opening of SKILL.md by forsonny
name
plan-novel

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/plan-novel of forsonny/Claude-Code-Novel-Writer.

Open the folder on GitHubat commit 017cd8b

Compare with similar skills

Plan Novel next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Plan Novel compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Plan Novel this skillforsonny/Claude-Code-Novel-Writer137—~316Automated safety check: PassNone
Story Multi-Perspective Reviewzenstory-ai/oh-story-claudecode7.4k3 repos~3kAutomated safety check: PassMIT
Short Web Fiction Trend Scanzenstory-ai/oh-story-claudecode7.4k2 repos~1.2kAutomated safety check: PassMIT
InkOS Creative HarnessNarcooo/inkos10k1 repos~1.1kAutomated safety check: PassAGPL-3.0
Novel Arteternityspring/shuohao-skills4.3k—~1.1kAutomated safety check: NotesApache-2.0
SepiaNanako0129/sepia3k—~3.6kAutomated safety check: PassMIT

Similar skills

  • Story Multi-Perspective Review

    zenstory-ai/oh-story-claudecode

    Reviews Chinese web-novel text with several reviewer agents in parallel, falling back to a single-agent pass, and reports structure, character, prose and setting problems with fixes.

    7.4k GitHub starsUsed in 3 repos~3k tokens
    Writing & ContentAuto-check passed
  • Short Web Fiction Trend Scan

    zenstory-ai/oh-story-claudecode

    Scans popular short web-fiction rankings on Chinese platforms such as Dianzhong and Heiyan to surface trending emotional hooks, themes and topic candidates with an expiry warning.

    7.4k GitHub starsUsed in 2 repos~1.2k tokens
    Writing & ContentAuto-check passed
  • Drives long-form fiction, scripts, storyboards, interactive films and long-document translation through InkOS, with every change made by a typed action.

    10k GitHub starsUsed in 1 repo~1.1k tokens
    Writing & ContentAuto-check passed
  • Novel Art

    eternityspring/shuohao-skills

    给 AI 短剧出美术设定集(场景 + 叙事道具):场景的设计意图、一致性锚点、光照时段变体、 空景提示词;道具的戏剧功能、状态变体、尺度参照、白底无手提示词。

    4.3k GitHub stars~1.1k tokensUpdated yesterday
    Writing & ContentAuto-check: notes
  • Sepia

    Nanako0129/sepia

    Make AI-generated writing read as human-written, in fiction and in professional prose.

    3k GitHub stars~3.6k tokensUpdated 3 days ago
    Writing & ContentAuto-check passed
  • Story Toolbox Router

    zenstory-ai/oh-story-claudecode

    Routes a Chinese web-novel writing request to the matching tool in a 13-skill toolbox, covers author habit memory, and can launch a local dashboard for browsing a project.

    7.4k GitHub stars~1.7k tokensUpdated 6 days ago
    Writing & ContentAuto-check passed

More from forsonny/Claude-Code-Novel-Writer

All 10 skills in this repo
  • Continuity Pass

    forsonny/Claude-Code-Novel-Writer

    Audit a chapter range or current manuscript for contradictions, timeline errors, knowledge leaks, rule violations, and unresolved continuity risks.

    137 GitHub stars~308 tokensUpdated 1 mo ago
    Auto-check passed
  • Finalize Manuscript

    forsonny/Claude-Code-Novel-Writer

    Review a substantially complete manuscript for structural gaps, continuity problems, unresolved promises, chapter order, and revision priorities before final polish.

    137 GitHub stars~274 tokensUpdated 1 mo ago
    Auto-check passed
  • Revise Chapter

    forsonny/Claude-Code-Novel-Writer

    Substantively revise a specified chapter for structure, prose, character, pacing, or continuity while preserving its intended story function and established voice.

    137 GitHub stars~304 tokensUpdated 1 mo ago
    Auto-check passed
  • Write Chapter

    forsonny/Claude-Code-Novel-Writer

    Draft the next chapter or a specified chapter from the accepted outline while preserving manuscript continuity, character knowledge, and established voice.

    137 GitHub stars~339 tokensUpdated 1 mo ago
    Auto-check passed
  • Continuity Pass

    forsonny/Claude-Code-Novel-Writer

    Audit a chapter range or manuscript scope for contradictions and continuity risks.

    137 GitHub stars~132 tokensUpdated 1 mo ago
    Auto-check passed
  • Finalize Manuscript

    forsonny/Claude-Code-Novel-Writer

    Review a substantially complete manuscript and produce or execute a prioritized revision plan.

    137 GitHub stars~135 tokensUpdated 1 mo ago
    Auto-check passed

Questions about Plan Novel

What does Plan Novel do?

Create or substantially revise a novel premise, structure, chapter plan, character arcs, and required world foundations. Plan Novel is an agent skill from forsonny/Claude-Code-Novel-Writer. Create or substantially revise a novel premise, structure, chapter plan, character arcs, and required world foundations.

When should I use Plan Novel?

Plan Novel fits situations like: major structural replan; tasks that involve Creative writing and fiction.

How do I install Plan Novel in Claude Code?

Run `npx skills add forsonny/Claude-Code-Novel-Writer --skill plan-novel -a claude-code`. Or copy the skill folder (.agents/skills/plan-novel in forsonny/Claude-Code-Novel-Writer) into .claude/skills/plan-novel in your project. Claude Code loads it when a task matches its description.

How do I install Plan Novel in Codex?

Run `npx skills add forsonny/Claude-Code-Novel-Writer --skill plan-novel -a codex`. Or copy the skill folder (.agents/skills/plan-novel in forsonny/Claude-Code-Novel-Writer) into .agents/skills/plan-novel in your project. Codex loads it when a task matches its description.

Can I use Plan Novel in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add forsonny/Claude-Code-Novel-Writer --skill plan-novel -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/plan-novel, .gemini/skills/plan-novel, .github/skills/plan-novel and .opencode/skills/plan-novel in your project.

What does Plan Novel need to run?

SKILL.md names no scripts, command-line tools or credentials: Plan Novel is instructions for the agent only.

Does Plan Novel access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Plan Novel safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Plan Novel use?

No licence was found for Plan Novel or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Plan Novel use?

About 316 tokens (SKILL.md is roughly 1.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Plan Novel?

Skills that share tags, products or a category with Plan Novel: Story Multi-Perspective Review (zenstory-ai/oh-story-claudecode, 7.4k stars), Short Web Fiction Trend Scan (zenstory-ai/oh-story-claudecode, 7.4k stars), InkOS Creative Harness (Narcooo/inkos, 10k stars) and Novel Art (eternityspring/shuohao-skills, 4.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Plan Novel?

forsonny (a GitHub user) maintains it in forsonny/Claude-Code-Novel-Writer, which has 137 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on August 21, 2026.

Source: forsonny/Claude-Code-Novel-Writer on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.