lark-drive

Manage Lark Drive files, folders, comments, permissions, and document import/export tasks.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill lark-drive-yuezhen-huang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-drive
Source: https://github.com/yuezhen-huang/my-bytedance-skillhub/tree/main/lark-drive
Command: npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill lark-drive-yuezhen-huang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lark-cli, and includes references (resource) components.

What problem does it solve? Working with Lark (Feishu) cloud storage programmatically is error-prone: different document types use different token formats, wiki links hide the real document token, and async operations like import, export, and folder moves require polling. This Skill gives an AI agent precise instructions to upload, download, move, comment on, and manage permissions for Drive files without token or API mistakes. ## Core Features & Use Cases - File & Folder Operations: Upload and download files, create folders, copy/move/delete items, and list folder contents via lark-cli drive shortcuts and native APIs. - Document Comments: Add full-document or text-selection (local) comments on docx documents, list and count comments/replies with correct semantics, and handle restrictions like resolved or whole-document comments. - Import/Export & Async Tasks: Convert local files (Word, Markdown, Excel, CSV) into cloud documents, export docx/sheet/bitable to PDF/XLSX/CSV/Markdown, and poll async task results with a unified +task_result shortcut. - Use Case: A user pastes a wiki link and asks to add a comment on a specific paragraph. The Skill first resolves the wiki token to the real docx token via wiki.spaces.get_node, then adds a local comment with drive +add-comment --selection-with-ellipsis. ## Quick Start Ask the agent to upload a local file to a Lark Drive folder or add a comment to a Feishu document URL, for example: upload report.pdf to my Lark cloud space folder and grant me admin access.

Frequently Asked Questions about lark-drive

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

FAQPage Schema
How do I upload a file to Lark Drive from the command line?

Use the shortcut `lark-cli drive +upload --file ./report.pdf --folder-token <FOLDER_TOKEN>`. Files over 20MB automatically switch to multipart upload, and you can set a custom name with `--name`.

How do I add a comment to a Feishu document or wiki link?

Use `lark-cli drive +add-comment --doc <URL> --content '[{"type":"text","text":"..."}]'`. Full-document comments work with docx, doc, and wiki URLs; text-selection comments via `--selection-with-ellipsis` require docx.

Can I use a wiki link directly as a file token in Lark Drive APIs?

No. Wiki URLs contain a wiki_token, not a file_token. You must first call `lark-cli wiki spaces get_node` to obtain the real `obj_token` and `obj_type`, then use the matching API for that document type.

How do I export a Feishu docx or sheet to PDF or Excel?

Run `lark-cli drive +export --token <TOKEN> --doc-type docx --file-extension pdf`. If polling times out, continue with `+task_result --scenario export`, then download the result with `+export-download`.

Why can't I reply to a comment on a Feishu document?

Full-document comments (`is_whole=true`) and resolved comments (`is_solved=true`) do not support replies. The Skill instructs the agent to inform the user of the restriction rather than picking another comment.

What file types can be imported as Lark cloud documents?

Word, TXT, Markdown, and HTML files import as docx; xlsx and csv import as sheet or bitable; xls imports as sheet only. Each format has size limits, for example 20MB for Markdown and 800MB for xlsx.