New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

EPUB to HyperCard Obsidian

by twhsi in twhsi/skills

Converts an EPUB card book into an Obsidian folder with one Markdown file per card, keyword cards, navigation links and an optional shareable zip.

No licenceAuto-check passedDocuments & Office

Install EPUB to HyperCard Obsidian

skills CLI
$ npx skills add twhsi/skills --skill epub-hypercard-obsidian -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install twhsi/skills epub-hypercard-obsidian --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/twhsi/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/epub-hypercard-obsidian .claude/skills/epub-hypercard-obsidian && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
epub-hypercard-obsidian
GitHub stars
259
Token cost
~1k tokens
SKILL.md length
396 words
Files
5 (incl. scripts, assets)
Skills in repo
18
Repo updated
First seen
Licence
None found

At a glance

Converts an EPUB card book into an Obsidian folder with one Markdown file per card, keyword cards, navigation links and an optional shareable zip.

  • Works in 4 steps: Luhmann/code + card title → Card content → Index-card hyperlinks → …
  • Converting an EPUB of Zettelkasten-style cards into linked Obsidian notes
  • SKILL.md covers Quick Start, Workflow, Filename Modes and Four-Table Card Contract, plus 2 more sections
  • Runs Python scripts from its folder; calls python3

What it does

The bundled Python script `scripts/epub_to_hypercard_obsidian.py` takes an EPUB and writes an Obsidian-ready folder in a four-table HyperCard layout: a code and title, the card content, index-card hyperlinks, and previous, home and next navigation. Output includes `index.md` as the home and chapter directory, `card-*.md` for each article or chapter, `keyword-index.md`, and one `key-*.md` per keyword.

Before converting, the agent inspects the EPUB for `META-INF/container.xml`, `OEBPS/content.opf`, XHTML text files and a spine, then treats the table of contents as the directory card and the index page as the source of keyword cards. Links stay in plain `[label](file.md)` form rather than heading anchors, and every link must resolve to a file in the output folder. The `--zip` flag adds a shareable archive, and `--portable` suits sharing with GitHub, Finder or Windows. The agent reports the folder and zip paths, the card and keyword counts and the link check result.

When your agent uses it

  • Converting an EPUB of Zettelkasten-style cards into linked Obsidian notes
  • Splitting chapter cards and keyword index cards into separate Markdown files
  • Packaging a linked note folder as a zip for sharing or upload
  • Checking that every relative link in generated notes resolves

Example prompts

  • “Convert centaur-book.epub into an Obsidian HyperCard folder and make a zip.”
  • “Run the EPUB converter in portable mode on ./books/notes.epub.”
  • “After converting, tell me the card count, the keyword count and whether all links resolved.”

Requirements

  • Python 3
  • An EPUB with XHTML chapters, a spine and index cards

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Luhmann/code + card title
  2. Card content
  3. Index-card hyperlinks
  4. Previous/home/next navigation

What it can do on your machine

Read from SKILL.md and the folder at commit 287d0f4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

EPUB to HyperCard Obsidian loads about 1k tokens when it runs. Until then it costs about 105 tokens; SKILL.md has 396 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~105
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 396 words (~1,024 tokens).

“Create an Obsidian folder from an EPUB card book. Each EPUB正文 card becomes one Markdown file. The output uses the four-table HyperCard format:”

— opening of SKILL.md by twhsi
name
epub-hypercard-obsidian

Read the full SKILL.md on GitHub

Files

SKILL.md and 4 other files (scripts, assets) in skills/epub-hypercard-obsidian of twhsi/skills.

  • SKILL.md
  • agents/openai.yaml
  • assets/hypercard-card-template.md
  • assets/hypercard-folder-layout.txt
  • scripts/epub_to_hypercard_obsidian.py

Open the folder on GitHubat commit 287d0f4

Compare with similar skills

EPUB to HyperCard Obsidian next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

EPUB to HyperCard Obsidian compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
EPUB to HyperCard Obsidian this skilltwhsi/skills259—~1kAutomated safety check: PassNone
MineruNebutra/MinerU-Skill123—~1.4kAutomated safety check: PassMIT
MineruNebutra/MinerU-Skill123—~504Automated safety check: PassMIT
Knap Markdown Templateskepano/obsidian-skills49k2 repos~986Automated safety check: PassMIT
Obsidian MarkdownKevRojo/Dulus167—~1.4kAutomated safety check: PassGPL-3.0
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0

Similar skills

  • Mineru

    Nebutra/MinerU-Skill

    An AI-Native skill for parsing PDF / Office / image files into clean Markdown with MinerU — a fast, zero-config document parser for AI agents.

    123 GitHub stars~1.4k tokensUpdated 17 days ago
    Documents & OfficeAuto-check passed

  • Mineru

    Nebutra/MinerU-Skill

    An AI-Native skill for parsing PDF / Office / image files into Markdown with MinerU — a fast, zero-config document parser for AI agents.

    123 GitHub stars~504 tokensUpdated 17 days ago
    Documents & OfficeAuto-check passed

  • Knap Markdown Templates

    kepano/obsidian-skills

    Renders Markdown notes from Knap templates and JSON data on the command line, including notes built from Defuddle web page output.

    49k GitHub starsUsed in 2 repos~986 tokens
    Documents & OfficeAuto-check passed

  • Obsidian Markdown

    KevRojo/Dulus

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    167 GitHub stars~1.4k tokensUpdated 8 days ago
    Documents & OfficeAuto-check passed

  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed

  • Markdown Converter

    Team-Commonly/commonly

    Convert binary documents (PDF, DOCX, XLSX, PPTX, HTML, EPUB, images) to clean LLM-friendly Markdown using Microsoft's markitdown Python tool.

    1.4k GitHub stars~557 tokensUpdated yesterday
    Documents & OfficeAuto-check passed

