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 wpsnote/wpsnote-skills --skill wps-notegit clone --depth 1 https://github.com/wpsnote/wpsnote-skillsWrote 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/wpsnote/wpsnote-skills/wps-note)<a href="https://agentmods.dev/skills/wpsnote/wpsnote-skills/wps-note"><img src="https://agentmods.dev/badge/skills/wpsnote/wpsnote-skills/wps-note/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/wpsnote/wpsnote-skills/wps-note"><img src="https://agentmods.dev/badge/skills/wpsnote/wpsnote-skills/wps-note.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.00109 | $0.10400 |
| Opus 5.5 | $0.00044 | $0.04160 |
| Sonnet 5.5 | $0.00022 | $0.02080 |
| Haiku 4.5 | $0.00011 | $0.01040 |
Grade A, and why
wps-note 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 1mo 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.
How it starts
The opening of the file, as written. The whole thing — 570 lines — stays where its author put it; the contents beside it link to each section on GitHub.
WPS Note MCP Skill
核心操作模式：先定位（outline / search）→ 再读取（read）→ 最后编辑（write）。所有内容以语义 XML 格式交换，所有定位基于 block_id（10 位字母数字）。
何时使用
- 用户提到 WPS 笔记、WPS Note、云笔记、金山笔记
- 用户要求读取、编辑、搜索、总结、翻译笔记内容
- 用户需要创建笔记、管理标签、整理笔记库
- 需要排查 MCP 工具调用失败（
BLOCK_NOT_FOUND、EDITOR_NOT_READY等错误）
不适用于：本地 Markdown 文件操作、WPS 文档/表格/演示等其他产品、纯概念讨论。
核心概念
Block 模型
- 笔记由 block 组成，每个 block 有唯一的
block_id。 - block 类型：
paragraph、heading、blockquote、code_block、list、table、image（单图/图片分栏）、horizontal_rule、highlight_block、columns、embed、note_audio_card。 embedblock（电子表格、视频、LaTeX、倒计时等）为只读占位符，不可编辑。note_audio_cardblock 为语音录音卡片（只读），在 XML 中显示为<NoteAudioCard/>，使用get_audio_transcript工具获取转写内容。- 表格必须整表替换，无法编辑单个单元格。表格单元格仅支持简单块（段落、标题、引用、代码块、分隔线、图片），不可在单元格内嵌套高亮块、分栏、表格等容器类块。
- 容器嵌套限制：
<highlightBlock>内仅支持简单块（段落、标题、引用、代码块、分隔线、图片），不可嵌套<highlightBlock>、<columns>、<table>。<columns>的每个<column>内支持简单块和<highlightBlock>，不可嵌套<table>或<columns>。
note_id
- 大部分工具需要
note_id来指定操作的笔记。 - 通过
list_notes或search_notes获取note_id；若用户要操作当前打开的笔记，可直接调用get_current_note获取。 get_note_info可获取笔记元数据（含标签），支持三种模式：单个note_id查询、批量note_ids查询（最多 100 个）、全量分页浏览（page/page_size/limit），无需读取全文内容。
XML 输入输出
- 所有内容以语义 XML 格式收发，使用标签如
<p>、<h1>-<h6>、<blockquote>、<codeblock>、<table>、<highlightBlock>、<columns>等。 - 每个块级标签通过
id属性标识 block_id，如<p id="aB3kLm9xZq">内容</p>。 - 重要：写入操作（
edit_block等）的block_id/anchor_id只接受顶层 block ID（由get_note_outline返回）。read_noteXML 中容器（<highlightBlock>、<columns>、<table>）内部段落的id仅供阅读参考，不可用于写入操作。 - 写入时提供 XML 格式内容，系统自动转换为内部 block 模型。
replace的目标 block 由工具参数block_id指定，content建议不写id；若显式写了根块id，必须与目标block_id一致。insert时新内容中的块级标签应省略id，系统自动分配新的block_id。 - 行内 mark 使用语义标签：
<strong>粗体</strong>、<em>斜体</em>、<s>删除线</s>、<u>下划线</u>、<a href="url">链接</a>。 - 标签管理：使用
manage_note_tags工具管理笔记标签——直接添加/移除文件级标签，无需编辑文档内容。创建笔记后应调用manage_note_tags({ note_id, add: ["标签名"] })分配标签；多级标签用/，调用参数不要带#前缀；编辑已有笔记完成后若无标签也应补充。 - 行内自闭合元素：
<emoji value="😀"/>（表情）、<latex formula="E=mc^2"/>（行内公式）、<br/>（硬换行）。 - 样式属性通过
<span>传递：<span fontColor="#C21C13">红色文字</span>、<span fontHighlightColor="#FBF5B3">高亮文字</span>、<span fontSize="16">大号文字</span>。 - 颜色受预设色板约束，任意 hex 色值会被编辑器静默丢弃。各类颜色预设值：
fontColor（12 色）：#080F17#C21C13#DB7800#078654#0E52D4#0080A0#757575#DA326B#D1A300#58A401#116AF0#A639D7fontHighlightColor（9 色）：#FBF5B3#F8D7B7#F7C7D3#DFF0C4#C6EADD#D9EEFB#D5DCF7#E6D6F0#E6E6E6highlightBlock颜色（6 对 bg→border）：#FAF1E6→#FEC794、#FAE6E6→#F2A7A7、#E6FAEB→#AFE3BB、#E6EEFA→#98C1FF、#F5EBFA→#E5B5FD、#EBEBEB→#C5C5C5columnBackgroundColor（42 色，含纯色和渐变）：- 6 基础色：
#FFF5EB#FFECEB#E8FCEF#EBF2FF#FAF0FF#F2F2F2 - 18 扩展纯色：
#FCFAE1#FEF6E7#FFF5ED#FFF2F0#FFF2F4#FFF0F7#EEFFEB#EBFFF5#E8FCFC#EBF8FF#EBF1FF#F0EDFF#F2E7E4#F0E6DA#F5EEDA#EDF0EB#EDEEF0#F0E4DD - 6 饱和色：
#FEF49C#BCFAAF#ADF4FF#C2D3FF#FFC7C7#E0E0E0 - 12 渐变色：使用 CSS
linear-gradient()语法，如linear-gradient(133deg,#FFFAF7 2.14%,#FFEDFE 96.88%)
- 6 基础色：
- 完整 XML 格式参考已集成到 MCP Server Instructions 中自动注入（视客户端支持情况）。未注入时可调用
get_xml_reference工具按需获取。
What ships with it
4 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.
- 1mo ago First seen · 570 lines · 109 tokens per session scan A 97d23fe5b5dc
wps-note is a skill published in the GitHub repository wpsnote/wpsnote-skills (183 stars, last pushed yesterday), licensed MIT. It adds 109 tokens to every session and 10,400 once invoked, about $0.0004 per session on Opus 5.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
research-hub
Use research-hub to operate Zotero, Obsidian, and NotebookLM research workflows through CLI, MCP, REST, and dashboard. Trigger when the user asks to find papers, ingest sources, organize a literature review, build Obsidian research notes, upload sources to NotebookLM, inspect clusters, generate AI briefs, or maintain…
write-docs-cn
A guide to writing project documentation, especially README files. It explains how tutorials differ from reference material and where each kind of information belongs.
write-tech-cn
A writing guide for Chinese technical documents such as READMEs, tutorials, blogs, and technical explanations. It focuses on direct conclusions, clear actions, natural Chinese, and consistent technical terms.
pdf-image-text-extractor
A tool for reading text from images and PDF files, including scanned documents. OCR means recognizing printed or handwritten characters in an image and turning them into editable text.
youtube-digest
A transcript extractor for YouTube videos. It reads available subtitles or automatically generated captions, can translate non-Chinese captions into Chinese, and can export the text to Excel, a spreadsheet application.
hyalo-okf
Maintain Open Knowledge Format vaults with Hyalo's OKF index, log, and conformance commands.