Story Skills

Plan, track, and draft fiction in markdown,with a continuity checker that catches mistakes before readers do.

Quick start  ·  Continuity engine  ·  Skills  ·  CLI  ·  Examples  ·  Docs  ·  Contributing

Story Skills gives agents a shared project format for fiction: the story bible, characters, worldbuilding, plot arcs, scenes, continuity state, promises and payoffs, and chapter drafts. Everything is plain markdown with YAML frontmatter, packaged as Agent Skills and as Codex and Claude Code plugins.

The companion story CLI treats the story bible as a checkable contract. Its continuity engine finds dead characters who reappear, payoffs that land before their setup, and stale story state, before a reader does. Read why it works this way.

  <b>Plain markdown</b>
  Every character, place, scene, and chapter is a markdown file with YAML frontmatter. Diff it, branch it, and open it in any editor.
</td>
<td width="33%" valign="top">
  
  <b>24 skills, premise to print</b>
  From testing a spark of an idea to the query letter and the print interior, in Claude Code, Codex, or any agent that reads <code>SKILL.md</code>.
</td>
<td width="33%" valign="top">
  
  <b>A continuity compiler</b>
  Deaths, promises, open questions, and object and knowledge state live in frontmatter, so contradictions show up like type errors.
</td>

  <b>Any language</b>
  Write in any language and script. Builds set right-to-left scripts and vertical Chinese, Japanese, and Korean text.
</td>
<td width="33%" valign="top">
  
  <b>Builds for every reader</b>
  EPUB, DOCX, a Shunn manuscript, a print interior, an HTML review copy, a screenplay, and Twine and ink, all from one project.
</td>
<td width="33%" valign="top">
  
  <b>A book by pull request</b>
  GitHub Actions templates draft the next chapter on a schedule and fail a pull request that breaks continuity.
</td>

Quick start

Writing in claude.ai without a terminal? Writers: start here shows how to upload a skill as a zip.

Claude Code. Type these inside a Claude Code session, not a shell:

/plugin marketplace add danjdewhurst/story-skills
/plugin install story-skills@story-skills

Codex

codex plugin marketplace add danjdewhurst/story-skills
codex plugin add story-skills@story-skills

Any other agent that supports SKILL.md can use the Agent Skills CLI:

npx skills add danjdewhurst/story-skills   # or: bunx skills add danjdewhurst/story-skills

Then ask your agent to "Start a new story".

• Install the skills covers the other agents, including GitHub Copilot, Cursor, Windsurf, Gemini CLI, and OpenCode.
• Let your agent install it has a prompt that installs the skills for you.
• New to Story Skills? Getting started walks through a first session. The documentation index links every guide.

The continuity engine