lark-doc

Create, read, edit, and manage Feishu Docx and Wiki documents via lark-cli.

8|2|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/luojiaaoo/xpeech --skill lark-doc-luojiaaoo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lark-doc
Source: https://github.com/luojiaaoo/xpeech/tree/main/xpeech/agent/skills/buildin/lark-skills/lark-doc
Command: npx skills add https://github.com/luojiaaoo/xpeech --skill lark-doc-luojiaaoo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with Feishu (Lark) cloud documents programmatically requires navigating complex APIs for reading, authoring, editing, media handling, and version history. This Skill routes every document task to the correct lark-cli command and reference guide, so the agent can operate Docx and Wiki documents reliably without memorizing API details. ## Core Features & Use Cases - Full document lifecycle: Read documents with scoped fetches (outline, section, range, keyword), create new documents from XML or Markdown through a structured authoring workflow, and apply precise block-level updates (replace, insert, delete, move). - Rich content support: Insert images and files from local paths or clipboard, embed whiteboards (Mermaid, SVG, PlantUML), HTML5 blocks, tables, callouts, and manage document covers and mind notes. - Version control: List document history, roll back to a specific version, and verify rollback task status. - Use Case: Ask the agent to "write a project retrospective as a Feishu doc with an architecture diagram" — it will follow the creation workflow, generate genre-appropriate content, embed a whiteboard, and return the document URL. ## Quick Start Ask the agent to read, summarize, or edit a Feishu document by pasting its /docx/ or /wiki/ URL, or request a brand-new document on any topic.

Frequently Asked Questions about lark-doc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read a Feishu document with lark-cli?▼

Use lark-cli docs +fetch with the document URL or token. You can read the whole document or narrow the scope with outline, section, range, or keyword modes, and choose detail levels simple, with-ids, or full depending on whether you need block IDs for editing.

How do I create a new Feishu doc from scratch?▼

Follow the creation workflow: define a Presentation Decision JSON, run docs +script init-draft to get a workspace, write the XML draft, validate it with the parse command, then create the document with docs +create. Simple imports of existing content can skip the workflow and call +create directly.

Can I edit part of a Feishu document without rewriting it?▼

Yes. Use docs +update with commands like str_replace, block_replace, block_insert_after, block_delete, or block_move_after targeting specific block IDs. Fetch the document with --detail with-ids first to locate the blocks, then verify changes with a follow-up fetch.

Does lark-doc support inserting images into documents?▼

Yes. Use docs +media-insert with a local file path or --from-clipboard to append images or files at the document end. You can also embed images inline during creation or update using XML img tags with local paths or public HTTPS URLs.

How do I roll back a Feishu document to a previous version?▼

Run docs +history-list to find the target history_version_id, then call docs +history-revert with that ID and check completion via docs +history-revert-status. If no matching record exists, you can fetch the target revision and restore it with a single overwrite update.

What operations are not handled by the lark-doc skill?▼

Drive-level tasks like finding files, import/export, permissions, copying documents, and standalone comment operations belong to lark-drive. Sheet and Bitable cell data go to lark-sheets and lark-base. lark-doc focuses on document body content, media, covers, whiteboards, and mind notes.