Pinvou/pinvou-agent is an open-source desktop workspace where an AI agent helps with work, visual design, and software development. People use it to work with files and knowledge, create editable visual artifacts, connect coding agents to projects, and extend the workspace with tools, MCP servers, skills, and workflows; the catalogue skills add capabilities to that environment.
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 Pinvou/pinvou-agent --skill lark-docgit clone --depth 1 https://github.com/Pinvou/pinvou-agentWrote 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/pinvou/pinvou-agent/lark-doc)<a href="https://agentmods.dev/skills/pinvou/pinvou-agent/lark-doc"><img src="https://agentmods.dev/badge/skills/pinvou/pinvou-agent/lark-doc/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/pinvou/pinvou-agent/lark-doc"><img src="https://agentmods.dev/badge/skills/pinvou/pinvou-agent/lark-doc.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
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.00183 | $0.01390 |
| Opus 5 | $0.00092 | $0.00695 |
| Sonnet 5 | $0.00037 | $0.00278 |
| Haiku 4.5 | $0.00018 | $0.00139 |
Grade A, and why
lark-doc 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 10d 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 — 52 lines — stays where its author put it; the contents beside it link to each section on GitHub.
docs
场景与 Shortcut 路由
CRITICAL:先判断场景,再读取该场景的参考文件;不要在任务开始时一次性读取全部参考文件。每个文件只在首次进入对应阶段时读取一次。
身份:文档操作推荐显式指定 --as user。例外:如果 doc_token / note_doc_token 等是从 bot 链路(如 vc +detail --as bot → note +detail --as bot)取得的,应继续显式使用 --as bot,不要无条件切回 user——身份延续规则见 ../lark-shared/SKILL.md。
所有表示本地文件的 @path 均使用 @./xxx 形式的相对路径,并以运行 lark-cli 时的当前工作目录(CWD)为基准。
文档内容
- 读取 / 摘要 —
+fetch:先读参考再获取文档。 - 从零创作 —
创建工作流:先完整执行创建工作流,简单任务不是跳过的理由; - 导入 / 空文档 —
+create:仅创建空文档或原样导入用户提供的完整内容时,跳过创建工作流。 - 编辑 / block 直达链接 —
+update:语义改写、润色、重组、补写或排版均按 update 参考完成。
辅助能力
- 草稿初始化、解析与统计 —
+script:支持解析文档 URL / token 与本地 XML,统计字数并返回字符诊断;不支持 Markdown 输入。 - 历史版本 —
+history-list/+history-revert/+history-revert-status:查询、回滚文档历史版本或检查回滚任务状态。
资源、画板与思维笔记
- 插入本地素材 —
+media-insert:在文末插入本地图片或文件。 - 预览素材 —
+media-preview:预览文档中的图片、附件或素材。 - 下载素材 —
+media-download:下载文档中的图片、附件、素材或画板缩略图。 - Docx 封面 —
+resource-download/+resource-update/+resource-delete:下载、更新或删除 Docx 封面。 - 画板 —
画板工作流:创建或更新画板时先读取工作流;更新已有画板必须复用现有 token,禁止新建空白画板。lark-whiteboard skill 未随包收录,写入用lark-cli whiteboard +update(用法以--help为准)。 - 思维笔记 —
mindnotes:已有思维笔记走思维笔记链路。新建思维笔记暂无专门的 docs/mindnotes 创建命令:要新建到知识库,用wiki +node-create --obj-type mindnote(见lark-wiki-node-create.md),创建后按思维笔记链路维护节点;思维笔记不是画板(whiteboard),不要路由到画板工作流。
认证与 Scope
执行 Shortcut 时,不预读 lark-shared 或预跑 auth status --verify;仅遇到未认证、token / 身份或 scope 错误时读取该 Skill,修复后重试。认证、身份或 scope 管理请求则直接使用该 Skill。
What ships with it
43 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.
- references/genres/business-analysis.md 3.1 KB
- references/genres/data-report.md 2.9 KB
- references/genres/email.md 4.2 KB
- references/genres/execution-plan.md 2.9 KB
- references/genres/formal-doc.md 4.4 KB
- references/genres/meeting-minutes.md 2.3 KB
- references/genres/memo-brief.md 2.0 KB
- references/genres/official-redhead.md 6.1 KB
- references/genres/prd.md 2.5 KB
- references/genres/proposal.md 2.1 KB
- references/genres/research-report.md 3.2 KB
- references/genres/retrospective.md 2.4 KB
- references/genres/route-consumer.md 3.8 KB
- references/genres/route-creative.md 3.6 KB
- references/genres/route-knowledge.md 4.7 KB
- references/genres/route-marketing.md 4.2 KB
- references/genres/route-media.md 3.7 KB
- references/genres/route-opinion.md 3.6 KB
- references/genres/route-personal-brand.md 3.4 KB
- references/genres/route-platform.md 639 B
- references/genres/route-report.md 1.2 KB
- references/genres/route-workplace.md 2.8 KB
- references/genres/sop-tutorial.md 4.0 KB
- references/genres/technical-doc.md 3.5 KB
- references/genres/wechat.md 3.9 KB
- references/genres/weekly-report.md 2.0 KB
- references/genres/white-paper.md 3.1 KB
- references/genres/xiaohongshu.md 3.2 KB
- references/lark-doc-create-workflow.md 9.3 KB
- references/lark-doc-create.md 3.3 KB
- references/lark-doc-fetch.md 7.3 KB
- references/lark-doc-history.md 5.4 KB
- references/lark-doc-md.md 5.8 KB
- references/lark-doc-media-download.md 2.3 KB
- references/lark-doc-media-insert.md 6.9 KB
- references/lark-doc-media-preview.md 1.7 KB
- references/lark-doc-mindnote.md 5.9 KB
- references/lark-doc-resource-cover.md 4.2 KB
- references/lark-doc-script.md 5.3 KB
- references/lark-doc-update.md 6.4 KB
- references/lark-doc-whiteboard.md 9.0 KB
- references/lark-doc-xml-extended-blocks.md 4.4 KB
- references/lark-doc-xml.md 5.4 KB
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.
- 10d ago First seen · 52 lines · 183 tokens per session scan A 5135fe4220c4
lark-doc is a skill published in the GitHub repository Pinvou/pinvou-agent (1,779 stars, last pushed today), licensed MIT. It adds 183 tokens to every session and 1,390 once invoked, about $0.0009 per session on Opus 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
docx
Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when…
doc-coauthoring
Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers.…
xlsx
Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or…
Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and…
pptx
Use this skill any time a .pptx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying…
skill-creator
A skill for creating, editing, improving, and testing skills for coding agents.