lark-docs

Fetches Lark and Feishu document URLs and converts their content to Markdown.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a Lark (飞书) document link appears in a conversation, the AI cannot natively read its content. This Skill fetches the document behind larkoffice.com, feishu.cn, or larksuite.com URLs and converts it into Markdown so the content can be used directly in the current task. ## Core Features & Use Cases - URL-to-Markdown Conversion: Reads wiki pages and documents from Lark URLs and returns clean Markdown text plus document metadata (title, owner, timestamps, doc type). - Flexible Authentication: Supports user authorization (access any document you can view) and app mode (no login, limited to L2 security level and below). - Configurable Retry Modes: Choose fast, retry, or strict conversion modes to balance speed against success rate under failures or rate limiting. - Use Case: A colleague shares a Feishu wiki link containing a design spec. Pass the URL to this Skill and immediately summarize, translate, or extract action items from the document content. ## Quick Start Read the Lark document at the given larkoffice.com or feishu.cn URL and convert its content into Markdown for me.

Frequently Asked Questions about lark-docs

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

FAQPage Schema
How do I read a Feishu or Lark document from a URL?

Pass the larkoffice.com, feishu.cn, or larksuite.com URL as the url parameter to the lark-docs agent via gdpa-cli. It returns the document content converted to Markdown along with metadata like title, owner, and timestamps.

What is the difference between user and app auth modes for Lark documents?

User mode opens a Feishu authorization flow and can read any document you have permission to view, including personal docs. App mode requires no login but only accesses documents at L2 security level or below, such as public wikis.

Why do I get error code 970003 when reading a Lark document?

Error 970003 means the app token cannot access the document because its security level is above L2 or it is a personal document. Switch to user authentication mode by setting auth_mode to user and complete the authorization flow.

Can I convert Lark documents without logging in?

Yes, use app authentication mode, which requires no authorization. However, it only works for documents at L2 security level or below, typically public knowledge bases and wikis, not personal or restricted documents.

What should I do when Lark document conversion fails or gets rate limited?

Use the strict conversion mode, which retries up to three times including on rate limiting. The retry mode also retries three times but skips retries on rate limits, while the default fast mode never retries.