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.
npx skills add jerlinn/jerlin-weread --skill jerlin-weread-skillgit clone --depth 1 https://github.com/jerlinn/jerlin-wereadWrote 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.
[](https://agentmods.dev/skills/jerlinn/jerlin-weread/jerlin-weread-skill)<a href="https://agentmods.dev/skills/jerlinn/jerlin-weread/jerlin-weread-skill"><img src="https://agentmods.dev/badge/skills/jerlinn/jerlin-weread/jerlin-weread-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.
<a href="https://agentmods.dev/skills/jerlinn/jerlin-weread/jerlin-weread-skill"><img src="https://agentmods.dev/badge/skills/jerlinn/jerlin-weread/jerlin-weread-skill.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00039 | $0.00864 |
| Opus 5 | $0.00019 | $0.00432 |
| Sonnet 5 | $0.00008 | $0.00173 |
| Haiku 4.5 | $0.00004 | $0.00086 |
Grade A, and why
jerlin-weread-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 10d 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.
What it actually says
WeRead — 微信读书助手
所有接口通过 scripts/weread.sh 调用。脚本处理鉴权和参数平铺。查看子命令列表:weread.sh -h;查看某个子命令的参数和回包字段:weread.sh <subcmd> -h。
能力路由
| 用户意图 | 子命令 | 领域知识 |
|---|---|---|
| 搜书/找书 | search |
references/search.md |
| 书籍详情/章节/进度 | book-info chapters progress |
references/book.md |
| 书架 | shelf |
references/shelf.md |
| 阅读统计/时长/偏好 | readdata |
references/readdata.md |
| 笔记/划线/想法 | notebooks bookmarks my-reviews |
references/notes.md |
| 热门划线/划线下想法 | best-bookmarks read-reviews underlines review-detail |
references/notes.md |
| 公开点评 | reviews |
references/review.md |
| 推荐好书 | recommend similar |
references/discover.md |
| 用户阅读概况 | (组合) | references/profile.md |
| 阅读画像 | (组合 + AskUser) | references/reading-profile.md |
CRITICAL: 调用任何接口前,先阅读对应 reference 确认字段含义、计数口径和工作流。回包字段名和直觉含义冲突时,服从 reference 说明。
鉴权
- 环境变量
$WEREAD_API_KEY,格式wrk-xxxxxxxx - 未设置时提示用户:
export WEREAD_API_KEY=<你的apikey> - API Key 绑定用户身份(vid),无需手动传
通用规则
errcode非 0 表示错误,给出中文提示。回包出现upgrade_info时按其 message 指引完成升级后重试。- 用户输入书名时,先调
weread.sh search获取 bookId,再执行后续操作。 - 对话中记住已查询的 bookId,后续操作无需用户重复提供。
- 列表用编号展示方便选择。展示回包信息时,字段禁止直接翻译,参考 reference 中的说明。
- 时间戳展示为 YYYY-MM-DD 格式,不得直接展示原始数字。
- 阅读时长单位为秒,展示时转为「X 小时 Y 分钟」。
深度链接
展示书籍、章节、划线等内容时,回包字段足以构造链接的,附上跳转链接方便用户在 App 中打开。
| 场景 | URL Schema |
|---|---|
| 打开书籍 | weread://reading?bId={bookId} |
| 跳转章节 | weread://reading?bId={bookId}&chapterUid={chapterUid} |
| 跳转划线位置 | weread://bestbookmark?bookId={bookId}&chapterUid={chapterUid}&rangeStart={rangeStart}&rangeEnd={rangeEnd}&userVid={userVid} |
range 解析:划线接口返回的 range 格式为 起始-结束(如 900-2004),拆分后分别填入 rangeStart 和 rangeEnd。
划线位置链接的生成条件:回包同时包含 chapterUid 和 range。整本书评或无法定位到划线的点评不生成此链接。userVid 从上下文获取或省略。
What ships with it
10 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.
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.
- 10d ago First seen · 56 lines · 39 tokens per session scan A 1cf0a8706f5f
jerlin-weread-skill is a skill published in the GitHub repository jerlinn/jerlin-weread (11 stars, last pushed 3mo ago), licensed MIT. It adds 39 tokens to every session and 864 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-30.
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 "入职".
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…
miniapp
Build a tiny interactive HTML playground only when someone asks to see, play with, or step through a mechanism.
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.
deck-course-module
A course or workshop slide template with persistent learning goals, teaching pages, multiple-choice self-tests, and a wrap-up.
master-yinguang
A reference-based assistant for questions about Yinguang and Pure Land Buddhism, a Buddhist tradition focused on faith, ethical living, and practice connected with rebirth in the Pure Land. It can answer in Yinguang’s historical teaching style.