book-to-skill

book-to-skill is a skill for Claude Code, Codex from kuhung/weread-book-skills. It costs 46 tokens per session (2,926 once invoked), scanned A, original, MIT.

A workflow that turns personal notes from books into organised notes, practical AI skills, and a matching README.

In plain words
What is it for?
Use it to collect a reader’s highlights and comments from WeRead, organise them by book chapters, create structured public notes, and produce AI skills from them.
Why use it?
It gives scattered reading highlights and ideas a repeatable path from private archive to usable project guidance.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: reads .claude/ paths; mentions Claude Code; mentions AGENTS.md.

Good fit Use it to collect a reader’s highlights and comments from WeRead, organise them by book chapters, create structured public notes, and produce AI skills from them.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/kuhung/weread-book-skills/book-to-skill
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.

Any agent
npx skills add kuhung/weread-book-skills --skill book-to-skill
Clone the repo
git clone --depth 1 https://github.com/kuhung/weread-book-skills

Made for: Claude Code, Codex.

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 book-to-skill

README.md
[![agentmods](https://agentmods.dev/badge/skills/kuhung/weread-book-skills/book-to-skill/github.svg)](https://agentmods.dev/skills/kuhung/weread-book-skills/book-to-skill)
Your own site
<a href="https://agentmods.dev/skills/kuhung/weread-book-skills/book-to-skill"><img src="https://agentmods.dev/badge/skills/kuhung/weread-book-skills/book-to-skill/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for book-to-skill

Your own site · 80×15
<a href="https://agentmods.dev/skills/kuhung/weread-book-skills/book-to-skill"><img src="https://agentmods.dev/badge/skills/kuhung/weread-book-skills/book-to-skill.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 46 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,926 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.00046 $0.02926
Opus 5 $0.00023 $0.01463
Sonnet 5 $0.00009 $0.00585
Haiku 4.5 $0.00005 $0.00293

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

Security

Grade A, and why

book-to-skill 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 12d ago.

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.

skills/book-to-skill/SKILL.md · 120 lines

How it starts

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

Book-to-Skill Transformation Pipeline (知识转化引擎)

你是一个专业的知识管理与 AI 技能提取专家。你的使命是帮助用户解决"数字仓鼠"困境。

前置条件 (Pre-requisite)

在启动任何转换流程前,先确认:用户对这本书有没有留下个人痕迹——划线或想法,有其一即可。

  • 只划线、没写想法也算数:门槛是"读过并留下过个人痕迹",划线本身就是痕迹,不要求另外写过想法。只有当微信读书与本地都查不到任何个人划线和想法时,才跳过这本书,哪怕它声名显赫。我们的目标是把用户真正读过的书跑起来,不为凑书单而转化。

数据获取 (Data Acquisition)

用户的读书数据来源于微信读书。使用 weread-skills MCP 提供的 API 接口获取数据。

环境前置WEREAD_API_KEY 必须持久化写入 ~/.zshenv(而非仅在当前 session export),确保每次新终端/新 Agent 会话自动可用。若检测到未设置,提示用户执行:

echo 'export WEREAD_API_KEY="wrk-xxxxxxxx"' >> ~/.zshenv && source ~/.zshenv

获取流程

  1. 确认 $WEREAD_API_KEY 在当前 shell 中有值。若为空,按上方指引设置后再继续。
  2. 调用 /store/search/user/notebooks 定位目标书籍,获取 bookId
  3. 并行调用以下接口获取完整数据:
    • /book/info -- 书籍基本信息(书名、作者、译者、简介、出版社、评分)
    • /book/chapterinfo -- 章节目录(用于将划线按章节分组)
    • /book/bookmarklist -- 用户个人划线内容(原文 + 章节 + 时间戳)
    • /review/list/mine -- 用户个人想法与点评(划线想法、章节点评、整书书评)
    • /book/bestbookmarks -- 社区热门划线(含划线人数排名)

接口调用规范:参照 weread-skills/SKILL.md 的请求格式,所有参数平铺在 JSON body 顶层,每次请求必须带 skill_version。时间戳必须转为 YYYY-MM-DD 格式展示。

标准工作流 (SOP)

执行顺序为严格的 Step 1 -> 2 -> 3 -> 4 -> 5,禁止跳步或乱序。

Step 1: 私有存档 (Secure Archive) [必须最先执行]

  • 动作: 将从微信读书获取的全部原始数据存入私有文件夹,作为不可篡改的原始备份。
  • 保存路径: private/[书名]_原始摘录_private.md
  • 内容组织(参照已有文件 private/说服的艺术_笔记_原始摘录_private.md 的格式):
    • 顶部:书名、作者信息
    • 按章节标题分组(## 第X章 章节名
    • 每条划线为一个 - 列表项,末尾标注日期 *(YYYY-MM-DD)*
    • 个人想法以 *(个人想法)* 前缀标注,包含原文摘要和想法内容
    • 末尾用 --- 分隔,独立列出 ## 社区精华:热门划线 (Popular Highlights) 章节,每条标注划线人数
  • 目的: 确保原始素材被安全隔离,为后续合成提供双源数据。该目录已在 .gitignore 中排除,不会被提交到公开仓库。

检查点: Step 1 完成后,确认 private/ 下的文件已写入,才可进入 Step 2。

Step 2: 结构化重组 (Structural Synthesis) [必须在 Step 1 之后]

  • 动作: 深度阅读 Step 1 存档的原始笔记与热门划线,提炼核心逻辑,重构为层次分明的知识框架文档。
  • 数据来源: 必须综合考虑"个人视角"与"社区共识",填补个人可能忽略的重要内容。
  • 保存路径: notes/[书名]_笔记.md
  • 格式要求(参照已有文件 notes/说服的艺术_笔记.md 的格式):
    • 顶部:H1 书名 + 作者/译者信息 + 一句话核心主旨
    • 使用 H2 按主题模块组织(不是按原书章节照搬,而是提炼重组为逻辑主题)
    • H2 下使用列表项和加粗关键词展开论述
    • 严禁使用 Emoji,保持文档风格的严肃性与简洁性
    • 包含"个人想法与点评"章节(整合 /review/list/mine 的内容)
    • 必含"个人补充"章节:这是残差设计哲学的落地——AI 对书的压缩是有损的,损掉的正是读者的个人视角。热门划线代表大家的共识(作为基线),个人划线与想法则是"我"在共识之外补上的内容。本章节直接呈现这些个人补充即可,公式是"共识 + 我的补充 = 我的理解"。不做"我认同/不认同某条共识"这类对抗性评判
    • 必含"思维导图"章节:用 Mermaid mindmap 代码块呈现一张简单的导图——主干为 3-5 个核心主题,叶子节点必须来自个人划线/想法的要点与热门划线的要点(每支 2-4 叶)。严禁照搬全书章节大纲:导图画的是"我标记过的书",不是书的目录(要看目录不如直接看书)。使用代码块而非图片:GitHub 可渲染、可版本控制、AI 可读取
    • 末尾包含"社区精华:热门划线 (Popular Highlights)"专项章节,每条标注划线人数
    • 语言需精炼、逻辑严密,适合快速复习和公开展示

Read the full file on GitHub · 120 lines

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. 12d ago First seen · 120 lines · 46 tokens per session scan A e15bcc01c491

Subscribe to this mod's changes

book-to-skill is a skill published in the GitHub repository kuhung/weread-book-skills (9 stars, last pushed 1mo ago), licensed MIT. It adds 46 tokens to every session and 2,926 once invoked, about $0.0002 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