Agent skill

Revise Chapter

by forsonny in 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.

No licenceAuto-check passed

Install Revise Chapter

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

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

GitHub CLI
$ gh skill install forsonny/Claude-Code-Novel-Writer revise-chapter --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/revise-chapter .claude/skills/revise-chapter && 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
revise-chapter
GitHub stars
137
Token cost
~304 tokens
SKILL.md length
133 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
None found

At a glance

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

  • Works in 10 steps: Resolve the repository root and read the… → Identify whether the requested change is… → For continuity-heavy work, read… → …
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Revise Chapter is an agent skill from 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.

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

The repository describes itself as: Use Claude Code CLI to write full novels.

Example prompts

  • “/revise-chapter”

Workflow steps

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

  1. Resolve the repository root and read the current chapter, its outline beat, adjacent chapters, and relevant canon.
  2. Identify whether the requested change is structural, prose-level, character-level, continuity-related, or a combination.
  3. For continuity-heavy work, read .agents/roles/continuity-editor.md and perform or delegate a focused audit first.
  4. Read .agents/roles/chapter-writer.md.
  5. If the harness exposes a named chapter-writer specialist, delegate the bounded prose revision to it. Otherwise perform that role directly.
  6. Preserve good existing material. Do not rewrite the whole chapter merely to normalize style.
  7. Run automation/quality-check.sh for mechanical signals.
  8. Run ./sync-state.sh.
  9. Recheck any continuity affected by substantive changes.
  10. Report the revision's story effects and any downstream chapters or planning files that may need adjustment.

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

Revise Chapter loads about 304 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
~304

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 (~304 tokens).

“Use the chapter number and revision goal supplied with the invocation.”

— opening of SKILL.md by forsonny
name
revise-chapter

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/revise-chapter of forsonny/Claude-Code-Novel-Writer.

Open the folder on GitHubat commit 017cd8b

Compare with similar skills

Revise Chapter 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.

Revise Chapter compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Revise Chapter this skillforsonny/Claude-Code-Novel-Writer137—~304Automated safety check: PassNone
Character Riggingcalesthio/OpenMontage66k—~460Automated safety check: PassMIT
Prosestatic-web-server/static-web-server2.4k—~971Automated safety check: PassApache-2.0
Beautiful Prosesickn33/agentic-awesome-skills47k2 repos~1.4kAutomated safety check: PassMIT
SVG Character Animationcalesthio/OpenMontage66k—~421Automated safety check: PassMIT
Character Animation QAcalesthio/OpenMontage66k—~389Automated safety check: PassMIT

Similar skills

  • Character Rigging

    calesthio/OpenMontage

    Build data-driven 2D character rigs for local animation: parts, pivots, layers, constraints, views, and reusable rig packages.

    66k GitHub stars~460 tokensUpdated 6 days ago
    Media & CreativeAuto-check passed
  • Prose

    static-web-server/static-web-server

    Author or edit any prose for the Static Web Server (SWS) project — documentation, design docs, READMEs, PR descriptions, issue bodies, commit message bodies, or other human-readable text — following…

    2.4k GitHub stars~971 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Beautiful Prose

    sickn33/agentic-awesome-skills

    A hard-edged writing style contract for timeless, forceful English prose without modern AI tics.

    47k GitHub starsUsed in 2 repos~1.4k tokens
    Writing & ContentAuto-check passed
  • SVG Character Animation

    calesthio/OpenMontage

    Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

    66k GitHub stars~421 tokensUpdated 6 days ago
    Media & CreativeAuto-check passed
  • Character Animation QA

    calesthio/OpenMontage

    Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

    66k GitHub stars~389 tokensUpdated 6 days ago
    Media & CreativeAuto-check passed
  • Tracks analyst estimate revisions, earnings surprises, management guidance and post-earnings drift for US and Hong Kong stocks, and turns them into long and short signals.

    35k GitHub stars~2.5k tokensUpdated today
    Business, Finance & HRAuto-check passed

More from forsonny/Claude-Code-Novel-Writer

All 10 skills in this repo
  • Plan Novel

    forsonny/Claude-Code-Novel-Writer

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

    137 GitHub stars~316 tokensUpdated 1 mo ago
    Auto-check passed
  • 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
  • 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 Revise Chapter

What does Revise Chapter do?

Substantively revise a specified chapter for structure, prose, character, pacing, or continuity while preserving its intended story function and established voice. Revise Chapter is an agent skill from 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.

How do I install Revise Chapter in Claude Code?

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

How do I install Revise Chapter in Codex?

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

Can I use Revise Chapter 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 revise-chapter -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/revise-chapter, .gemini/skills/revise-chapter, .github/skills/revise-chapter and .opencode/skills/revise-chapter in your project.

What does Revise Chapter need to run?

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

Does Revise Chapter 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 Revise Chapter 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 Revise Chapter use?

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

How many tokens does Revise Chapter use?

About 304 tokens (SKILL.md is roughly 1.2k 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 Revise Chapter?

Skills that share tags, products or a category with Revise Chapter: Character Rigging (calesthio/OpenMontage, 66k stars), Prose (static-web-server/static-web-server, 2.4k stars), Beautiful Prose (sickn33/agentic-awesome-skills, 47k stars) and SVG Character Animation (calesthio/OpenMontage, 66k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Revise Chapter?

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.