⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

feishu-docx

@leemysw⭐ 266 stars

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.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

Adopt or update this skill from https://proskills.md/skills/other/leemysw-feishu-docx-skills-feishu-docx. First identify the installation path supported by this platform, detect whether it is already installed, compare the installed version with the latest stable release, show me what will change, and only then install or update it. If no native installer is available, use the complete package or source fallback described on the page.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars

⭐⭐⭐ 266 on GitHubGitHub ↗

Popular

🟢ProSkills Score

—

📍

Not yet listed on ClawHub or SkillsMP

// README

feishu-docx

🆕 Recent Updates (v0.2.8)

PDF table line breaks and inline code combined with bold, italic, or strikethrough now render correctly, while other raw HTML remains escaped (#37)
Card-view links retain their titles and destinations; encoded URLs are preserved correctly
Refreshed project icon and added public-document Markdown/PDF end-to-end regression coverage

Upgrade with pip install --upgrade "feishu-docx[pdf]" for PDF export, or uv tool upgrade feishu-docx for an existing uv tool installation.

🎯 Why feishu-docx?

Let AI Agents read, write, and manage your Feishu/Lark knowledge base.

🤖 Built for AI — Works seamlessly with Claude/GPT Skills for document retrieval
📄 Full Coverage — Documents, Spreadsheets, Bitables, Wiki nodes, and WeChat articles
✍️ Write Back Support — Create docs, append content, and update specific blocks
☁️ Cloud-Space Management — List files, delete files, manage permissions, clear files safely
🔐 Authentication — One-time auth, automatic token refresh
🎨 Dual Interface — CLI + Beautiful TUI (Textual-based)
📦 Easy Install — uv tool install feishu-docx or pip install feishu-docx

⚡ Quick Start (30 seconds)

Install

Recommended: uv tool install (isolated, no conflicts with system Python)

uv tool install feishu-docx

Optional features are installed separately to keep the core package lightweight:

# PDF export: --pdf, --pdf-template, --pdf-logo, syntax highlighting
uv tool install 'feishu-docx[pdf]'

# Browser-based export: export-browser
uv tool install 'feishu-docx[browser]'
playwright install chromium

Or run directly without installing:

uvx feishu-docx export "https://my.feishu.cn/wiki/xxx"

If you don't have uv yet: curl -LsSf https://astral.sh/uv/install.sh | sh

Alternative: pip install (works inside a virtual environment or with --break-system-packages)

pip install feishu-docx

Optional extras also work with pip:

pip install 'feishu-docx[pdf]'
pip install 'feishu-docx[browser]'
playwright install chromium

Quote extras such as 'feishu-docx[pdf]' in shells like zsh, otherwise the [] may be treated as a glob pattern.

⚠️ pip install outside a virtual environment may fail with externally-managed-environment on modern Linux/macOS (PEP 668). Use a virtual environment or uv tool install instead.

Configure and Export

# Configure credentials (one-time)
feishu-docx config set --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET

# Export! (auto-obtains tenant_access_token, no OAuth needed)
feishu-docx export "https://my.feishu.cn/wiki/KUIJwaBuGiwaSIkkKJ6cfVY8nSg"

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

# Manage app cloud-space documents
feishu-docx drive ls --type docx

# Optional: Use OAuth mode for user-level permissions
# feishu-docx config set --auth-mode oauth && feishu-docx auth

🤖 Skills Support

Enable Agent to access your Feishu knowledge base directly!

This project includes a Claude Skill at .skills/feishu-docx/SKILL.md. Supports OpenCode, Claude Code, Codex, Cursor, and more.

Copy this Skill to your agent project, and Claude can:

📖 Read Feishu knowledge base as context
🔍 Search and reference internal documents
📝 Create docs, append content, and update specific blocks

✨ Features

Feature	Description
📄 Document Export	Docx → Markdown with formatting, images, tables
📊 Spreadsheet Export	Sheet → Markdown tables, with rich-text cells and display/formula modes
📋 Bitable Export	Multidimensional tables → Markdown
📚 Wiki Export	Auto-resolve wiki nodes
🗂️ Wiki Batch Export	Recursively export entire wiki space with hierarchy
✍️ Document Writing	Create docs, append Markdown, update specific blocks
📰 WeChat Import/Export	Export WeChat articles or create Feishu docs from them
🌐 Browser-Based Export	Export public docs or docs accessible in the current browser session, with local assets
☁️ Drive Management	List files, delete files, manage permissions, clear files
🗄️ Database Schema	Export APaaS database structure to Markdown
🧷 Local Asset Download	Images and attachments saved locally with relative paths
🖨️ PDF Export	Generate branded PDF with WeasyPrint, custom CSS templates
🔐 Auth	Auto tenant_access_token (recommended) or OAuth 2.0
🎨 Beautiful TUI	Terminal UI powered by Textual

✅ Supported Blocks

This tool currently supports exporting the following Feishu/Lark document components:

Category	Features	Status	Notes
Basic Text	Headings, Paragraphs, Lists, Tasks (Todo), Code Blocks, Quotes	✅	Fully Supported
Formatting	Bold, Italic, Strikethrough, Underline, Links, @Mentions	✅	Fully Supported
Layout	Columns, Callouts, Dividers	✅	Fully Supported
Tables	Native Tables	✅	Export to Markdown/HTML
Media	Images, Drawing Boards	✅	Drawing boards exported as images
Embedded	Spreadsheets (Sheets), Bitable	✅	Sheets support rich-text cells and display/formula modes
Special	Synced Blocks, Add-ons Blocks	✅	Synced blocks support same-document and cross-document references
Files	Attachments	✅	Local download when possible, temp link fallback

📖 Usage

Use Cases

Export Feishu docs, Sheets, Bitables, and Wiki nodes to Markdown
Export a WeChat article to Markdown
Create a Feishu doc directly from a WeChat article URL
Create, append, or update Feishu document content
Manage files and permissions in app cloud space or personal cloud space

CLI

export-browser requires Playwright.

If you installed via uv tool install, install the browser extra:

uv tool install 'feishu-docx[browser]'
playwright install chromium

If you are working inside a virtual environment:

pip install 'feishu-docx[browser]'
playwright install chromium

# Export single document to speci

// HOW IT'S BUILT

KEY FILES

.skills/feishu-docx/SKILL.mdREADME.md

// REPO STATS

266 stars

// SHARE

Share on X Share on LinkedIn