WeRead Bookshelf and Notes
teng-lin/weread-omni
Searches books, manages the shelf, reads public-account articles and reads or writes highlights and notes in WeRead through the weread-omni CLI.
微信读书助手 — 搜索书籍、管理书架、查看笔记划线、浏览书评、阅读统计、发现推荐好书. An agent skill from infometa/workbuddyskills.
No licenceAuto-check passed
Install Weread Skills
$ npx skills add infometa/workbuddyskills --skill weread-skills -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install infometa/workbuddyskills weread-skills --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/infometa/workbuddyskills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/weread-skills .claude/skills/weread-skills && 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 "weread-skills" agent skill from https://github.com/infometa/workbuddyskills/tree/main/skills/weread-skills into .claude/skills/weread-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "weread-skills", 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/infometa/workbuddyskills/tree/main/skills/weread-skillsType 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 infometa/workbuddyskills --skill weread-skills -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install infometa/workbuddyskills weread-skills --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/infometa/workbuddyskills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/weread-skills .agents/skills/weread-skills && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "weread-skills" agent skill from https://github.com/infometa/workbuddyskills/tree/main/skills/weread-skills into .agents/skills/weread-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "weread-skills", 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 infometa/workbuddyskills --skill weread-skills -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install infometa/workbuddyskills weread-skills --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/infometa/workbuddyskills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/weread-skills .cursor/skills/weread-skills && 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 "weread-skills" agent skill from https://github.com/infometa/workbuddyskills/tree/main/skills/weread-skills into .cursor/skills/weread-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "weread-skills", 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/infometa/workbuddyskills.git --path skills/weread-skills--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 infometa/workbuddyskills --skill weread-skills -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install infometa/workbuddyskills weread-skills --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/infometa/workbuddyskills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/weread-skills .gemini/skills/weread-skills && 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 "weread-skills" agent skill from https://github.com/infometa/workbuddyskills/tree/main/skills/weread-skills into .gemini/skills/weread-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "weread-skills", 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 infometa/workbuddyskills weread-skillsInstalls 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 infometa/workbuddyskills --skill weread-skills -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/infometa/workbuddyskills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/weread-skills .github/skills/weread-skills && 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 "weread-skills" agent skill from https://github.com/infometa/workbuddyskills/tree/main/skills/weread-skills into .github/skills/weread-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "weread-skills", 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 infometa/workbuddyskills --skill weread-skills -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install infometa/workbuddyskills weread-skills --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/infometa/workbuddyskills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/weread-skills .opencode/skills/weread-skills && 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 "weread-skills" agent skill from https://github.com/infometa/workbuddyskills/tree/main/skills/weread-skills into .opencode/skills/weread-skills/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "weread-skills", 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
weread-skills- GitHub stars
- 348
- Used in
- 1 other repo
- Token cost
- ~1.3k tokens
- SKILL.md length
- 262 words
- Files
- 9 (incl. references)
- Skills in repo
- 218
- Repo updated
- First seen
- Licence
- None found
At a glance
微信读书助手 — 搜索书籍、管理书架、查看笔记划线、浏览书评、阅读统计、发现推荐好书. An agent skill from infometa/workbuddyskills.
- Works in 10 steps: 版本上报：每次请求 body 必须包含 "skill_version":… → 参数平铺：业务参数必须和 api_name、skill_version… → 能力文档预检：调用任何接口前，必须先根据「支持的能力」表阅读对应说明文件（如阅读统… → …
- SKILL.md covers 支持的能力, 接口调用规范 and 深度链接（URL Schema）
- Calls curl; reaches i.weread.qq.com; needs WEREAD_API_KEY
What it does
Weread Skills is an agent skill from infometa/workbuddyskills. 微信读书助手 — 搜索书籍、管理书架、查看笔记划线、浏览书评、阅读统计、发现推荐好书
Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including reference files (for example `references/book.md`, `references/discover.md` and `references/notes.md`).
The repository describes itself as: WorkBuddy skills / connectors / experts archive for offline study.
Example prompts
- “/weread-skills”
Requirements
- A credential in WEREAD_API_KEY
Workflow steps
10 steps, taken from the first numbered list in SKILL.md.
- 版本上报：每次请求 body 必须包含 "skill_version": "1.0.3"（取本文件顶部 version 字段的值），用于服务端检查版本更新。如果回包中出现 upgrade_info 字段，必须立即暂停当前操作，按照 upgrade_info.message…
- 参数平铺：业务参数必须和 api_name、skill_version 放在同一层；不要包在 params、data、body 等对象里。只有接口文档明确声明的数组/对象字段（如 /book/readreviews 的 reviews）才允许作为业务字段传入。
- 能力文档预检：调用任何接口前，必须先根据「支持的能力」表阅读对应说明文件（如阅读统计先读 readdata.md，书架先读 shelf.md），确认接口参数、字段含义、单位、计数口径和工作流；禁止仅凭字段名或经验猜测含义。
- 字段解释优先级：解释接口回包时，以对应说明文件中的字段说明为准；如果回包字段名和直觉含义冲突，必须服从说明文件，不得直接翻译字段名。
- bookId 解析：用户输入书名时，先调 /store/search 获取 bookId，再执行后续操作
- 书架数量：使用 /shelf/sync 回答“书架有多少本书/多少条目”时，必须按 books.length + albums.length + (mp 非空 ? 1 : 0) 计算；albums[] 是专辑/有声书，也属于书架里的书，详细规则见 shelf.md
- 结果展示：列表用编号展示方便选择；搜索结果重点展示书名、作者、评分；展示接口回包信息时，字段禁止直接翻译，应该参考文件中的说明内容提供
- 上下文衔接：对话中记住已查询的 bookId，后续操作无需用户重复提供
- 深度链接：在展示划线、想法、章节等内容时，拼接对应的跳转链接方便用户直接在 App 中打开，具体格式见下方「深度链接（URL Schema）」章节
- 数据展示规范
What it can do on your machine
Read from SKILL.md and the folder at commit 91b77ea. 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
Shell commands in SKILL.md call:
curl
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:
i.weread.qq.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
WEREAD_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Weread Skills loads about 1.3k tokens when it runs, and up to ~13k if it reads all its reference files. Until then it costs about 14 tokens; SKILL.md has 262 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); files beside SKILL.md are not scanned.
SKILL.md
Without a licence we can't republish the file, so here is its outline and opening line. It has 262 words (~1,263 tokens).
- name
- weread-skills
- description_zh
- 搜索微信读书书籍、管理书架、查看笔记划线、浏览书评、阅读统计与好书推荐
- description_en
- WeRead: search books, manage shelf, notes, highlights, reviews & recommendations
- version
- 1.0.3
Files
SKILL.md and 8 other files (references) in skills/weread-skills of infometa/workbuddyskills.
- SKILL.md
- references/book.md
- references/discover.md
- references/notes.md
- references/profile.md
- references/readdata.md
- references/review.md
- references/search.md
- references/shelf.md
Open the folder on GitHubat commit 91b77ea
Used in 1 other repository
We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in infometa/workbuddyskills, which our catalogue first saw on October 7, 2026.
Compare with similar skills
Weread Skills 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 |
|---|---|---|---|---|---|---|
| Weread Skills this skillinfometa/workbuddyskills | 348 | 1 repos | ~1.3k | Automated safety check: Pass | None | |
| WeRead Bookshelf and Notesteng-lin/weread-omni | 660 | — | ~3.3k | Automated safety check: Pass | MIT | |
| Weread Year In Review Video Templatenexu-io/open-design | 100k | — | ~784 | Automated safety check: Pass | Apache-2.0 | |
| Yao Weread Skillyaojingang/yao-open-skills | 1.3k | — | ~532 | Automated safety check: Pass | MIT | |
| Huashu Weread Advisoralchaincyf/huashu-weread | 152 | — | ~1.4k | Automated safety check: Pass | MIT | |
| Blind Spot Scanlijigang/ljg-skills | 7.5k | — | ~1.7k | Automated safety check: Pass | MIT |
Similar skills
Weread Year In Review Video Template
nexu-io/open-design
WeRead-inspired HyperFrames video template for vertical annual reading reports, personal reading dashboards, book-note recaps, and shareable year-in-review stories.
Yao Weread Skill
yaojingang/yao-open-skills
当用户需要分析微信读书阅读历史、生成读书报告、可视化阅读统计、笔记、书架、词云、热力图、雷达图，或导出精排 HTML 报告时使用。也适用于创建 AI 创业者示例阅读报告。不用于通用图书推荐，或不生成报告的原始微信读书 API 查询。
Huashu Weread Advisor
alchaincyf/huashu-weread
微信读书高阶顾问。在底层 weread skill 的原子 API 之上，提供四类工作流：基于已读做个性化进阶推荐（advisor）、给方向规划入门到前沿的阶梯书单（path）、把零散划线想法提炼成读书笔记总结（alchemy）、做季度/年度阅读复盘并生成可发朋友圈/公众号的文章（review）。核心方法是「书架 +…
Blind Spot Scan
lijigang/ljg-skills
Reads yesterday's AI conversations, identifies one thinking blind spot, picks a WeRead book chapter to address it and writes an analysis note.
More from infometa/workbuddyskills
All 218 skills in this repoCampus Event Playbook
infometa/workbuddyskills
This skill should be used when planning, coordinating, running, or reviewing student-led campus events, including club recruitment, freshman mixers, welcome activities, small talks, competitions…
Teachany
infometa/workbuddyskills
K-12 interactive courseware creation. An agent skill from infometa/workbuddyskills.
Weight Management HTML
infometa/workbuddyskills
A skill your agent uses when the adult weight-management MCP needs to be installed/set up in WorkBuddy (connector) or its result must be rendered as a standalone Chinese HTML plan.
Agent Browser
infometa/workbuddyskills
A skill your agent uses when the user needs browser automation, including opening web pages, taking screenshots, extracting page content, clicking elements, filling forms, or testing web flows.
AI Research Radar
infometa/workbuddyskills
定时任务：每日研究简报。漏掉重要论文和行业报告？每天帮你盯着，关键信息一条不漏 This skill should be used when the user asks about 定时任务：每日研究简报.
Check Deck
infometa/workbuddyskills
Investment banking presentation quality checker. An agent skill from infometa/workbuddyskills.
Questions about Weread Skills
What does Weread Skills do?
微信读书助手 — 搜索书籍、管理书架、查看笔记划线、浏览书评、阅读统计、发现推荐好书. An agent skill from infometa/workbuddyskills. Weread Skills is an agent skill from infometa/workbuddyskills.
How do I install Weread Skills in Claude Code?
Run `npx skills add infometa/workbuddyskills --skill weread-skills -a claude-code`. Or copy the skill folder (skills/weread-skills in infometa/workbuddyskills) into .claude/skills/weread-skills in your project. Claude Code loads it when a task matches its description.
How do I install Weread Skills in Codex?
Run `npx skills add infometa/workbuddyskills --skill weread-skills -a codex`. Or copy the skill folder (skills/weread-skills in infometa/workbuddyskills) into .agents/skills/weread-skills in your project. Codex loads it when a task matches its description.
Can I use Weread Skills 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 infometa/workbuddyskills --skill weread-skills -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/weread-skills, .gemini/skills/weread-skills, .github/skills/weread-skills and .opencode/skills/weread-skills in your project.
What does Weread Skills need to run?
Going by SKILL.md and its folder, Weread Skills needs the command-line tools its instructions call (curl) and credentials named WEREAD_API_KEY. Our summary lists: A credential in WEREAD_API_KEY.
Does Weread Skills access the network?
SKILL.md names 1 domain. In commands or code: i.weread.qq.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.
Is Weread Skills 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. Review the folder before installing.
What licence does Weread Skills use?
No licence was found for Weread Skills or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.
How many tokens does Weread Skills use?
About 1.3k tokens (SKILL.md is roughly 5.1k 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 12k tokens, read only when the agent opens those files.
What are the alternatives to Weread Skills?
Skills that share tags, products or a category with Weread Skills: WeRead Bookshelf and Notes (teng-lin/weread-omni, 660 stars), Weread Year In Review Video Template (nexu-io/open-design, 100k stars), Yao Weread Skill (yaojingang/yao-open-skills, 1.3k stars) and Huashu Weread Advisor (alchaincyf/huashu-weread, 152 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Weread Skills?
infometa (a GitHub user) maintains it in infometa/workbuddyskills, which has 348 GitHub stars. The repository holds 218 skills in this directory. The repository was last updated on October 9, 2026.
Source: infometa/workbuddyskills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.