Agent skill

Feishu Docs Exporter and Writer

by leemysw in leemysw/feishu-docx

Exports Feishu and Lark documents, sheets, bitables and wikis to Markdown, and creates, appends to or manages cloud docs from the command line.

MITAuto-check passedDocuments & Office

Install Feishu Docs Exporter and Writer

skills CLI
$ npx skills add leemysw/feishu-docx --skill feishu-docx -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install leemysw/feishu-docx feishu-docx --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/leemysw/feishu-docx.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.skills/feishu-docx .claude/skills/feishu-docx && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
feishu-docx
GitHub stars
268
Token cost
~1.8k tokens
SKILL.md length
453 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Exports Feishu and Lark documents, sheets, bitables and wikis to Markdown, and creates, appends to or manages cloud docs from the command line.

  • Works in 3 steps: 在浏览器中打开目标文件夹 → 从 URL 中提取… → fldcnXXXXXX 就是 folder token
  • Exporting a Feishu doc or wiki page to Markdown for analysis
  • SKILL.md covers Setup (One-time), Export Documents, Command Reference and Examples, plus 3 more sections
  • Calls pip and playwright; reaches xxx.feishu.cn and xxx.larkoffice.com

What it does

This skill drives the feishu-docx command-line tool to read and write Feishu or Lark cloud documents. Exports turn docs into Markdown with images, spreadsheets and multidimensional tables into Markdown tables, and wiki nodes are resolved automatically. An option adds a PDF copy, and a whole wiki space can be exported in one batch.

Writing commands create a document, create one from a WeChat article, append content or update a specific block, and there is an export command for WeChat articles. Drive commands list files, show public permissions and members, and clear files after double confirmation. For public documents or ones only readable in your browser session, a browser export mode uses Playwright with Chromium and can reuse a saved session file.

Setup is a pip install and a one-time app ID and app secret configuration, after which the token refreshes itself. Browser and PDF export are optional extras so the core install stays small.

When your agent uses it

  • Exporting a Feishu doc or wiki page to Markdown for analysis
  • Appending notes or updating a block in an existing Feishu document
  • Exporting a whole wiki space to search it locally
  • Reading a public Feishu document through a browser session

Example prompts

  • “Export this Feishu wiki page to Markdown in ./notes.”
  • “Append the meeting summary to the Feishu doc I just shared.”
  • “Export the entire team wiki space so I can search it locally.”
  • “Save the public Feishu doc as Markdown using the browser exporter.”

Requirements

  • Python with the feishu-docx package
  • A Feishu or Lark app ID and app secret
  • Playwright with Chromium, only for browser export

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 在浏览器中打开目标文件夹
  2. 从 URL 中提取 token:https://xxx.feishu.cn/drive/folder/fldcnXXXXXX
  3. fldcnXXXXXX 就是 folder token

What it can do on your machine

Read from SKILL.md and the folder at commit 76f58c7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pip
    • playwright

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • xxx.feishu.cn
    • xxx.larkoffice.com
    • mp.weixin.qq.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Feishu Docs Exporter and Writer loads about 1.8k tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 453 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~79
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from leemysw/feishu-docx at commit 76f58c7, republished under its MIT licence (© leemysw). 453 words, ~1,804 tokens.

Download SKILL.mdSave it as .claude/skills/feishu-docx/SKILL.md (or your agent's skills folder).
name
feishu-docx
description
Export, write, and manage Feishu/Lark cloud documents. Supports docx, sheets, bitable, wiki, WeChat article import/export, drive management, and browser-based export for public or browser-readable docs. Use this skill when you need to read, analyze, write, or manage content in a Feishu knowledge base.

Feishu Docx Exporter

Export Feishu/Lark cloud documents to Markdown for AI analysis, writing, and automation.

Setup (One-time)

bash
pip install feishu-docx
feishu-docx config set --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET

Token auto-refreshes. No user interaction required.

Optional features are split into extras so the core install stays lightweight. Quote extras in zsh and similar shells.

Optional: Browser-Based Export

export-browser requires Playwright and a Chromium runtime:

bash
pip install 'feishu-docx[browser]'
playwright install chromium
Optional: PDF Export

PDF export requires the pdf extra:

bash
pip install 'feishu-docx[pdf]'

Export Documents

bash
feishu-docx export "<FEISHU_URL>" -o ./output

The exported Markdown file will be saved with the document's title as filename.

If the document is public or only readable in your current browser session, prefer:

bash
feishu-docx export-browser "<FEISHU_OR_LARK_URL>" -o ./output

Or reuse an existing Playwright session:

bash
feishu-docx export-browser "<FEISHU_OR_LARK_URL>" --storage-state ./storage_state.json
Supported Document Types
  • docx: Feishu cloud documents → Markdown with images
  • sheet: Spreadsheets → Markdown tables
  • bitable: Multidimensional tables → Markdown tables
  • wiki: Knowledge base nodes → Auto-resolved and exported
  • public/browser-readable docs: Browser-based export with local images and attachments

Command Reference

CommandDescription
feishu-docx export <URL>Export document to Markdown
feishu-docx export <URL> --pdfExport document to Markdown and PDF
feishu-docx export-browser <URL>Export in a real browser session with local assets
feishu-docx export-wechat <URL>Export WeChat article to Markdown
feishu-docx create <TITLE>Create new document
feishu-docx create --url <URL>Create document from WeChat article
feishu-docx write <URL>Append content to document
feishu-docx update <URL>Update specific block
feishu-docx drive lsList app or personal cloud-space files
feishu-docx drive perm-show <TOKEN>Show public permission
feishu-docx drive perm-members <TOKEN>List permission members
feishu-docx drive clearClear files with double confirmation
feishu-docx export-wiki-space <URL>Batch export entire wiki space
feishu-docx export-workspace-schema <ID>Export bitable database schema
feishu-docx authOAuth authorization
feishu-docx config setSet credentials
feishu-docx config showShow current config
feishu-docx config clearClear token cache
feishu-docx tuiInteractive TUI interface
Show full SKILL.md (181 more words)Show less

Examples

Export a wiki page
bash
feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" -o ./docs
Export a document with custom filename
bash
feishu-docx export "https://xxx.feishu.cn/docx/XYZ789" -o ./docs -n meeting_notes
Export a public or browser-readable doc in a real browser session
bash
feishu-docx export-browser "https://xxx.larkoffice.com/wiki/ABC123" -o ./browser_docs
Export a document as PDF
bash
feishu-docx export "https://xxx.feishu.cn/docx/XYZ789" --pdf
bash
# Output content to stdout instead of saving to file
feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" --stdout
# or use short flag
feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" -c
Export with Block IDs (for later updates)
bash
# Include block IDs as HTML comments in the Markdown output
feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" --with-block-ids
# or use short flag
feishu-docx export "https://xxx.feishu.cn/wiki/ABC123" -b
Batch Export Entire Wiki Space
bash
# Export all documents in a wiki space (auto-extract space_id from URL)
feishu-docx export-wiki-space "https://xxx.feishu.cn/wiki/ABC123" -o ./wiki_backup

# Specify depth limit
feishu-docx export-wiki-space "https://xxx.feishu.cn/wiki/ABC123" -o ./docs --max-depth 3

# Export with Block IDs for later updates
feishu-docx export-wiki-space "https://xxx.feishu.cn/wiki/ABC123" -o ./docs -b
Export Database Schema
bash
# Export bitable/workspace database schema as Markdown
feishu-docx export-workspace-schema <workspace_id>

# Specify output file
feishu-docx export-workspace-schema <workspace_id> -o ./schema.md

Write Documents (CLI)

Create Document
bash
# Create empty document
feishu-docx create "我的笔记"

# Create with Markdown content
feishu-docx create "会议记录" -c "# 会议纪要\n\n- 议题一\n- 议题二"

# Create from Markdown file
feishu-docx create "周报" -f ./weekly_report.md

# Create in specific folder
feishu-docx create "笔记" --folder fldcnXXXXXX

# Create from a WeChat article URL
feishu-docx create --url "https://mp.weixin.qq.com/s/xxxxx"

如何获取 folder token:

  1. 在浏览器中打开目标文件夹
  2. 从 URL 中提取 token:https://xxx.feishu.cn/drive/folder/fldcnXXXXXX
  3. fldcnXXXXXX 就是 folder token
Append Content to Existing Document
bash
# Append Markdown content
feishu-docx write "https://xxx.feishu.cn/docx/xxx" -c "## 新章节\n\n内容"

# Append from file
feishu-docx write "https://xxx.feishu.cn/docx/xxx" -f ./content.md

Manage Drive Files

bash
# List app cloud-space documents
feishu-docx drive ls --auth-mode tenant --type docx

# List personal cloud-space documents
feishu-docx drive ls --auth-mode oauth --type docx

# Show public permission
feishu-docx drive perm-show "https://xxx.feishu.cn/docx/ABC123"

# List permission members
feishu-docx drive perm-members "https://xxx.feishu.cn/docx/ABC123"

# Clear files with double confirmation
feishu-docx drive clear --type docx
Update Specific Block
bash
# Step 1: Export with Block IDs
feishu-docx export "https://xxx.feishu.cn/docx/xxx" -b -o ./

# Step 2: Find block ID from HTML comments
# <!-- block:blk123abc -->
# # Heading
# <!-- /block -->

# Step 3: Update the specific block
feishu-docx update "https://xxx.feishu.cn/docx/xxx" -b blk123abc -c "新内容"

Tip for AI Agents: When you need to update a specific section:

  1. Export with -b to get block IDs
  2. Find the target block ID from HTML comments
  3. Use feishu-docx update with that block ID

Tips

  • Images and attachments auto-download to {doc_title}/ folder when local assets are available
  • Prefer export-browser for public share links or browser-readable docs
  • Use --stdout or -c for direct content output (recommended for agents)
  • Use -b to export with block IDs for later updates
  • Token auto-refreshes, no re-auth needed
  • For Lark (overseas): add --lark flag
  • tenant_access_token manages app cloud space, user_access_token manages personal cloud space

© leemysw, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .skills/feishu-docx of leemysw/feishu-docx.

Open the folder on GitHubat commit 76f58c7

Compare with similar skills

Feishu Docs Exporter and Writer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Feishu Docs Exporter and Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Feishu Docs Exporter and Writer this skillleemysw/feishu-docx268—~1.8kAutomated safety check: PassMIT
Web To Markdownrookie-ricardo/erduo-skills935—~894Automated safety check: PassMIT
URL to Markdown Fetcherjoeseesun/qiaomu-markdown-proxy509—~1.4kAutomated safety check: PassMIT
Content CollectorLeoYeAI/openclaw-master-skills2.2k—~4.8kAutomated safety check: PassMIT
Feishu Doc Creatorop7418/CodePilot6.5k1 repos~3.1kAutomated safety check: PassCustom licence
Wechat Article Camofoxdracohu2025-cloud/draco-skills-collection227—~1.1kAutomated safety check: PassMIT

Similar skills

  • Web To Markdown

    rookie-ricardo/erduo-skills

    Convert a web URL into cleaned Markdown with deterministic routing.

    935 GitHub stars~894 tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • URL to Markdown Fetcher

    joeseesun/qiaomu-markdown-proxy

    Converts a URL or PDF into clean Markdown, with dedicated routes for WeChat articles, Feishu docs, arXiv papers and login-gated pages, before any summary or rewrite.

    509 GitHub stars~1.4k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Content Collector

    LeoYeAI/openclaw-master-skills

    Automatically collect and archive content from shared links in group chats.

    2.2k GitHub stars~4.8k tokensUpdated 2 mo ago
    Knowledge ManagementAuto-check passed
  • Feishu Doc Creator

    op7418/CodePilot

    Creates a new Feishu cloud document from Lark-flavored Markdown through the create-doc MCP tool, in a folder, wiki node or knowledge space.

    6.5k GitHub starsUsed in 1 repo~3.1k tokens
    Productivity & AutomationAuto-check passed
  • Wechat Article Camofox

    dracohu2025-cloud/draco-skills-collection

    使用本机部署的 camofox-browser 稳定抓取微信公众号文章链接内容,优先读取浏览器 accessibility snapshot,并对公众号页噪音做专用清洗,输出 Markdown 或 JSON。

    227 GitHub stars~1.1k tokensUpdated 23 days ago
    Productivity & AutomationAuto-check passed
  • Clean Content Fetch

    LeoYeAI/openclaw-master-skills

    获取干净、可读的网页正文内容,适合现代网页、博客、新闻、公告和微信公众号文章抓取;支持网页正文提取、内容清洗、去噪、Markdown 输出,适用于普通 fetch 效果不佳、页面噪音较多或动态渲染干扰的场景。Clean content fetch for modern web pages, article extraction, WeChat article capture, content…

    2.2k GitHub stars~574 tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed

Questions about Feishu Docs Exporter and Writer

What does Feishu Docs Exporter and Writer do?

Exports Feishu and Lark documents, sheets, bitables and wikis to Markdown, and creates, appends to or manages cloud docs from the command line. This skill drives the feishu-docx command-line tool to read and write Feishu or Lark cloud documents. Exports turn docs into Markdown with images, spreadsheets and multidimensional tables into Markdown tables, and wiki nodes are resolved automatically.

When should I use Feishu Docs Exporter and Writer?

Feishu Docs Exporter and Writer fits situations like: exporting a Feishu doc or wiki page to Markdown for analysis; appending notes or updating a block in an existing Feishu document; exporting a whole wiki space to search it locally; reading a public Feishu document through a browser session.

How do I install Feishu Docs Exporter and Writer in Claude Code?

Run `npx skills add leemysw/feishu-docx --skill feishu-docx -a claude-code`. Or copy the skill folder (.skills/feishu-docx in leemysw/feishu-docx) into .claude/skills/feishu-docx in your project. Claude Code loads it when a task matches its description.

How do I install Feishu Docs Exporter and Writer in Codex?

Run `npx skills add leemysw/feishu-docx --skill feishu-docx -a codex`. Or copy the skill folder (.skills/feishu-docx in leemysw/feishu-docx) into .agents/skills/feishu-docx in your project. Codex loads it when a task matches its description.

Can I use Feishu Docs Exporter and Writer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add leemysw/feishu-docx --skill feishu-docx -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/feishu-docx, .gemini/skills/feishu-docx, .github/skills/feishu-docx and .opencode/skills/feishu-docx in your project.

What does Feishu Docs Exporter and Writer need to run?

Going by SKILL.md and its folder, Feishu Docs Exporter and Writer needs the command-line tools its instructions call (pip and playwright). Our summary lists: Python with the feishu-docx package; A Feishu or Lark app ID and app secret; Playwright with Chromium, only for browser export.

Does Feishu Docs Exporter and Writer access the network?

SKILL.md names 3 domains. In commands or code: xxx.feishu.cn, xxx.larkoffice.com and mp.weixin.qq.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Feishu Docs Exporter and Writer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Feishu Docs Exporter and Writer use?

Feishu Docs Exporter and Writer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Feishu Docs Exporter and Writer use?

About 1.8k tokens (SKILL.md is roughly 7.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Feishu Docs Exporter and Writer?

Skills that share tags, products or a category with Feishu Docs Exporter and Writer: Web To Markdown (rookie-ricardo/erduo-skills, 935 stars), URL to Markdown Fetcher (joeseesun/qiaomu-markdown-proxy, 509 stars), Content Collector (LeoYeAI/openclaw-master-skills, 2.2k stars) and Feishu Doc Creator (op7418/CodePilot, 6.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Feishu Docs Exporter and Writer?

leemysw (a GitHub user) maintains it in leemysw/feishu-docx, which has 268 GitHub stars. The repository was last updated on September 23, 2026.

Source: leemysw/feishu-docx on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.