lark-drive

Manage Feishu Drive files, folders, permissions, comments, and document import/export via lark-cli.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Managing Feishu (Lark) cloud storage programmatically is complex: different document types use different token formats, wiki links hide underlying resources, and operations like import/export are asynchronous. This Skill gives an AI agent a complete, safe command playbook for Feishu Drive so it can upload, download, organize, copy, comment on, and govern cloud files without guessing API details. ## Core Features & Use Cases - File & Folder Operations: Upload, download, preview, move, copy, rename, delete, and create folders or shortcuts in Feishu Drive, with wiki URL unwrapping via drive +inspect. - Import/Export Conversion: Convert local Word, Markdown, Excel, CSV, PPTX, and .base files into Feishu docx/sheet/bitable/slides, and export online documents to PDF, XLSX, Markdown, and more. - Comments & Collaboration: Add, list, reply to, resolve, and delete full-document or block-level comments on docx, sheets, slides, and Base records. - Permission Governance: Query permission settings, add/remove collaborators, apply for access, manage secure labels, and run permission-audit or knowledge-organization workflows. - Use Case: Ask the agent to "import this Excel file as a bitable into my Reports folder, then share it with my teammate" — the Skill routes through drive +import, handles async task polling, and grants permissions with confirmation. ## Quick Start Ask the agent to search your Feishu cloud drive for a document by title and download or export it to a local file.

Frequently Asked Questions about lark-drive

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

FAQPage Schema
How do I import a local Excel or CSV file into Feishu as a bitable?▼

Use lark-cli drive +import --type bitable with the local file path. The command uploads the file, creates an import task, and polls until the online document is ready. Batch imports to the same folder must run serially to avoid concurrency conflicts.

How to resolve a Feishu wiki URL to its real document token?▼

Run lark-cli drive +inspect --url with the wiki URL. It unwraps the wiki node and returns the underlying type, title, canonical token, and URL, which you then use for download, export, or comment operations.

Can I download a Feishu docx or sheet directly as a file?▼

No, drive +download only handles plain Drive files. Online documents like docx, sheet, bitable, and slides must be rendered with drive +export to formats such as PDF, XLSX, PPTX, or Markdown, then fetched with drive +export-download.

What file types can be imported into Feishu Drive and what are the size limits?▼

Supported conversions include .docx/.doc/.txt/.md/.html to docx, .xlsx/.csv to sheet or bitable, .base to bitable, and .pptx to slides. Limits range from 20MB for text formats up to 800MB for xlsx and 500MB for pptx.

Why does a Feishu Drive delete or permission change require confirmation?▼

Deletion, public permission changes, owner transfers, and member removal are high-risk write operations. The Skill requires explicit user confirmation of exact targets and a --yes flag before executing, and uses --dry-run for safe previews.

When should I use lark-doc or lark-base instead of lark-drive?▼

Use lark-doc for editing document body content, lark-sheets for cell-level spreadsheet operations, lark-base for table/record/view operations inside a bitable, and lark-wiki for knowledge-space node management. lark-drive handles file-level storage, import/export, comments, and permissions only.