lark-doc

A Feishu document you can work on without opening it — reading what is in there, writing a new one, or changing what is already written, pictures and whiteboards included.

WHEN TO USE

SCOPE

USE FOR

Read or summarize a Feishu document or wiki page from its link.
Draft a brand-new document from scratch and put it up on Feishu.
Rewrite, reorganize, or polish part of an existing document.
Insert a local image or file into a document, or download one already there.
Undo a bad edit by going back to how the document read earlier.
Create or update a whiteboard or mind note attached to a document.

NOT FOR

Does not upload, download, or manage permissions for Drive files; that's lark-drive.
Does not add, list, or reply to standalone comments; that's lark-drive.

This is a saved copy of the skill's SKILL.md instructions. It may differ from the upstream file or the version you install.

In this document (3)

docs

场景与 Shortcut 路由

CRITICAL：先判断场景，再读取该场景的参考文件；不要在任务开始时一次性读取全部参考文件。每个文件只在首次进入对应阶段时读取一次。

身份：文档操作推荐显式指定 --as user。

本地文件引用统一遵循文件访问权限：CWD 内优先使用 @./相对路径，其他目录使用 @绝对路径。XML 内的相对资源路径先查 CWD；仅文件不存在时再查源 XML 文件所在目录，同名文件以 CWD 为准。内联内容、stdin、在线文档没有源文件目录，不执行回退。

文档内容

读取 / 摘要 — +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。

Account or credentials required

1 FOR YOU · 1 FOR THE AGENT

All items below are required.

01
Install the lark-cli command-line tool
Install lark-cli locally; reading, creating, and editing docs (docs +fetch/+create/+update) runs through it.
02
Sign in to your Lark/Feishu account
Authenticate lark-cli as yourself so it can read and edit the actual Docx/Wiki documents in your Lark/Feishu tenant.

Listed as free: Connected services may require an account or charge fees.

Not standalone. This skill ships with larksuite/cli and only works together with that tool — install the tool first, then add this skill.

Run this outside your AI tool, using Node.js 22.20.0 or newer. Skills CLI 1.7.2 skips skill selection; prompts cancel installation without an interactive terminal. If choosing Project when asked about installation scope, open your project's folder before running this.

Install checklist

Check selected tools if a picker appears; Claude Code may be unchecked under Additional agents. ↑/↓ moves, Space toggles selections, Enter confirms.
Without a tool picker, check Installing to: for your intended tool. Stop if it names a different tool.
If asked, choose Symlink (Recommended) for shared files or Copy to all agents for separate copies; review the summary before confirming installation.
Install the find-skills skill? defaults to Yes, adding another skill for all projects. Choose No if you don't want that extra installation.

Skills CLI 1.7.2 sends install data to skills.sh by default, including the source, skill names, target tools and file details; GitHub sources are reported only when GitHub confirms the repository is public, while other remote sources can also be reported. Confirmed-public GitHub sources also trigger a security-audit request. Before installing, set the environment variable DO_NOT_TRACK=1 or DISABLE_TELEMETRY=1 to disable both.

npx skills add larksuite/cli --skill lark-doc lark-base lark-drive lark-markdown lark-shared lark-sheets lark-whiteboard lark-wiki --full-depth

It installs 8 skills: this one and the 7 it relies on, listed below. Once these skills are installed where Claude Code loads them, their descriptions help Claude decide when to use them.

What's inside

Files included with this skill.

View on GitHub

The repository is licensed under MIT — use, modification, and redistribution are allowed under that license’s terms.

View the repository’s license file on GitHub →