read

read is a skill for Claude Code from SuperJJ007/eatbook. It costs 114 tokens per session (1,238 once invoked), scanned A, original, MIT.

A Chinese-language skill for carefully reading books chapter by chapter and creating source-linked notes, knowledge graphs, and reading guides.

In plain words
What is it for?
Use it to build chapter notes, verify quoted passages, map concepts and relationships, and produce a guide for studying a book.
Why use it?
It provides a documented reading process that checks notes against the original text instead of relying on memory alone.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter.

Part of the eatbook plugin — 5 skills shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/superjj007/eatbook/read
Any agent
npx skills add SuperJJ007/eatbook --skill read
Clone the repo
git clone --depth 1 https://github.com/SuperJJ007/eatbook

Made for: Claude Code.

Or install eatbook, the plugin that ships this one along with the rest of its 5 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for read

README.md
[![agentmods](https://agentmods.dev/badge/skills/superjj007/eatbook/read.svg)](https://agentmods.dev/skills/superjj007/eatbook/read)
Your own site
<a href="https://agentmods.dev/skills/superjj007/eatbook/read"><img src="https://agentmods.dev/badge/skills/superjj007/eatbook/read.svg" alt="Measured on agentmods" height="20"></a>
Per session 114 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,238 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00114 $0.01238
Opus 5 $0.00057 $0.00619
Sonnet 5 $0.00023 $0.00248
Haiku 4.5 $0.00011 $0.00124

Measured 5d ago against content hash 6348a625c8d1, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

read scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/graph_tools.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

eatbook-plugin/skills/read/SKILL.md · 68 lines

How it starts

The opening of the file, as written. The whole thing — 68 lines — stays where its author put it; the contents beside it link to each section on GitHub.

/eatbook:read — 深读打底

铁律先行:本 skill 的一切产出必须服从 references/grounding.md 防幻觉协议。 开始前先读它;给子 agent 派活时必须把该文件路径写进 prompt。

前置检查

  1. 定位书目录 domains/<领域>/books/<书slug>/,确认存在 source/full.mdnotes/_toc.json
  2. _toc.json 播报章节规模(章数、各章行数)
  3. 若部分章节笔记已存在:播报进度,从缺口继续(断点续读)

阶段 1:逐章精读

_toc.json 的每一章:

  1. 全文必读:按 start_line/end_line 用 Read 读取全章。超过 1500 行的章分多次连续 Read,不允许跳读、不允许只读开头
  2. 写章节笔记 notes/chNN.md:复制 templates/chapter-note.md 结构填写;每条事实/概念/理论带锚点 【chN L起-止】"≤25字原文引文"
  3. 抽取图谱 graph/staging/<书slug>-chNN.json:按 references/kg-schema.md 抽取实体/关系(只抽本章核心,跳过路过式提及)

并行加速:章节相互独立,可每章派一个子 agent(Agent 工具)。子 agent prompt 必须包含:

  • 书目录绝对路径 + 该章行号范围
  • grounding.md、kg-schema.md、chapter-note.md 三个文件的绝对路径,并要求先读
  • 要求返回:笔记文件路径 + staging JSON 路径 + 自检声明("全章 N 行已完整读取")

章数多时建议分批(每批 4-6 章),每批完成后抽查再继续。

阶段 2:验证 pass(不可省略)

独立子 agent(不能是写笔记的那个)执行:

  1. 从每章笔记抽样 ≥15% 条目 + 全部 [争议] 条目
  2. 对每条:用 Grep 在 source/full.md 对应行号附近搜索引文(允许 OCR 噪声的近似匹配,见 grounding.md §验证)
  3. 产出 notes/_verify-chNN.md:每条 PASS/FAIL + FAIL 原因
  4. 任何 FAIL → 对应章节打回重读修正,再验证,直到通过

阶段 3:综合

只允许从章节笔记综合,禁止回模型记忆取材(发现笔记覆盖不足就回阶段 1 补读)。

  1. 单书导读 guide.md:按 templates/book-guide.md。蓝本质量标杆是 books/playing-with-reality/guide.md(逐章核心论点+论证路径+部级弧线)
  2. 图谱合并
    python3 ${CLAUDE_SKILL_DIR}/scripts/graph_tools.py merge <领域目录>      # staging → entities/relations.json
    python3 ${CLAUDE_SKILL_DIR}/scripts/graph_tools.py dupes <领域目录>      # 输出疑似重复实体
    
    对 dupes 输出逐对判断(依据 description,参考 kg-schema.md §去重),把确认的合并写入 graph/aliases.json,重跑 merge。最后:
    python3 ${CLAUDE_SKILL_DIR}/scripts/graph_tools.py validate <领域目录>   # 悬空边/枚举校验,必须零报错
    python3 ${CLAUDE_SKILL_DIR}/scripts/graph_tools.py mermaid <领域目录>    # 重建 roadmap.md
    
  3. 领域级文档增量更新
    • overview.md(分层式:1 页全域地图 + 每分支 1-2 页——核心问题/基本事实/主要理论/未解之谜)
    • facts.md(新事实并入;多书一致的升级为 [共识],书间矛盾的标 [争议] 并列双方+各自锚点)
  4. 更新 00-domain.md 进度表:"深读打底 ☑"

Read the full file on GitHub · 68 lines

Files

What ships with it

5 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 68 lines · 114 tokens per session scan A 6348a625c8d1

Subscribe to this mod's changes

read is a skill published in the GitHub repository SuperJJ007/eatbook (4 stars, last pushed 3mo ago), licensed MIT. It adds 114 tokens to every session and 1,238 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

hr-onboarding

A new-hire onboarding plan as a single page — first week schedule, buddy + manager intro, learning track, equipment checklist, and "you're set when…" outcomes. Use when the brief mentions "onboarding", "new hire", "first week plan", or "入职".

nexu-io/open-design · 62 tokens

book-mirror

Take any book (EPUB/PDF), produce a personalized chapter-by-chapter analysis. Each chapter is preserved in detail (The Chapter) and mirrored back to the reader's actual life (The Mirror) using brain context. The mirror observes and resonates — a friend pointing out parallels, NOT a consultant rearranging the reader's…

garrytan/gbrain · 138 tokens

miniapp

Build a tiny interactive HTML playground only when someone asks to see, play with, or step through a mechanism.

yc-software/qm · 25 tokens

eli5

Explain research, papers, or technical ideas in plain English with minimal jargon, concrete analogies, and clear takeaways. Use when the user says "ELI5 this", asks for a simple explanation of a paper or research result, wants jargon removed, or asks what something technically dense actually means.

companion-inc/feynman · 63 tokens

deck-course-module

暖纸背景 + Playfair, 左侧学习目标常驻, 含 MCQ 自测页.

nexu-io/html-anything · 25 tokens

best-practices

Searchable knowledge base of 152+ programming best practices across 30+ languages and frameworks. BM25-powered search over curated resources from industry leaders (Google, Airbnb, Uber, Mozilla, Shopify, OWASP).

dereknguyen269/programing-best-practices · 0 tokens