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 agentmods add skills/larksuite/cli/lark-docnpx skills add larksuite/cli --skill lark-docgit clone --depth 1 https://github.com/larksuite/cliWhat 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 | $0.00124 | $0.01083 |
| Opus 5 | $0.00062 | $0.00541 |
| Sonnet 5 | $0.00025 | $0.00217 |
| Haiku 4.5 | $0.00012 | $0.00108 |
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 2d 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 — 50 lines — stays where its author put it; the contents beside it link to each section on GitHub.
docs
场景与 Shortcut 路由
CRITICAL:先判断场景,再读取该场景的参考文件;不要在任务开始时一次性读取全部参考文件。每个文件只在首次进入对应阶段时读取一次。
身份:文档操作推荐显式指定 --as user。
所有表示本地文件的 @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,禁止新建空白画板;使用whiteboard +update写入。 - 思维笔记 —
mindnotes:已有思维笔记走思维笔记链路;新建思维笔记走lark-doc-whiteboard。
认证与 Scope
执行 Shortcut 时,不预读 lark-shared 或预跑 auth status --verify;仅遇到未认证、token / 身份或 scope 错误时读取该 Skill,修复后重试。认证、身份或 scope 管理请求则直接使用该 Skill。
不在本 Skill 范围
- Drive 文件级操作:找文档、导入导出、云空间文件上传 / 下载 / 权限管理 →
lark-drive。复制文档、创建副本或另存为副本时,按其指引使用lark-cli drive files copy;不要用docs +fetch+docs +create重建正文。 - 独立评论操作:添加、分页查看、回复评论或增删 reaction →
lark-drive;只需紧凑评论上下文时,直接使用默认 JSON 响应的docs +fetch。
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.0 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.2 KB
- references/lark-doc-create.md 3.2 KB
- references/lark-doc-fetch.md 7.8 KB
- references/lark-doc-history.md 5.4 KB
- references/lark-doc-md.md 5.8 KB
- references/lark-doc-media-download.md 2.2 KB
- references/lark-doc-media-insert.md 6.8 KB
- references/lark-doc-media-preview.md 1.6 KB
- references/lark-doc-mindnote.md 5.4 KB
- references/lark-doc-resource-cover.md 4.1 KB
- references/lark-doc-script.md 5.3 KB
- references/lark-doc-update.md 7.3 KB
- references/lark-doc-whiteboard.md 8.7 KB
- references/lark-doc-xml-extended-blocks.md 4.3 KB
- references/lark-doc-xml.md 5.3 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.
- 2d ago First seen · 50 lines · 124 tokens per session scan A 1c2aa910831a
lark-doc is a skill published in the GitHub repository larksuite/cli (16,925 stars, last pushed today), licensed MIT. It adds 124 tokens to every session and 1,083 once invoked, about $0.0006 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
systematic-debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.
chat-pet-sprite-creation
Use when creating or changing VS Code chat pet sprite art, sprite sheets, state animations, eye treatments, Stable/Insiders variants, or pet transitions under src/vs/workbench/contrib/chat/browser/widget/media/chatPet.
cpu-profile-analysis
Analyze V8/Chrome CPU profiles (.cpuprofile) and DevTools trace files (Trace-.json). Use when: profiling performance, investigating slow functions, comparing code paths, finding bottlenecks, analyzing timeToRequest, understanding call trees from sampling profiler data, analyzing layout/paint/rendering, investigating…
agent-host-chat-contributions
Build and review cross-cutting agent-host chat behavior through lifecycle contributions. Use when adding turn lifecycle side effects, prompt or context injection, restored-history transformation, protocol-action observation, or when reviewing changes that add code to AgentSideEffects or AgentService.
auto-perf-optimize
Run agent-driven VS Code performance or memory investigations. Use when asked to launch Code OSS, automate a VS Code scenario, run the Chat memory smoke runner, capture renderer heap snapshots, take workflow screenshots, compare run summaries, or drive a repeatable scenario before heap-snapshot analysis.