jerlin-weread-skill

Original：🇨🇳 Chinese

Translated

1 scripts

WeRead Assistant — Search books, manage bookshelf, view notes and underlines, browse book reviews, reading statistics, discover and recommend good books

6installs

Sourcejerlinn/jerlin-weread

Added on2026-05-17

NPX Install

npx skill4agent add jerlinn/jerlin-weread jerlin-weread-skill

SKILL.md Content (Chinese)

View Translation Comparison →

WeRead — WeChat Reading Assistant

All interfaces are called via

scripts/weread.sh

. The script handles authentication and parameter flattening. View the list of subcommands:

weread.sh -h

; view the parameters and response fields of a specific subcommand:

weread.sh <subcmd> -h

.

Capability Routing

User Intent	Subcommand	Domain Knowledge
Search for books	`search`	`references/search.md`
Book details/chapters/progress	`book-info` `chapters` `progress`	`references/book.md`
Bookshelf	`shelf`	`references/shelf.md`
Reading statistics/duration/preferences	`readdata`	`references/readdata.md`
Notes/underlines/thoughts	`notebooks` `bookmarks` `my-reviews`	`references/notes.md`
Popular underlines/thoughts under underlines	`best-bookmarks` `read-reviews` `underlines`	`references/notes.md`
Public reviews	`reviews`	`references/review.md`
Recommend good books	`recommend` `similar`	`references/discover.md`
User reading profile	(Combination)	`references/profile.md`

Before calling any interface, you must read the corresponding reference to confirm field meanings, counting standards, and workflows. When response field names conflict with intuitive meanings, follow the reference instructions.

Authentication

Environment variable
```
$WEREAD_API_KEY
```
in the format
```
wrk-xxxxxxxx
```
If not set, prompt the user:
```
export WEREAD_API_KEY=<your apikey>
```
The API Key is bound to the user identity (vid), no need to pass it manually

General Rules

A non-zero
```
errcode
```
indicates an error, provide a Chinese prompt. When
```
upgrade_info
```
appears in the response, follow its message to complete the upgrade and retry.
When the user enters a book title, first call
```
weread.sh search
```
to get the bookId, then perform subsequent operations.
Remember the queried bookId during the conversation, no need for the user to provide it repeatedly in subsequent operations.
Display lists with numbers for easy selection. When displaying response information, do not translate fields directly; refer to the explanations in the reference.
Display timestamps in YYYY-MM-DD format, do not show raw numbers directly.
Reading duration is in seconds; convert it to "X hours Y minutes" when displaying.

Deep Links

When displaying content such as books, chapters, underlines, etc., if the response fields are sufficient to construct a link, attach the jump link to facilitate users to open it in the App.

Scenario URL Schema

Open book

Scenario	URL Schema
Open book	`weread://reading?bId={bookId}`
Jump to chapter	`weread://reading?bId={bookId}&chapterUid={chapterUid}`
Jump to underline position	`weread://bestbookmark?bookId={bookId}&chapterUid={chapterUid}&rangeStart={rangeStart}&rangeEnd={rangeEnd}&userVid={userVid}`

weread://reading?bId={bookId}

Jump to chapter

weread://reading?bId={bookId}&chapterUid={chapterUid}

Jump to underline position

weread://bestbookmark?bookId={bookId}&chapterUid={chapterUid}&rangeStart={rangeStart}&rangeEnd={rangeEnd}&userVid={userVid}

Range parsing: The range format returned by the underline interface is

start-end

(e.g.,

900-2004

). Split it and fill in rangeStart and rangeEnd respectively.

Conditions for generating underline position links: The response contains both chapterUid and range. Do not generate this link for full-book reviews or reviews that cannot be located to underlines. userVid is obtained from the context or omitted.