Adaptation
Turns a story project into an audiobook narration script, Fountain screenplay, picture book, comics script, interactive fiction, or translated edition.
Content & WritingIntermediate★ 243⑂ 36AI score 9/10Last updated: Sep 24, 2026
What it does
- Provides a disciplined workflow for adapting an existing story project (
story.mdplus chapter/scene records) into another form or language. - Audiobook: pronunciation guide table, narration script with
[pause]scene breaks, runtime estimates at 155 wpm, and an ACX / Findaway production checklist including AI-narration disclosure. - Screenplay: builds a scene list from scene records, marks each scene keep/merge/cut/externalize, and drafts a
.fountainfile at roughly one page per minute. - Picture book: 32-page, 14-spread pagination plan with page-turn beats and illustration briefs.
- Comics/graphic novel: page plan then full page-panel-balloon-SFX script.
- Interactive fiction: branch map plus Ink (
.ink) or Twine (.twee) source. - Translation: glossary term base with
## Translations, a copied project that keeps English kebab-case ids, and cross-checks viastory validate/links/continuity/compare. - Hard rules keep the manuscript as source of truth, forbid inventing pronunciations for real names, and keep adaptation files out of the project root.
Who it's for
- Novelists moving a finished or revising draft into audio, film, or comics
- Authors and editors preparing glossaries and style sheets for translators
- Anyone structuring picture-book spreads or choose-your-own-adventure branches
- Existing users of the Story Skills CLI
Examples
- "Make an audiobook narration script" → add
pronunciation: SEER-shato characters and places, then runstory build . --format narration --out adaptations/audiobook/narration-script.md. - "Adapt this novel into a screenplay" → produce
adaptations/screenplay/scene-list.mdwith keep/merge/cut decisions, then draft{story-id}.fountainact by act. - "Prepare the Spanish edition" → translate glossary terms, copy the project, set
language, stripseries/book-number, then runstory compare ../book-es --against ..
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/danjdewhurst/story-skills/HEAD/skills/adaptation/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/adaptation folder from the GitHub repo danjdewhurst/story-skills into my ~/.claude/skills/adaptation/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/danjdewhurst/story-skills.git && mkdir -p ~/.claude/skills && cp -r story-skills/skills/* ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repo:
git clone https://github.com/danjdewhurst/story-skills.git - Create the skills directory:
mkdir -p ~/.claude/skills - Copy the skills:
cp -r story-skills/skills/* ~/.claude/skills/— copy all of them, since adaptation references scripts instory-maintenance. - Verify with
ls ~/.claude/skills/adaptation; you should seeSKILL.mdand areferences/folder. - Optional CLI: inside the repo run
bun installthenbun run story -- --help, or use the bundlednode scripts/story.jsfallback. - Restart Claude Code and try a trigger phrase like "make an audiobook narration script" or "adapt this to a screenplay".
View source on GitHub ↗License: MIT