Agent skill · Workflow & Productivity

project-note-json-to-epub

Convert structured project-note JSON manuscripts into validated EPUB and optional Kindle-clickable PDF files. Use when the user asks to turn project notes, book-system JSON, FIRE-indexed notes, Luhmann/Zettelkasten numbered chunks, table-of-contents cards, index cards, cross-linked project notes, or manuscript JSON into an EPUB/PDF with chapter directories, keyword index cards, weighted links, bidirectional backlinks, versioned filenames, chapter-splitting plans, and full link testing.

twhsigithub.com/twhsiGitHub ↗
claude-codecodex
Install
npx skills add twhsi/skills --skill project-note-json-to-epub --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 2
SKILL.md size: 9 KB
Bundled scripts: none
Path: skills/project-note-json-to-epub/SKILL.md
Open the folder on GitHub →
Where it comes from
Source: twhsi/skills
Stars: 256
Language: Python

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# 專案筆記Json變成Epub Use this skill when a project-note JSON or folder-derived JSON manuscript needs to become an EPUB, or an EPUB plus a PDF review/distribution edition, especially when the user wants chapter directories, index cards, cross-links, keyword numbering, versioned check editions, Chinese character counts, chapter-splitting plans, Kindle-clickable PDF links, or full EPUB/PDF link verification. Chinese trigger phrases include: - `專案筆記Json變成Epub` - `目錄索引卡交叉連結` - `把這章做成EPUB` - `章節拆書` - `關鍵字索引卡` - `雙向連結EPUB` - `同時生成PDF` - `Kindle可以點擊連結` ## Core Workflow 1. Inspect the JSON schema before generating anything. - Identify `title`, `sources`, `toc`, `chunks`, `index`, and validation fields if present. - Confirm each chunk has a stable code, title, body or source text, EPUB page/anchor, and Chinese character count. - If the JSON is missing fields, derive them deterministically and write the enriched JSON first. 2. Normalize the book identity. - Use the user-provided book name exactly. - For check editions, name versions as: `{書名} 檢查版 YYYY-MM-DD NN`. - Use an ASCII-safe or underscore filename when needed: `{書名}_檢查版_YYYY-MM-DD_NN.epub`. - Keep a simple `download.epub` copy for mobile s

What's inside
Steps it walks through
  1. Core Workflow
  2. EPUB Requirements
  3. PDF Requirements
  4. Validation Checklist
  5. Delivery
Ships with 1 file
  • agents/openai.yaml
More from skills
All skills →
About this skill
What does the project-note-json-to-epub skill do?

Convert structured project-note JSON manuscripts into validated EPUB and optional Kindle-clickable PDF files. Use when the user asks to turn project notes, book-system JSON, FIRE-indexed notes, Luhmann/Zettelkasten numbered chunks, table-of-contents cards, index cards, cross-linked project notes, or manuscript JSON into an EPUB/PDF with chapter directories, keyword index cards, weighted links, bidirectional backlinks, versioned filenames, chapter-splitting plans, and full link testing.

How do I install it?

Run `npx skills add twhsi/skills --skill project-note-json-to-epub --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.

Keep going