Skip to content
SkillScript-led3,941 tokens in use

Novel Characters

Pulls the cast out of a novel and writes a character bible: profiles, image prompts, voice prompts and model-sheet layout instructions.

6,884 stars on the repository Apache License 2.0eternityspring/shuohao-skills · skills/novel-characters
./scripts/install.sh novel-characters
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing Novel Characters costs

166tokens idle
3,941tokens in use
5,321tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Script-led

Script-ledMixedModel-led

Most of this skill is scripts, so it behaves much the same whichever model runs it.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: scripts/novel-characters.mjs, scripts/selftest.mjs.

Touches

shelldeclared and detectednetworkdetectedwrites filesdeclared and detected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Good
  • Frontmatter12/15
  • Structure22/25
  • Examples15/15
  • Output5/15
  • Size13/15
  • Resources2/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Good
  • Runs shell commands−2

    does this on the machine, as the frontmatter declares

    SKILL.md, line 59
  • Writes files−4

    does this on the machine, as the frontmatter declares

    SKILL.md, line 77
  • File that was not read−15

    a file the skill ships that was not read, so what it does is unknown

    scripts/novel-characters.mjs
  • Reaches the network−10

    does this on the machine, and the frontmatter does not say so

    scripts/novel-characters.mjs, line 1557

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity92
  • Maintenance52
  • Community60
  • Maturity20
  • Momentum40

Novel Characters reads a novel or short story and produces, for each character, a profile, an image prompt that includes a full model-sheet layout, and a voice prompt. It does not generate images. The prompts are meant for a later image or speech step.

Long books are split into chunks, scanned by sub-agents, merged by name and alias, and then turned into character cards. When an outline file from the Novel Outline skill exists, the cast list is seeded from it. Output is JSON, Markdown and an interactive HTML report. Profile fields follow a chosen language, defaulting to Chinese, while image and voice prompts stay in English.

What You Get

  • A cast.json with profiles, image prompts, voice prompts and sheet layouts
  • A Markdown version and a double-click HTML report
  • A story summary in the report language
  • Resume support, since finished character cards are not redone

Common Use Cases

  • Building a character bible from a novel before short-drama production
  • Writing consistent image prompts for the same character across scenes
  • Producing voice prompts for later speech generation

What Makes It Unique

It stops at prompts on purpose, because the image model, style and frame size are decisions for a later step. Quotes must match the source text word for word and image prompts may not contain character names, and both rules are enforced by a validator that was tuned on real model output. Any report language works, with the interface text translated on the spot for languages that are not built in.

Under The Hood

The skill is an instruction file with Node.js scripts that use only the standard library. It runs shell commands to chunk the book, merge rosters, assemble cards, validate and render, and it starts sub-agents to scan chunks and write cards in parallel when the environment supports it. It reads the novel text file and writes JSON, Markdown and HTML files plus working files into a work folder. It does not fetch web pages or call outside APIs and needs no API key.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers