All skills
danjdewhurst avatar

/adaptation

@7648170

This skill should be used when the user asks to "make an audiobook", "narration script", "narrator", "ACX", "Findaway", "pronunciation guide", "how long is the audiobook", "adapt to a screenplay", "Fountain", "screenplay", "picture book", "spreads", "illustration notes", "art notes", "comic script", "comics script", "graphic novel", "panels", "interactive fiction", "Ink", "Twine", "choose your own adventure", "translate the book", "translation", "foreign edition", "glossary for translators", or wants to turn a story project into another form or language.

Use this Skill: https://skilld.dev/gh/danjdewhurst/story-skills/adaptation

This session only. Nothing lands on disk.

referencesfountain.md

≈1.4k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Screenplay In Fountain

Fountain is plain-text screenplay markup. Screenwriting apps (Highland, Beat, Slugline, Fade In, WriterSolo, Afterwriting, and others) import it and format it to industry layout. Save the script as adaptations/screenplay/{story-id}.fountain, never as a root .md file.

Scene List From Scene Records

Build adaptations/screenplay/scene-list.md before writing any script page:

---
type: scene-list
story: {story-id}
updated: YYYY-MM-DD
---

# Scene List: {Title}

| # | Source scene | Slugline | Characters | Beat | Decision |
|---|--------------|----------|------------|------|----------|
| 1 | chapter-01-scene-01 | EXT. HARBOR WALL - NIGHT | mara, venn | Mara sees the second light | keep |
| 2 | chapter-01-scene-02 | INT. ARCHIVE - CONTINUOUS | mara | Memory of her father | externalize |
  • Slugline: INT., EXT., or INT./EXT. from the setting (interior, exterior, or both) on the scene, else on its location (set it first; ask the author when the prose does not settle it), the location record's name in capitals, and DAY, NIGHT, or CONTINUOUS from the scene's time.
  • Characters: the scene's characters, not mentions.
  • Beat: what changes in the scene, in one line. Scenes with an outcome field already record it.
  • Decision: keep, merge (with which), cut, externalize (interior content that needs a visible action, image, or line), or new (a scene the film needs that the book does not have).
  • Use reading order for the default structure; story timeline . gives story-time order when the film should be told chronologically.

Starting The Script From The Build

story build . --format fountain --out adaptations/screenplay/{story-id}.fountain writes the scene skeleton: title page (Title, Credit, Author, Source), a ## section per chapter, and per scene record a heading, the scene title as a = synopsis, and [[Source: ...]], [[Characters: ...]], story time, dilemma, and outcome notes. It holds no action or dialogue.

  • Headings follow the records: named times become DAWN, MORNING, DAY, EVENING, or NIGHT, and HH:MM becomes DAY (06:00-17:59) or NIGHT. Change a heading to CONTINUOUS or a more specific time as the script needs.
  • A forced heading (.REEF - NIGHT) has no setting behind it, and LOCATION TBD has no location. Fix the scene or location record, or write the heading by hand.
  • Apply the scene list: delete cut scenes, merge headings, add new scenes (with a [[Source: new]] note), and add # act sections.
  • The CLI refuses to overwrite the file once it exists. To see what changed in the records, build to dist/ and compare.

Novel To Screen

  • Length: about one page per minute. A feature runs roughly 90-120 pages; a TV hour roughly 50-60. A novel usually loses most of its scenes; merge characters and locations before cutting plot.
  • Externalize: film shows behavior. Replace thought with action, choice, and subtext. Voiceover is a tool, not a fix.
  • Compress time: combine scenes that do the same job; start scenes late and leave early.
  • Structure: keep the book's turning points (see the arc files) and place them near the film's act breaks.
  • POV: a film has no narrator by default. A first-person novel's voice has to come through the lead's actions and the camera's choices.
  • Adaptation rights must be cleared before a script is shopped. See the publishing skill's rights inventory.

Fountain Syntax

Title: The Last Ember
Credit: Written by
Author: Jane Doe
Source: Based on the novel by Jane Doe
Draft date: 2027-01-15
Contact: [TODO: author to supply]

FADE IN:

EXT. HARBOR WALL - NIGHT

Waves slap stone. MARA (30s, salt-stained coat) climbs the wall, a lantern
in her teeth.

MARA
(muttering)
Every night. Every single night.

She stops. Below her, a second light flickers on the water.

VENN (O.S.)
You shouldn't be up here.

CUT TO:

.FLASHBACK - THE ARCHIVE, TWENTY YEARS AGO

[[Source: chapter-03-scene-02]]

Young Mara watches her father seal a box of glass plates.

> THE END <
Element Syntax
Title page Key: value lines at the top, then a blank line
Scene heading A line starting INT., EXT., EST., INT./EXT., or I/E, with a blank line before; force any line with a leading .
Action Any ordinary paragraph; force with a leading !
Character A line in capitals, blank line before, dialogue on the next line; extensions (V.O.), (O.S.), (CONT'D); force with @
Dialogue Lines directly after a character or parenthetical
Parenthetical (wrylies) on their own line inside dialogue
Dual dialogue ^ after the second character's name
Transition A capitalized line ending in TO:, blank lines around it; force with a leading >
Centered text > text <
Emphasis *italic*, **bold**, _underline_
Lyrics Leading ~
Page break === on its own line
Notes [[note]], not printed
Boneyard /* cut material */, not printed
Sections #, ##, ### for acts and sequences; not printed
Synopses = one-line summary; not printed

Use # sections to mirror the scene list's acts, and [[...]] notes to record the source scene id for each scene so revisions trace back to the book.

Source: SKILL.md on GitHub

No alerts3d3 checks · Risk SAFE
  • Gen Agent Trust Hub3d

    This skill is designed to help authors adapt their story projects into various formats such as audiobooks, screenplays, and comics. It utilizes a custom 'story' command-line tool to automate script generation and project validation. The analysis identified a standard risk of indirect prompt injection, as the skill processes user-provided manuscript text. Additionally, the skill includes instructions for executing local scripts to maintain the project if the primary tool is not installed.

  • Socket3d

    No alerts

  • Snyk3d

    Risk: LOW · No issues

Signed by skilld at 7648170. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 19 hours ago.

Activeupdated 4 days ago

README badge

README badge for danjdewhurst/story-skills/adaptation