epub-hypercard-obsidian
Convert EPUB card books into Obsidian-ready HyperCard Markdown folders and portable zip files. Use when Codex needs to turn an EPUB with XHTML chapters, table-of-contents cards, keyword index cards, backlinks, Luhmann/Zettelkasten numbers, or cross-links into one Markdown file per card with verified relative links, keyword cards, previous/home/next navigation, and GitHub/shareable zip output.
npx skills add twhsi/skills --skill epub-hypercard-obsidian --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# EPUB HyperCard Obsidian Create an Obsidian folder from an EPUB card book. Each EPUB正文 card becomes one Markdown file. The output uses the four-table HyperCard format: 1. Luhmann/code + card title 2. Card content 3. Index-card hyperlinks 4. Previous/home/next navigation Use this skill for EPUBs generated from project notes, Luhmann/Zettelkasten chunks, chapter cards, keyword index cards, or book-check editions that need to become clickable Obsidian Markdown. ## Quick Start Run the generator: ```bash python3 scripts/epub_to_hypercard_obsidian.py INPUT.epub --out OUTPUT_DIR --zip ``` Recommended portable mode: ```bash python3 scripts/epub_to_hypercard_obsidian.py INPUT.epub --out 3.4-centaur-hypercard-obsidian-portable --zip --portable ``` The script writes: - `index.md`: stack home and chapter directory - `card-*.md`: one正文 card per EPUB article/chapter - `keyword-index.md`: keyword directory - `key-*.md`: one keyword index card per keyword - `OUTPUT_DIR.zip`: shareable zip, when `--zip` is set ## Workflow 1. Inspect the EPUB before converting. - Confirm it has `META-INF/container.xml`, `OEBPS/content.opf`, XHTML text files, and a spine. - Treat `Text/toc.xhtml` or the first non-ar
- Quick Start
- Workflow
- Filename Modes
- Four-Table Card Contract
- Link Rules
- Validation Output
python3 scripts/epub_to_hypercard_obsidian.py INPUT.epub --out OUTPUT_DIR --zip python3 scripts/epub_to_hypercard_obsidian.py INPUT.epub --out 3.4-centaur-hypercard-obsidian-portable --zip --portable
What does the epub-hypercard-obsidian skill do?
Convert EPUB card books into Obsidian-ready HyperCard Markdown folders and portable zip files. Use when Codex needs to turn an EPUB with XHTML chapters, table-of-contents cards, keyword index cards, backlinks, Luhmann/Zettelkasten numbers, or cross-links into one Markdown file per card with verified relative links, keyword cards, previous/home/next navigation, and GitHub/shareable zip output.
How do I install it?
Run `npx skills add twhsi/skills --skill epub-hypercard-obsidian --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From twhsi/skills, a repository with 256 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.