case-narrator
Claude Code skill that turns business-school case PDFs into narrated MP3 read-throughs, using local Kokoro TTS
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/abhiroopvaddiparthi-a11y--case-narrator)HTML
<a href="/listings/abhiroopvaddiparthi-a11y--case-narrator"><img src="/api/listings/abhiroopvaddiparthi-a11y--case-narrator/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
cp -r skill ~/.claude/skills/case-narrator
The first time the skill runs it sets itself up:
- **Mac:** `scripts/setup-mac.sh` uses only built-in tools (curl, shasum, tar), so there's no developer-tools popup. It downloads uv 0.13.6 (SHA-256 pinned), which installs a private Python 3.12 into `~/.case-narrator/python`, then runs `setup.py`. - **Windows:** `python scripts/setup.py` (Python 3.10+).
`setup.py` creates `~/.case-narrator/venv`, installs the exact versions in `requirements.txt` and downloads the voice model (about 120 MB), verifying its SHA-256. Everything lives in `~/.case-narrator`; deleting that folder plus `~/.claude/skills/case-narrator` uninstalls it.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 54 lines
- # Case Narrator
- Turns a business-school case PDF into a narrated MP3 for listening on the go. It is packaged as a
- Claude Code skill: drop the PDF into Claude, say "read this case to me", and the MP3 lands in
- iCloud Drive › Case Audio (Mac) or Music › Case Audio (Windows).
- ## How it works
- 1. `skill/scripts/extract_clean.py` pulls the text out of the PDF and strips mechanical noise
- (watermarks, running headers, page numbers, footnote markers). It keeps exhibits with their
- column layout.
- 2. Claude writes the narration following `skill/narration-guide.md` (light condensing, numbers
- spelled out for speech, a short gist for each exhibit).
- 3. `skill/scripts/synthesize.py` reads the narration with the local Kokoro voice model (default
- voice `bm_fable`) and encodes the MP3.
- Everything except step 2 runs on the computer. The PDF text goes to Claude, and nothing else
- leaves the machine.
- ## Folders
- | Path | What |
- |---|---|
- | `skill/` | The skill itself (source of truth) |
- | `test-fixtures/` | A fictional HBS-style case and the script that generates it |
- | `voice-samples/` | One-minute samples of six voices |
- | `work/` | Scratch output from test runs |
- | `models/`, `.venv/` | Local development copies; the installed skill uses `~/.case-narrator/` |
- ## Install / update the skill on this machine
- ```bash
- cp -r skill ~/.claude/skills/case-narrator
- ```
- The first time the skill runs it sets itself up:
- - **Mac:** `scripts/setup-mac.sh` uses only built-in tools (curl, shasum, tar), so there's no
- developer-tools popup. It downloads uv 0.13.6 (SHA-256 pinned), which installs a private
- Python 3.12 into `~/.case-narrator/python`, then runs `setup.py`.
- - **Windows:** `python scripts/setup.py` (Python 3.10+).
- `setup.py` creates `~/.case-narrator/venv`, installs the exact versions in `requirements.txt`
- and downloads the voice model (about 120 MB), verifying its SHA-256. Everything lives in
- `~/.case-narrator`; deleting that folder plus `~/.claude/skills/case-narrator` uninstalls it.
- ## Security notes
- - Downloads: uv and both model files are checked against pinned SHA-256 values; packages are
- pinned to exact versions (no known vulnerabilities per `pip-audit`, 2026-11-14).
- - The voice libraries contain no network code; only the PDF text goes to Claude.
- - The skill tells Claude to treat PDF text as content, never instructions, and to run only its
- own scripts.
- - Partial MP3s are built in `~/.case-narrator/tmp`, so a failed run never syncs junk to the phone.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.