How do I install the Bestblogs Capture skill?

Run npx skillmds@latest add ginobefun/bestblogs-capture in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Bestblogs Capture safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Bestblogs Capture?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Bestblogs Capture free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Bestblogs Capture?

ginobefun (@ginobefun) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Bestblogs Capture by ginobefun — Agent Skill

Name: Bestblogs Capture
Author: ginobefun

Bestblogs Capture

Use this skill when the user wants to save, annotate, or review their BestBlogs reading — create/list/update/remove bookmarks, add highlights with optional notes, view highlight-only vs. note-only lists, and manage reading history. Triggers include "收藏这篇 / 给这段划线 / 加个笔记 / 看我的收藏 / 我的笔记 / 我的阅读历史 / 删掉这条历史", "bookmark this on BestBlogs", "highlight this quote", "show my notes", "clear my BestBlogs reading history". Invokes the `bestblogs` CLI.

ginobefun 4796f64 3.8 KB Updated Sep 17, 2026

File contents

bestblogs-capture — 收藏 / 划线 / 笔记 / 历史

何时使用

用户想收藏一篇内容（可选附备注 / tag / folder）。
用户想对某段原文做划线；若传了 note，就等价于 "笔记"。
用户想回看自己的划线列表、笔记列表（两者共享底层实体 UserHighlightEntity，靠 entryType 区分）。
用户想管理阅读历史（查看 / 删除单条 / 清空）。

数据模型要点（务必理解）

note 和 highlight 同表不同 entryType：

entryType=highlight：note 为空
entryType=note：note 非空

不是两个独立接口。 走 GET /me/highlights?entryType=highlight 或 ?entryType=note 做服务端过滤（v2.0.7 起支持）。

原语

原语	CLI	说明
`bestblogs.bookmark.create`	`bestblogs capture bookmark add <id> --note ...`	幂等
`bestblogs.bookmark.list`	`bestblogs capture bookmark list --json`	分页
`bestblogs.bookmark.update`	`bestblogs capture bookmark update <id> --note ...`
`bestblogs.bookmark.delete`	`bestblogs capture bookmark remove <id>`
`bestblogs.highlight.create`	`bestblogs capture highlight add -r <id> -t "..." -n "..."`	有 `-n` 即为 note
`bestblogs.highlight.list`	`bestblogs capture highlights --json`	`entryType=highlight`
`bestblogs.note.list`	`bestblogs capture notes --json`	`entryType=note`
`bestblogs.highlight.update`	`bestblogs capture highlight update <highlightId> -n ...`
`bestblogs.highlight.delete`	`bestblogs capture highlight remove <highlightId>`
`bestblogs.history.list`	`bestblogs capture history list --json`	分页
`bestblogs.history.delete`	`bestblogs capture history remove <resourceId>`
`bestblogs.history.clear`	`bestblogs capture history clear --yes`	危险，需确认

动作示例

收藏（幂等）

bestblogs capture bookmark add RAW_xxx --note "值得反复读" --json

已收藏的资源重复 add 不会报错，返回已有记录。

划线 + 笔记

# 纯划线（entryType=highlight）
bestblogs capture highlight add -r RAW_xxx -t "精彩段落原文" --json

# 划线 + 笔记（entryType=note）
bestblogs capture highlight add -r RAW_xxx -t "精彩段落原文" -n "我的思考" --color "#FFEB3B" --json

分开查看

bestblogs capture highlights --resource RAW_xxx --json   # 只看该资源的划线
bestblogs capture notes --limit 20 --json                # 全部笔记（note 非空）

历史

bestblogs capture history list --limit 30 --json
bestblogs capture history remove RAW_xxx --json          # 删一条
bestblogs capture history clear --yes --json             # 清空（危险）

错误处理

409 / CONFLICT on highlight create 重复 → 告知用户该段已划线
404 / NOT_FOUND on remove/delete → 幂等对待，告诉用户 "已不存在"，不视为流程失败
401 → 未登录，提示 bestblogs auth login

组合建议

深读完一条内容（bestblogs-read）后：

