Popiai-skill/audio-creation/audiobook/phases/00-import.md

Phase 0: Import Book

Workflow

1. Ask the user to provide a book file (supports .txt / .md / .pdf / .epub)
2. Read file contents:
   • .txt / .md: Read directly
   • .pdf: Use the Read tool (supports PDF reading)
   • .epub: Use Bash tool to run Python parsing (see below)
3. Save parsed plain text to source/book.txt
4. Confirm with the user that content was read correctly (show a preview of the first few hundred characters)

State File

After import, write .audiobook-state.json using Python json.dumps().

skillScriptsPath must be the real absolute path — not a placeholder. Derive it from the available_skills list visible in your system context:

• Find the <location> entry for the audiobook skill, e.g.: file:///Users/alice/.hub/skills/audiobook/SKILL.md
• Strip file:// and /SKILL.md, then append /scripts: → /Users/alice/.hub/skills/audiobook/scripts

That string is your skill_scripts_path. Use it literally — do not guess or reconstruct from memory.

import json, os, sys
from pathlib import Path

# Replace the string below with the path you derived above — do this BEFORE running the script.
# Example: "/Users/alice/.hub/skills/audiobook/scripts"
skill_scripts_path = "/FILL_IN_BEFORE_RUNNING/audiobook/scripts"

# Verify the path exists before continuing
if not Path(skill_scripts_path).is_dir():
    print(f"ERROR: skillScriptsPath does not exist: {skill_scripts_path}", file=sys.stderr)
    sys.exit(1)

# Locate the state file (project-relative, not skill-relative)
audiobook_root = Path(os.getcwd()) / ".audiobook"
book_dir = audiobook_root / "<book_name>"
book_dir.mkdir(parents=True, exist_ok=True)

state = {
    "currentStep": "parse",
    "bookName": "<book_name>",
    "sourceFile": "source/book.txt",
    "skillScriptsPath": skill_scripts_path,
    "totalChapters": 0,
    "characters": [],
    "voiceMapping": {
        "narrator": {"voiceId": None, "speed": 0.9},
        "characters": {}
    },
    "chaptersCompleted": [],
    "currentChapter": 0
}
(book_dir / ".audiobook-state.json").write_text(json.dumps(state, ensure_ascii=False, indent=2))
print(f"State file written. skillScriptsPath={skill_scripts_path}")

Before running: replace skill_scripts_path with the actual value derived above. The print at the end confirms what was written.

EPUB Parsing

import zipfile
from html.parser import HTMLParser

class TextExtractor(HTMLParser):
    def __init__(self):
        super().__init__()
        self.text = []
        self.skip = False
    def handle_starttag(self, tag, attrs):
        if tag in ('script', 'style'):
            self.skip = True
    def handle_endtag(self, tag):
        if tag in ('script', 'style'):
            self.skip = False
        if tag in ('p', 'div', 'br', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6'):
            self.text.append('\n')
    def handle_data(self, data):
        if not self.skip:
            self.text.append(data)