script-adapt

Convert long novels into micro-series scripts via a three-phase pipeline.

2|1|Updated Apr 18, 2026
One-click install
npx skills add https://github.com/littlewwwhite/AgentOS-TS --skill script-adapt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: script-adapt
Source: https://github.com/littlewwwhite/AgentOS-TS/tree/main/.claude/skills/script-adapt
Command: npx skills add https://github.com/littlewwwhite/AgentOS-TS --skill script-adapt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-docx, openpyxl, pdfplumber, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Long novels require substantial manual effort to plan structure, design a screenplay blueprint, and extract a production-ready script. This Skill automates that by providing a deterministic three-phase pipeline: analysis/design, writing, and structure extraction.

Core Features & Use Cases

  • Phase A: Analyze the source text and generate design.json and catalog.json to anchor world-building and assets.
  • Phase B: Write ep*.md scene transcripts using the design/catalog guidance, with optional parallel writing and validation steps.
  • Phase C: Parse the Phase B outputs into a structured script.json via the Phase 3 parser, enabling downstream rendering and QA.
  • Typical use case: turning a lengthy novel (≥3000 characters) into a ready-to-publish micro-series script with clear episode segmentation and asset mappings.

Quick Start

Provide the full end-to-end workflow to convert a long novel into design.json, catalog.json, episode drafts ep*.md, and the final script.json using the built-in scripts.

Frequently Asked Questions about script-adapt

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a long novel into a micro-series script automatically?

Converting a long novel into a production-ready micro-series script requires a three-phase pipeline: analyzing the source text to generate world-building and catalog JSON files, writing episodic scene transcripts, and parsing them into a final structured script.

What is the best way to structure episode segmentation for a novel-to-script adaptation?

The best way to structure episode segmentation is to run an initial analysis phase that generates a catalog file anchoring world-building and assets, which then provides deterministic guidance for writing individual episode scene transcripts.

Can I use Python to extract scripts from PDF and DOCX source novels?

Yes, you can process DOCX, XLSX, and PDF source novels using Python-based tooling. The pipeline depends on modules such as python-docx, openpyxl, and pdfplumber to read these formats and extract the source text for adaptation.

Does novel-to-script adaptation work for texts under 3000 characters?

Novel-to-script adaptation is designed for lengthy source texts of at least 3000 characters. Texts under this threshold lack sufficient content to anchor the world-building design and generate clear episode segmentation for a micro-series.

How do I export a parsed script into a structured JSON file for rendering?

To export a parsed script into a structured JSON file, you run the final extraction phase on the generated episode markdown transcripts. This parser processes the drafts and outputs a structured script JSON file enabling downstream rendering and QA.