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
It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.
git clone --depth 1 https://github.com/Pinvou/pinvou-agentnpx agentmods add skills/pinvou/pinvou-agent/lark-sheetsWrote 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-sheets)<a href="https://agentmods.dev/skills/pinvou/pinvou-agent/lark-sheets"><img src="https://agentmods.dev/badge/skills/pinvou/pinvou-agent/lark-sheets/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-sheets"><img src="https://agentmods.dev/badge/skills/pinvou/pinvou-agent/lark-sheets.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.00139 | $0.10954 |
| Opus 5 | $0.00069 | $0.05477 |
| Sonnet 5 | $0.00028 | $0.02191 |
| Haiku 4.5 | $0.00014 | $0.01095 |
Grade A, and why
lark-sheets 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 9d 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.
This is a copy
91% identical to lark-sheets — 149 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.
How it starts
The opening of the file, as written. The whole thing — 236 lines — stays where its author put it; the contents beside it link to each section on GitHub.
sheets
CRITICAL — 开始前 MUST 先用 File(action="read") 读取 ../lark-shared/SKILL.md，其中包含认证、权限处理。
术语约定
同一对象的交替说法，按此映射解析用户口语：工作表（sheet）= 子表 / tab / 标签页（sheet_id 是稳定标识）；电子表格（spreadsheet）= 工作簿 / 表格（顶层容器，由 --url 或 --spreadsheet-token 定位）；reference_id = 表内对象的稳定标识，即各对象主键 flag 接受的值（与 --image-uri 图片上传句柄不是一回事）。
每类对象用各自的主键 flag 定位（命名不统一，按此表对照，不要凭直觉拼）：
| 对象 | 主键 flag | 对象 | 主键 flag |
|---|---|---|---|
| 工作表 sheet | --sheet-id |
条件格式规则 | --rule-id |
| 图表 chart | --chart-id |
筛选视图 | --view-id |
| 透视表 pivot | --pivot-table-id |
迷你图（按组） | --group-id |
| 浮动图片 | --float-image-id |
飞书表格编辑准则（动手前必守，所有编辑类任务一律生效）
下列准则横切所有任务，动手前先过一遍——被索引直接路由进某个工具参考也一律生效；展开与边界见括注的 reference。
- 最小改动：除任务要改的单元格 / 列外，原表其它单元格、行列结构、Sheet 名、合并区、格式 1:1 保持；中间结果放原数据右侧或新建空白 Sheet，禁止删 / 改名 / 隐藏 / 移动已存在 Sheet；改写类任务精确圈定行列，不该转的原值 1:1 保留。
- 真实写回 + 回读校验：交付必须是对在线表格的真实写入，写完用
+csv-get/+cells-get/+<对象>-list回读确认实际生效——写操作返回ok只代表请求被接受、不代表结果符合预期；写公式后查错误码、筛选 / 排序后核对前几行、删除 / 清空后确认已空。禁止只在文本里声称"已完成"。 - 读全再写：批量填充 / 补齐 / 修正类任务先确认真实数据末行再写，只探前 N 行会漏写表尾（确定末行流程见
lark-sheets-read-data）。 - 公式优先于硬编码：能用公式表达的计算（总计 / 占比 / 提取 / 查找）一律写公式而非静态值——凡可由表内其它单元格推导的派生值默认用公式，即使用户没说"联动"；写公式前先读
lark-sheets-formula-translation，公式落表后收尾必跑+formula-verify直到status='success'。 - 续写 / 扩展继承样式：续写、补齐、复制区块、新增行列时禁止只读值只写值，必须连带
cell_styles+border_styles+ 合并 + 行高一起继承（清单见lark-sheets-write-cells，四边框最易漏）。 - 多步写入分流：美化收尾（样式 / 合并 / 行高列宽 / 冻结的任意组合）→ 一次
+styles-put声明式规格交付（见lark-sheets-styles-put）；同一个写操作打多个区域 → 用该命令自身的复数形态（--ranges/ map 入参）；只有跨类型、有顺序依赖的操作链（如插列 → 写表头 → 回填数据）才用+batch-update（high-risk-write：按下方审批协议先获用户同意再带--yes；fail-fast 不回滚，语义见lark-sheets-batch-update）。 - 分组汇总用透视表："按 X 统计 Y / 分组汇总 / 各类数量金额"用
+pivot-{create|update|delete}，禁止用 SUMIF / 本地脚本拼一张假透视表。 - 拆成可验证 checklist：落地前把指令拆成所有"独立可验证子要点"，逐点
assert全过才交付（多维排序每维一点、多目标每目标一点、范围类核起 / 末 / 边界）；只做第一个要点属违规。 - 全量处理前置断言条数：翻译 / 打标 / 批量公式落地等逐条任务，先把预期条数硬编码再
assert actual == expected，禁止输出"已完成前 N 条，剩余继续"的半成品。 - 缺失值不编造：补齐 / 扩展 / 按原表格式续填时，查不到或无法确定的值一律留空 + 备注注明（"暂未发布 / 未知 / 待核实"），禁止用推算值 / 估算值 / 凭空数据充数；原表若已示范缺失值写法（空值 + 备注），照抄该约定。宁可留空标注，不填不可靠的数。
What ships with it
26 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/lark-sheets-batch-update.md 13 KB
- references/lark-sheets-changeset.md 5.1 KB
- references/lark-sheets-chart.md 21 KB
- references/lark-sheets-conditional-format.md 11 KB
- references/lark-sheets-filter-view.md 7.8 KB
- references/lark-sheets-filter.md 7.2 KB
- references/lark-sheets-float-image.md 11 KB
- references/lark-sheets-formula-translation.md 14 KB
- references/lark-sheets-formula-verify.md 5.8 KB
- references/lark-sheets-history.md 5.4 KB
- references/lark-sheets-pivot-table.md 14 KB
- references/lark-sheets-range-operations.md 20 KB
- references/lark-sheets-read-data.md 36 KB
- references/lark-sheets-search-replace.md 5.5 KB
- references/lark-sheets-sheet-structure.md 13 KB
- references/lark-sheets-sparkline.md 7.3 KB
- references/lark-sheets-styles-put.md 7.7 KB
- references/lark-sheets-visual-standards.md 17 KB
- references/lark-sheets-workbook.md 26 KB
- references/lark-sheets-write-cells.md 58 KB
- scripts/lark_detect_subtables.py 22 KB runs code
- scripts/lark_inspect_workbook.py 7.1 KB runs code
- scripts/lark_profile_table.py 22 KB runs code
- scripts/lark_sheet_range.py 5.3 KB runs code
- scripts/lark_sheet_read_cli.py 5.6 KB runs code
- scripts/sheets_df.py 2.0 KB runs code
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.
- 9d ago First seen · 236 lines · 139 tokens per session scan A 83b004004618
lark-sheets is a skill published in the GitHub repository Pinvou/pinvou-agent (1,712 stars, last pushed yesterday), licensed MIT. It adds 139 tokens to every session and 10,954 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it A with 0 findings. It is 91% identical to lark-sheets, differing in 149 lines, and is treated as a copy.
Other skills, from other repositories
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…
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.…
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…
xlsx
Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualization. When Claude needs to work with spreadsheets (.xlsx, .xlsm, .csv, .tsv, etc) for: (1) Creating new spreadsheets with formulas and formatting, (2) Reading or analyzing data, (3) Modify…