A comprehensive technical specification and compatibility guide for generating Feishu-optimized Markdown documents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install feishu-cli-doc-guide
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install feishu-cli-doc-guide using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Feishu CLI Doc Guide?
The Feishu CLI Doc Guide is a specialized reference skill designed to ensure high-fidelity document creation when importing Markdown into Feishu. It provides a strict set of rules and syntax mappings derived from extensive real-world testing, covering over 10,000 lines of content and hundreds of diagrams. This skill acts as the technical foundation for other tools like feishu-cli-write and feishu-cli-import.
By following this guide, developers can avoid common pitfalls such as rendering failures in Mermaid flowcharts, broken PlantUML diagrams, and API-driven table limitations. It bridges the gap between standard Markdown and the proprietary Feishu block system, ensuring that complex elements like nested lists, callouts, and LaTeX equations transition seamlessly into the Feishu environment.
Feishu CLI Doc Guide Use Cases
- Preparing Markdown technical documentation for batch import into Feishu Knowledge Base.
- Validating Mermaid flowchart and sequence diagram syntax against Feishu specific constraints.
- Standardizing Callout blocks and technical tables to prevent automatic splitting or rendering errors.
- Configuring CI/CD pipelines to automatically convert and upload local documentation to Feishu.
How Feishu CLI Doc Guide Works
- The guide defines the mapping between Markdown elements and Feishu Block Types (e.g., Heading, Bullet, Todo, Code).
- It enforces a pre-import checklist to verify compatibility of complex objects like Mermaid (8 supported types) and PlantUML.
- It details a three-stage pipeline architecture (Sequential creation, Concurrent worker processing, and Reverse-order error handling).
- Automated retry mechanisms and linear backoff strategies are applied to handle 429 rate limits and 5xx server errors during the import lifecycle.
Feishu CLI Doc Guide Setup
This guide is a reference specification used by Openclaw Skills CLI tools. To utilize these rules during document processing, ensure your environment is configured for feishu-cli:
# Install the CLI tool (if applicable to your workflow)
npm install -g feishu-cli
# Standard import command applying these rules
feishu-cli doc import your-file.md --upload-images --diagram-workers 5
Feishu CLI Doc Guide Data Schema & Taxonomy
The skill organizes data based on Feishu's Block API. Key constraints include:
| Feature | Limit / Specification | Handling |
|---|---|---|
| Tables | 9 Rows x 9 Columns | Automatic splitting with header/first-column retention |
| Heading | 1-6 Levels | H7-H9 downgraded to bold text |
| Callouts | 6 Types | Mapped to specific BackgroundColors (NOTE, TIP, etc.) |
| Equations | LaTeX / KaTeX | Block equations are downgraded to Inline Equations per API |
| Images | 100MB Total | Automatic upload via file_token with placeholder fallback |
Feishu CLI Doc Guide Advanced Features
- Concurrent processing with configurable worker pools for diagrams (
--diagram-workers) and tables (--table-workers). - Intelligent table column width calculation (ASCII 8px, Non-ASCII 14px) for optimal readability.
- Automatic diagram degradation: rendering failures revert to original code blocks to prevent data loss.
- Support for advanced Feishu block types like AgendaItems, LinkPreviews, and SyncReferences.
SKILL.md
Loading
Related Openclaw Skills
AITuber API
A comprehensive video generation API that transforms scripts or ideas into fully narrated, captioned, and edited videos for social media and long-form platforms.
OpenMath Claim Reward
A specialized tool for querying claimable proof rewards and automating withdrawals from the OpenMath platform via the Shentu blockchain.
Failed Use of Captured Kinetic (F.U.C.K.) Analysis
A technical framework for analyzing the inefficiency and structural stress caused by mismanaged kinetic energy transfer.
Offer Explainer Rewriter
A specialized AI workflow that transforms complex, jargon-heavy product offers into clear, high-converting copy that buyers understand instantly.
PDF to Word with Format
A high-precision conversion tool that transforms PDF documents into Word files while strictly maintaining original formatting, fonts, and layouts.
Math Trick
A playful AI skill that pranks users by solving their addition problems as multiplication tasks.
Featured*
