Skip to content
SkillScript-led3,837 tokens in use

story-import

Reverse-imports a half-written or finished novel into a project folder with settings, outline, chapters and tracking, ready for the next chapter.

8,793 stars on the repository MIT Licensezenstory-ai/oh-story-claudecode · skills/story-import
npx skills add zenstory-ai/oh-story-claudecode -y -g
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing story-import costs

123tokens idle
3,837tokens in use
26,502tokens, 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/build_outline_brief.py, scripts/check-outline-contract.js, scripts/outline_view.py, scripts/tracking_commit.py, scripts/wordcount_core.py.

Touches

writes filesdetected

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
  • Frontmatter8/15
  • Structure22/25
  • Examples9/15
  • Output0/15
  • Size15/15
  • Resources8/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 →
Needs attention
  • Writes files−8

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

    scripts/build_outline_brief.py, line 64
  • Hidden characters−20

    characters that render as nothing or reorder the text

    scripts/build_outline_brief.py, line 214
  • Hidden characters−20

    characters that render as nothing or reorder the text

    scripts/build_outline_brief.py, line 258
  • Hidden characters−20

    characters that render as nothing or reorder the text

    scripts/check-outline-contract.js, line 121

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Excellent
  • Development activity100
  • Maintenance100
  • Community60
  • Maturity28
  • Momentum40

story-import takes a novel an author has already written, as a text file, a folder of chapters or pasted text, and rebuilds it as a writing project. It confirms title, genre, platform, length and whether the last chapter is complete, runs a deep analysis, then migrates the result into settings, outline, chapter and tracking folders.

The project it leaves behind works with the long-form and short-form writing skills of the same package, so the author can say “write chapter N” and carry on. Open questions, such as where volumes split, are listed for the author to decide.

What You Get

  • A project folder named after the book with settings, outline, chapter text and tracking files
  • Reverse-written chapter outlines for a long novel, built batch by batch from the existing text
  • A tracking state initialized from the manuscript, with foreshadowing and character status checked by a script
  • An import record that keeps decisions, preferences and progress so you can resume in a new conversation
  • A report listing what needs author confirmation, with the next step to continue writing

Common Use Cases

  • Continuing a serial novel you already published for twenty or more chapters
  • Turning a finished short story into a project that the short-form writing skill can build on
  • Rescuing a half-written draft whose last chapter is unfinished, after you decide how to treat it

What Makes It Unique

Most writing skills start from a blank page. This one starts from the text you already have and reuses the package’s own analysis pipelines, so the imported book lands in exactly the folder structure the writing skills expect. It keeps the imported book separate from any outside benchmark book, never registers your own work as its reference, and leaves story decisions such as volume splits to you.

Under The Hood

The skill is mostly instructions that route the agent through phases, with reference files read as each phase starts. It reads your manuscript files, checks the project for a deployed marker and for sub-agent definitions, and hands the heavy reading to helper agents when the host supports them. It writes many files into the project: the import record, the analysis library, settings, outline, chapters and tracking. Bundled Python and Node scripts run locally to count words, check outline contracts, build outline briefs and initialize and verify the tracking state. No web requests are part of the flow.

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