如果整体有价值 → bookmark.create
有具体金句 → highlight.create（可选 note）
隔天回顾 → note.list / bookmark.list
不想再看到已读内容 → history.delete

---name: bestblogs-capturedescription: Use this skill when the user wants to save, annotate, or review their BestBlogs reading — create/list/update/remove bookmarks, add highlights with optional notes, view highlight-only vs. note-only lists, and manage reading history. Triggers include "收藏这篇 / 给这段划线 / 加个笔记 / 看我的收藏 / 我的笔记 / 我的阅读历史 / 删掉这条历史", "bookmark this on BestBlogs", "highlight this quote", "show my notes", "clear my BestBlogs reading history". Invokes the `bestblogs` CLI.---# bestblogs-capture — 收藏 / 划线 / 笔记 / 历史## 何时使用- 用户想收藏一篇内容（可选附备注 / tag / folder）。- 用户想对某段原文做划线；若传了 `note`，就等价于 "笔记"。- 用户想回看自己的划线列表、笔记列表（两者共享底层实体 `UserHighlightEntity`，靠 `entryType` 区分）。- 用户想管理阅读历史（查看 / 删除单条 / 清空）。## 数据模型要点（务必理解）**`note` 和 `highlight` 同表不同 entryType**：- `entryType=highlight`：`note` 为空- `entryType=note`：`note` 非空**不是两个独立接口。** 走 `GET /me/highlights?entryType=highlight` 或 `?entryType=note` 做服务端过滤（v2.0.7 起支持）。## 原语| 原语 | CLI | 说明 ||---|---|---|| `bestblogs.bookmark.create` | `bestblogs capture bookmark add <id> --note ...` | 幂等 || `bestblogs.bookmark.list` | `bestblogs capture bookmark list --json` | 分页 || `bestblogs.bookmark.update` | `bestblogs capture bookmark update <id> --note ...` | || `bestblogs.bookmark.delete` | `bestblogs capture bookmark remove <id>` | || `bestblogs.highlight.create` | `bestblogs capture highlight add -r <id> -t "..." -n "..."` | 有 `-n` 即为 note || `bestblogs.highlight.list` | `bestblogs capture highlights --json` | `entryType=highlight` || `bestblogs.note.list` | `bestblogs capture notes --json` | `entryType=note` || `bestblogs.highlight.update` | `bestblogs capture highlight update <highlightId> -n ...` | || `bestblogs.highlight.delete` | `bestblogs capture highlight remove <highlightId>` | || `bestblogs.history.list` | `bestblogs capture history list --json` | 分页 || `bestblogs.history.delete` | `bestblogs capture history remove <resourceId>` | || `bestblogs.history.clear` | `bestblogs capture history clear --yes` | 危险，需确认 |## 动作示例### 收藏（幂等）```bashbestblogs capture bookmark add RAW_xxx --note "值得反复读" --json```已收藏的资源重复 add 不会报错，返回已有记录。### 划线 + 笔记```bash# 纯划线（entryType=highlight）bestblogs capture highlight add -r RAW_xxx -t "精彩段落原文" --json# 划线 + 笔记（entryType=note）bestblogs capture highlight add -r RAW_xxx -t "精彩段落原文" -n "我的思考" --color "#FFEB3B" --json```### 分开查看```bashbestblogs capture highlights --resource RAW_xxx --json # 只看该资源的划线bestblogs capture notes --limit 20 --json # 全部笔记（note 非空）```### 历史```bashbestblogs capture history list --limit 30 --jsonbestblogs capture history remove RAW_xxx --json # 删一条bestblogs capture history clear --yes --json # 清空（危险）```## 错误处理- `409 / CONFLICT` on highlight create 重复 → 告知用户该段已划线- `404 / NOT_FOUND` on remove/delete → 幂等对待，告诉用户 "已不存在"，不视为流程失败- `401` → 未登录，提示 `bestblogs auth login`## 组合建议深读完一条内容（`bestblogs-read`）后：1. 如果整体有价值 → `bookmark.create`2. 有具体金句 → `highlight.create`（可选 note）3. 隔天回顾 → `note.list` / `bookmark.list`4. 不想再看到已读内容 → `history.delete`

Frequently asked questions