Markitdown
ImCa0/just-laws
Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.
把用户提供的书源文件(epub / mobi / azw / azw3 / prc / md / markdown / 文字型 pdf)提取并按章切分, 在 echo-reading 项目里生成 books/书名/chNN/raw.md(只灌纯原文)和 progress.md,并把源文件留档进 books/书名/。当用户给出电子书文件、Markdown、文字型…
Install Book Ingest
$ npx skills add plustar35/echo-reading --skill book-ingest -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install plustar35/echo-reading book-ingest --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/plustar35/echo-reading.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/book-ingest .claude/skills/book-ingest && rm -rf skills-srcUse ~/.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/
Install the "book-ingest" agent skill from https://github.com/plustar35/echo-reading/tree/main/.claude/skills/book-ingest into .claude/skills/book-ingest/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "book-ingest", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/plustar35/echo-reading/tree/main/.claude/skills/book-ingestType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add plustar35/echo-reading --skill book-ingest -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install plustar35/echo-reading book-ingest --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/plustar35/echo-reading.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/book-ingest .agents/skills/book-ingest && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "book-ingest" agent skill from https://github.com/plustar35/echo-reading/tree/main/.claude/skills/book-ingest into .agents/skills/book-ingest/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "book-ingest", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add plustar35/echo-reading --skill book-ingest -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install plustar35/echo-reading book-ingest --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/plustar35/echo-reading.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/book-ingest .cursor/skills/book-ingest && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "book-ingest" agent skill from https://github.com/plustar35/echo-reading/tree/main/.claude/skills/book-ingest into .cursor/skills/book-ingest/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "book-ingest", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/plustar35/echo-reading.git --path .claude/skills/book-ingest--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add plustar35/echo-reading --skill book-ingest -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install plustar35/echo-reading book-ingest --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/plustar35/echo-reading.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/book-ingest .gemini/skills/book-ingest && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "book-ingest" agent skill from https://github.com/plustar35/echo-reading/tree/main/.claude/skills/book-ingest into .gemini/skills/book-ingest/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "book-ingest", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install plustar35/echo-reading book-ingestInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add plustar35/echo-reading --skill book-ingest -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/plustar35/echo-reading.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/book-ingest .github/skills/book-ingest && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "book-ingest" agent skill from https://github.com/plustar35/echo-reading/tree/main/.claude/skills/book-ingest into .github/skills/book-ingest/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "book-ingest", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add plustar35/echo-reading --skill book-ingest -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install plustar35/echo-reading book-ingest --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/plustar35/echo-reading.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/book-ingest .opencode/skills/book-ingest && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "book-ingest" agent skill from https://github.com/plustar35/echo-reading/tree/main/.claude/skills/book-ingest into .opencode/skills/book-ingest/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "book-ingest", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
book-ingest- GitHub stars
- 146
- Token cost
- ~1.3k tokens
- SKILL.md length
- 273 words
- Files
- 7 (incl. scripts, references)
- Skills in repo
- 4
- Repo updated
- First seen
- Licence
- None found
At a glance
把用户提供的书源文件(epub / mobi / azw / azw3 / prc / md / markdown / 文字型 pdf)提取并按章切分, 在 echo-reading 项目里生成 books/书名/chNN/raw.md(只灌纯原文)和 progress.md,并把源文件留档进 books/书名/。当用户给出电子书文件、Markdown、文字型…
- Tasks that involve PDF
- SKILL.md covers 支持范围, 最重要的一条:切分策略不写死, 依赖 and 工作流
- Runs Python scripts from its folder; calls python3 and pip; reaches github.com
- Tasks that involve Markdown
What it does
Book Ingest is an agent skill from plustar35/echo-reading. 把用户提供的书源文件(epub / mobi / azw / azw3 / prc / md / markdown / 文字型 pdf)提取并按章切分, 在 echo-reading 项目里生成 books/书名/chNN/raw.md(只灌纯原文)和 progress.md,并把源文件留档进 books/书名/。当用户给出电子书文件、Markdown、文字型 PDF、下载链接,或说「导入这本书 / 加一本书 / 把这本书切好 / 读这本新书 / 这个文件能不能拆成章」时,务必使用本 skill。PDF 必须先探测;扫描型/图片型 PDF 暂不支持,需停止并告知用户。入库只到原文就位为止。
Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `references/split-examples.md`, `scripts/ebook_lib.py` and `scripts/inspect_book.py`).
It sits in Documents & Office, covering PDF and Markdown. The repository describes itself as: 跟 Claude Code 一起深读一本书的笔记本骨架——这是一种对话式深读一本书的体验，让读书变成一次次与claude的促膝长谈。
When your agent uses it
- Tasks that involve PDF
- Tasks that involve Markdown
Example prompts
- “/book-ingest”
Requirements
- Python 3
What it can do on your machine
Read from SKILL.md and the folder at commit e1343db. 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 5 files in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
python3pip
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
github.com
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
Book Ingest loads about 1.3k tokens when it runs, and up to ~2.9k if it reads all its reference files. Until then it costs about 79 tokens; SKILL.md has 273 words of instructions outside code blocks.
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 273 words (~1,254 tokens).
“把一个书源文件变成 books/<书名>/ 下一章一个目录 chNN/,原文落进 chNN/raw.md, 只灌纯原文(H1 标题 + 正文),供 echo-reading 逐段深读。本 skill 的职责到原文就位为止。 9 段笔记骨架由 chapter-split 在用户读该章时铺进同一个 chNN/。raw.md 是这章的源头底本, split 只读它、不改它。”
- name
- book-ingest
Files
SKILL.md and 6 other files (scripts, references) in .claude/skills/book-ingest of plustar35/echo-reading.
- SKILL.md
- references/split-examples.md
- scripts/ebook_lib.py
- scripts/inspect_book.py
- scripts/source_lib.py
- scripts/verify_chapters.py
- scripts/write_chapters.py
Open the folder on GitHubat commit e1343db
Compare with similar skills
Book Ingest 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Book Ingest this skillplustar35/echo-reading | 146 | — | ~1.3k | Automated safety check: Pass | None | |
| MarkitdownImCa0/just-laws | 781 | 14 repos | ~3.2k | Automated safety check: Notes | MIT | |
| Gzh Designisjiamu/gzh-design-skill | 4k | — | ~2.2k | Automated safety check: Pass | AGPL-3.0 | |
| Bookforge Korean Ebook PDF Makergongnyang/bookforge | 316 | 1 repos | ~1.7k | Automated safety check: Pass | MIT | |
| Huashu Markdown Publishing Pipelinealchaincyf/huashu-md-html | 910 | — | ~4.8k | Automated safety check: Pass | MIT | |
| Gzh DesignZJU-REAL/Easel | 3.4k | — | ~2.1k | Automated safety check: Pass | AGPL-3.0 |
Similar skills
Gzh Design
isjiamu/gzh-design-skill
微信公众号文章排版引擎，将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取，自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入（非 Markdown…
Bookforge Korean Ebook PDF Maker
gongnyang/bookforge
Produces book-style Korean ebook PDFs from a topic or finished manuscript, with six design styles, real book parts and quality-check gates before output.
Huashu Markdown Publishing Pipeline
alchaincyf/huashu-md-html
Converts files and web pages into clean Markdown, then turns Markdown into polished HTML, Word, PDF and EPUB using four templates.
Gzh Design
ZJU-REAL/Easel
微信公众号文章排版引擎：把 Markdown / Word(.docx) / PDF / 纯文本转成可直接粘贴进公众号编辑器的 HTML，自动章节编号、关键词标记、引言卡、目录、代码块、图片/GIF、作者签名；主题从 references/theme-index.md…
Paper Interpretation
digoal/blog
从论文 PDF 文件或论文 PDF URL 生成通俗易懂、图文并茂、带批判性评估的中文 Markdown 解读，并保存到当前项目的 markdown 目录。Use when the user asks to interpret,精读,解读,summarize,explain,analyze, or write an article from an academic paper PDF…
More from plustar35/echo-reading
Chapter Split
plustar35/echo-reading
把 echo-reading 里一个章节的原文，按内容理解切成若干 「阅读单元」，每个单元生成独立的 9 段笔记骨架（原文灌满、2-7 段占位、8/9 留白）+ 一份卷层面的 00-导读.md，并把 progress.md 改成「章→单元」两层。当用户说「读《X》第 N 章 / 下一章」而该章【尚未切分】、或说「把这章切成单元 / 这章太长读着累 / 分一下段」时使用。
Annotate
plustar35/echo-reading
给一本书某个阅读单元的原文，写一条划线批注笔记，存进旁车 NN.notes.md（原文不动）， 让 Obsidian 高亮那段、点开看笔记。当陪读 / 讨论中聊清了原文某处此处的意思、想留个重读时 就地浮现的记号，或用户说「给这段写个批注 / 记个笔记 / 标一下这里 / 划线记一下 / 在这旁边记一笔」时， 使用本…
Unit Video
plustar35/echo-reading
把一个阅读单元的「备读」做成「领读视频 / 备读视频 / 讲解视频」： 作者第一人称、课件式讲解、16:9 横屏。当前仅支持《道德经》。从 books/道德经/chNN/NN.md 出发， 经「口播稿 → TTS 时间轴 → 分镜 atoms/steps → 渐进渲染」产出 video/道德经/chNN/NN/领读视频.mp4。用户要求把《道德经》某章、某单元或备读内容做成视频、…
Related
Categories
Questions about Book Ingest
What does Book Ingest do?
把用户提供的书源文件(epub / mobi / azw / azw3 / prc / md / markdown / 文字型 pdf)提取并按章切分, 在 echo-reading 项目里生成 books/书名/chNN/raw.md(只灌纯原文)和 progress.md,并把源文件留档进 books/书名/。当用户给出电子书文件、Markdown、文字型…. Book Ingest is an agent skill from plustar35/echo-reading.
When should I use Book Ingest?
Book Ingest fits situations like: tasks that involve PDF; tasks that involve Markdown.
How do I install Book Ingest in Claude Code?
Run `npx skills add plustar35/echo-reading --skill book-ingest -a claude-code`. Or copy the skill folder (.claude/skills/book-ingest in plustar35/echo-reading) into .claude/skills/book-ingest in your project. Claude Code loads it when a task matches its description.
How do I install Book Ingest in Codex?
Run `npx skills add plustar35/echo-reading --skill book-ingest -a codex`. Or copy the skill folder (.claude/skills/book-ingest in plustar35/echo-reading) into .agents/skills/book-ingest in your project. Codex loads it when a task matches its description.
Can I use Book Ingest 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 plustar35/echo-reading --skill book-ingest -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/book-ingest, .gemini/skills/book-ingest, .github/skills/book-ingest and .opencode/skills/book-ingest in your project.
What does Book Ingest need to run?
Going by SKILL.md and its folder, Book Ingest needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and pip). Our summary lists: Python 3.
Does Book Ingest access the network?
SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.
Is Book Ingest 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 Book Ingest use?
No licence was found for Book Ingest or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.
How many tokens does Book Ingest use?
About 1.3k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.7k tokens, read only when the agent opens those files.
What are the alternatives to Book Ingest?
Skills that share tags, products or a category with Book Ingest: Markitdown (ImCa0/just-laws, 781 stars), Gzh Design (isjiamu/gzh-design-skill, 4k stars), Bookforge Korean Ebook PDF Maker (gongnyang/bookforge, 316 stars) and Huashu Markdown Publishing Pipeline (alchaincyf/huashu-md-html, 910 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Book Ingest?
plustar35 (a GitHub user) maintains it in plustar35/echo-reading, which has 146 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on June 13, 2026.
Source: plustar35/echo-reading on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.