Not in the top 1,000 by GitHub stars
alchaincyf/huashu-weread
微信读书高阶顾问 · 在官方 weread skill 之上加一层「读书顾问的工作流」· 书架+笔记交叉分析 · 4 个 workflow (advisor/path/alchemy/review) · Made by 花叔
History
Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.
View weekly changes
SKILL.md
Week of Nov 2, 2026 · Line counts unavailable
Before Not checked yet → After Network or broad shell
First observation → 00be7ae53d1a
No earlier version was observed for comparison.
161GitHub stars
2stars in 7 days
1skill in this repository
0commits in 30 days
Heat
4.0- Star growth, last 7 daysNot available
- Star growth, last 24 hoursNot available
- Rank movement, last 7 daysNot available
- Commits, last 30 daysNot available
- Accounts asking about it through MCP, last 7 daysNot available
- Hot votes this weekNot available
Heat never changes the order by stars, and sponsorship never touches it. How heat works
Stars over time
30-day change not yet available: not enough history.
Individual skills in this repository
How it works
huashu-weread-advisor
When your agent uses it
微信读书高阶顾问。在底层 weread skill 的原子 API 之上，提供四类工作流：基于已读做个性化进阶推荐（advisor）、给方向规划入门到前沿的阶梯书单（path）、把零散划线想法提炼成读书笔记总结（alchemy）、做季度/年度阅读复盘并生成可发朋友圈/公众号的文章（review）。核心方法是「书架 + 笔记交叉分析」——书架揭示用户主动分类的兴趣，笔记数据揭示「真读过的」vs「只放着的」。当用户说「推荐书」「下一本读啥」「该读什么」「想搞懂 X 这个领域」「整理我的笔记」「这本书我记住了啥」「我今年读了什么」「读书复盘」「年度盘点」时触发。即使用户只是说「不知道读啥」「有没有相关的书」「帮我看看这本读完了吗」「这个领域我入门了吗」也应触发。
What it loads into context
Frontmatter
244 tokensAlways available to the agent
SKILL.md
2,974 tokensWhen the skill is activated
Reference documents
15,895 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- 定位
- 前置依赖
- 核心方法论（所有 workflow 共享）
- 检查点设计原则
- 子命令路由
- 共享子模块
- 示例
- 异常与边界条件
- 数据展示规范（强制）
- 调用约定
- 版本自检（静默）
Files
.gitignoreasset209 bytesLICENSEasset1,076 bytesREADME.mddoc8,901 bytesSKILL.mdcore10,395 bytesexamples/advisor-neuroscience.mddoc7,067 bytesshared/knowledge-map.mddoc4,257 bytesshared/shelf-cross-notes.mddoc5,258 bytestest-prompts.jsonasset1,262 bytesworkflows/advisor.mddoc7,192 bytesworkflows/alchemy.mddoc7,043 bytesworkflows/path.mddoc6,174 bytesworkflows/review.mddoc7,140 bytes
Read SKILL.md
# huashu-weread-advisor
把原子的微信读书 API 变成一个真正读懂你的读书顾问。
## 定位
底层 weread skill 提供原子接口（搜索、书架、笔记、点评、推荐、阅读统计），本 skill 在其之上做**工作流编排**，把原始数据转成对用户有消费价值的产出。
## 前置依赖
- 必须先有 `WEREAD_API_KEY` 环境变量（在用户 shell 中 export）
- 所有 API 调用走 `POST https://i.weread.qq.com/api/agent/gateway`
- 请求 body 必须带 `skill_version` 字段——**值的权威来源**：`~/.claude/skills/weread/SKILL.md` 顶部 frontmatter 的 `version` 字段（当前 `1.0.3`，会变；别从 prompt 或老模板里抄）
- 接口文档和参数详情见底层 weread skill：`~/.claude/skills/weread/SKILL.md`Skills included
- huashu-weread-advisor
Repository facts
- License
- MIT
- Created
- May 17, 2026
- Last pushed
- Aug 25, 2026
- Forks
- 9
- Open issues
- 1
- Project activity
- Slowing
Before you install
Network or broad shellAutomated signals, not a guarantee
Checked Nov 5, 2026
- No broad tool permissions
- No dangerous shell commands
- 14 network referencesin 3 files: README.md:7 shared/shelf-cross-notes.md:10 SKILL.md:16
- No hidden or obfuscated text
- No instruction overrides
- No executable scripts
- 5 references to secretsin 3 files: SKILL.md:16 shared/shelf-cross-notes.md:10 README.md:154
- No requests to vote in Hot
Show all 19 signals by file
README.md
- Network accessline 7
[](LICENSE) - Network accessline 8
[](https://skills.sh) - Network accessline 9
[](https://skills.sh) - Network accessline 17
微信读书前几天上了一个官方 AI skill（[weread.qq.com/r/weread-skills](https://weread.qq.com/r/weread-skills)），把书架、笔记、阅读统计、推荐 6 件事开放给 AI。能力很强，但它只是「自然语言包装的搜索接口」——你让它推荐书，它不会去看你已经读过什么，常把你笔记 68 条的书又当新书推回来给你。 - Network accessline 65
**前置依赖**：必须先装官方 weread skill（[weread.qq.com/r/weread-skills](https://weread.qq.com/r/weread-skills)），按页面指引走两步配置（复制安装指令 + 登录拿 API Key），全程不超过 1 分钟。 - Access to secretsline 154
[Credential-related source omitted] - Network accessline 184
- 微信读书官方 skill 把最难的事做完了（把账号数据通过 API 暴露给 AI）：[weread.qq.com/r/weread-skills](https://weread.qq.com/r/weread-skills) - Network accessline 185
- 灵感来源：花叔的 [女娲 .skill](https://github.com/alchaincyf/nuwa-skill)（把人物方法论蒸馏成 skill）。这次只是把蒸馏对象从「人」换成了「我自己的微信读书账号」。 - Network accessline 191
Made by [@AlchainHust](https://x.com/AlchainHust) · 公众号「花叔」
SKILL.md
shared/shelf-cross-notes.md
- Network accessline 10
[Credential-related source omitted] - Access to secretsline 10
[Credential-related source omitted] - Network accessline 11
GATEWAY = "https://i.weread.qq.com/api/agent/gateway" - Network accessline 28
body = {"api_name": api_name, "skill_version": VERSION, **params} r = subprocess.run( ["curl", "-s", "-X", "POST", GATEWAY, - Network accessline 29
[Credential-related source omitted] - Access to secretsline 31
[Credential-related source omitted]
How the signals fit together
Facts from a static read of the files at the pinned commit. They describe what the code does, not why.
Signal confidence: 19 facts
- Network access in prose of documentationREADME.md:7Low confidence
- Network access in prose of documentationREADME.md:8Low confidence
- Network access in prose of documentationREADME.md:9Low confidence
- Network access in prose of documentationREADME.md:17Low confidence
- Network access in prose of documentationREADME.md:65Low confidence
- Access to secrets in prose of documentationREADME.md:154Low confidence
- Network access in prose of documentationREADME.md:184Low confidence
- Network access in prose of documentationREADME.md:185Low confidence
- Network access in prose of documentationREADME.md:191Low confidence
- Network access in prose of the SKILL.mdSKILL.md:16Low confidence
- Access to secrets in prose of the SKILL.mdSKILL.md:16Low confidence
- Network access in prose of the SKILL.mdSKILL.md:17Low confidence
- Access to secrets in prose of the SKILL.mdSKILL.md:105Low confidence
- Network access in code of documentationshared/shelf-cross-notes.md:10Low confidence
- Access to secrets in code of documentation: a variable, placeholder or call, not a stored valueshared/shelf-cross-notes.md:10Low confidence
- Network access in code of documentationshared/shelf-cross-notes.md:11Low confidence
- Network access in code of documentationshared/shelf-cross-notes.md:28Low confidence
- Network access in code of documentationshared/shelf-cross-notes.md:29Low confidence
- Access to secrets in code of documentationshared/shelf-cross-notes.md:31Low confidence
Works with
| Agent | Status | Evidence | Install to |
|---|---|---|---|
| Claude Code | Compatible | Standard SKILL.md SKILL.md | .claude/skills/<skill-name>/ |
| Codex | Compatible | Standard SKILL.md SKILL.md | .agents/skills/<skill-name>/ |
| Cursor | Compatible | Standard SKILL.md SKILL.md | .cursor/skills/<skill-name>/ |
| Gemini CLI | Compatible | Standard SKILL.md SKILL.md | .gemini/skills/<skill-name>/ |
| GitHub Copilot | Compatible | Standard SKILL.md SKILL.md | .github/skills/<skill-name>/ |
| OpenCode | Compatible | Standard SKILL.md SKILL.md | .opencode/skills/<skill-name>/ |
- Native The repository ships a manifest, folder or frontmatter field for this agent.
- Compatible A standard SKILL.md that this agent can read.
- Unknown No evidence either way.
Derived automatically from paths, manifests and frontmatter. Not tested on each agent.