More from twhsi/skills

All 18 skills in this repo

  • A4 Eight Page Booklet

    twhsi/skills

    Compiles notes, outlines, PDFs or BIRD and iMandalArt content into an eight-page mini book, with upright page PDFs, a reading PDF, an editable DOCX and an A4 landscape print sheet.

    259 GitHub stars~4.4k tokensUpdated 2 mo ago
    Auto-check passed

  • Luhmann Note Numberer

    twhsi/skills

    Assigns and checks Luhmann-style codes for book manuscript notes and Obsidian card folders without renumbering existing notes.

    259 GitHub stars~1.5k tokensUpdated 2 mo ago
    Auto-check passed

  • Fantastical Calendar

    twhsi/skills

    Turns scheduling requests into Fantastical events or reminders on macOS, previewing the parsed item in the app first and adding it only when you confirm.

    259 GitHub stars~688 tokensUpdated 2 mo ago
    Auto-check passed

  • iMandalArt Mandala Cards

    twhsi/skills

    Turns source material into a pure-text 3x3 iMandalArt 2.2 card with a five-character center and eight labeled surrounding angles, laid out with hard line breaks.

    259 GitHub stars~3k tokensUpdated 2 mo ago
    Auto-check passed

  • BIRD Knowledge Address Protocol

    twhsi/skills

    Applies a formal address protocol to manuscript text and TheBrain thoughts, assigning each a stable address, structured index, and verified links.

    259 GitHub stars~2.5k tokensUpdated 2 mo ago
    Auto-check passed

  • Todays Daily Plan

    twhsi/skills

    Write spoken daily planning notes into an Obsidian Mandala Grid day-plan Markdown file.

    259 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed

Works with

Categories

Questions about EPUB to HyperCard Obsidian

What does EPUB to HyperCard Obsidian do?

Converts an EPUB card book into an Obsidian folder with one Markdown file per card, keyword cards, navigation links and an optional shareable zip. py` takes an EPUB and writes an Obsidian-ready folder in a four-table HyperCard layout: a code and title, the card content, index-card hyperlinks, and previous, home and next navigation.md` per keyword.

When should I use EPUB to HyperCard Obsidian?

EPUB to HyperCard Obsidian fits situations like: converting an EPUB of Zettelkasten-style cards into linked Obsidian notes; splitting chapter cards and keyword index cards into separate Markdown files; packaging a linked note folder as a zip for sharing or upload; checking that every relative link in generated notes resolves.

How do I install EPUB to HyperCard Obsidian in Claude Code?

Run `npx skills add twhsi/skills --skill epub-hypercard-obsidian -a claude-code`. Or copy the skill folder (skills/epub-hypercard-obsidian in twhsi/skills) into .claude/skills/epub-hypercard-obsidian in your project. Claude Code loads it when a task matches its description.

How do I install EPUB to HyperCard Obsidian in Codex?

Run `npx skills add twhsi/skills --skill epub-hypercard-obsidian -a codex`. Or copy the skill folder (skills/epub-hypercard-obsidian in twhsi/skills) into .agents/skills/epub-hypercard-obsidian in your project. Codex loads it when a task matches its description.

Can I use EPUB to HyperCard Obsidian in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add twhsi/skills --skill epub-hypercard-obsidian -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/epub-hypercard-obsidian, .gemini/skills/epub-hypercard-obsidian, .github/skills/epub-hypercard-obsidian and .opencode/skills/epub-hypercard-obsidian in your project.

What does EPUB to HyperCard Obsidian need to run?

Going by SKILL.md and its folder, EPUB to HyperCard Obsidian needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3; An EPUB with XHTML chapters, a spine and index cards.

Does EPUB to HyperCard Obsidian access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is EPUB to HyperCard Obsidian safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does EPUB to HyperCard Obsidian use?

No licence was found for EPUB to HyperCard Obsidian or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does EPUB to HyperCard Obsidian use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to EPUB to HyperCard Obsidian?

Skills that share tags, products or a category with EPUB to HyperCard Obsidian: Mineru (Nebutra/MinerU-Skill, 123 stars), Mineru (Nebutra/MinerU-Skill, 123 stars), Knap Markdown Templates (kepano/obsidian-skills, 49k stars) and Obsidian Markdown (KevRojo/Dulus, 167 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains EPUB to HyperCard Obsidian?

twhsi (a GitHub user) maintains it in twhsi/skills, which has 259 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on July 21, 2026.

Source: twhsi/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.