feishu-doc

Original：🇨🇳 Chinese

Translated

1 scriptsChecked / no sensitive code detected

Feishu Document Assistant. Read and write Feishu cloud documents and knowledge bases, supporting creation, export, precise editing, synchronization to knowledge bases, and group message notifications. Use this Skill when users mention Feishu documents, knowledge bases, wiki, or send feishu.cn links.

3installs

Source0xranx/agent-kit

Added on2026-03-16

NPX Install

npx skill4agent add 0xranx/agent-kit feishu-doc

SKILL.md Content (Chinese)

View Translation Comparison →

Feishu Document Assistant

Unified management of Feishu document reading, writing, editing and knowledge base operations via

feishu_doc.py

.

Prerequisites

Install dependencies:

pip install feishu-docx markdown2feishu httpx

Configure credentials (choose one of the two):
- Set environment variables
```
FEISHU_APP_ID
```
  and
```
FEISHU_APP_SECRET
```
- Or edit
```
skills/feishu-doc/config.yaml
```
Required permissions for Feishu app:
```
docx:document
```
(document read/write),
```
wiki:wiki
```
(knowledge base),
```
im:message
```
(group messages)

Verify connectivity:

bash

python skills/feishu-doc/feishu_doc.py test

Trigger Conditions

Use this Skill in the following situations:

Users send Feishu links (feishu.cn/docx/, feishu.cn/wiki/, feishu.cn/sheets/)
Users say "Write to Feishu", "Sync to knowledge base", "Check the Feishu document", "Send to the group"
Users request to export, edit, or compare Feishu document content

Read Documents

When users want to view Feishu document content:

bash

python skills/feishu-doc/feishu_doc.py read <URL>                  # Read document and output Markdown
python skills/feishu-doc/feishu_doc.py read <URL> --with-block-ids  # Include block_id (required before editing)

Supports all Feishu document URL formats:

/docx/

,

/wiki/

,

/sheets/

,

/base/

.

When users want to understand the knowledge base structure:

bash

python skills/feishu-doc/feishu_doc.py wiki-tree <space_id or wiki_URL>  # Tree structure
python skills/feishu-doc/feishu_doc.py export-wiki <space_id or wiki_URL> -o ./output  # Batch export

Create Documents

When users say "Write a Feishu document" or "Sync this to Feishu":

bash

python skills/feishu-doc/feishu_doc.py create "Title" -c "Markdown content"   # Create from content
python skills/feishu-doc/feishu_doc.py create "Title" -f ./report.md       # Create from file
python skills/feishu-doc/feishu_doc.py create "Title" -f ./report.md --wiki <parent_node_token>  # Create in knowledge base

When creating in a knowledge base, if permissions are insufficient, it will automatically downgrade to a cloud document and prompt manual migration.

Edit Existing Documents

When users say "Modify this document" or "Update the X paragraph to ...":

Step 1 — Read document structure (find the block to modify):

bash

python skills/feishu-doc/feishu_doc.py list-blocks <URL>

Outputs the block_id, type, and content summary of each block.

Step 2 — Precise operations:

bash

python skills/feishu-doc/feishu_doc.py update-block <URL> <block_id> "New content"   # Modify a block
python skills/feishu-doc/feishu_doc.py delete-block <URL> <block_id>            # Delete a block
python skills/feishu-doc/feishu_doc.py append <URL> -c "Content to append"                # Append at the end
python skills/feishu-doc/feishu_doc.py overwrite <URL> -f ./new.md              # Clear and rewrite

Knowledge Base Management

bash

python skills/feishu-doc/feishu_doc.py wiki-tree <URL>                     # View knowledge base structure
python skills/feishu-doc/feishu_doc.py wiki-move <Document URL> <Target node token>   # Move cloud document to knowledge base (requires OAuth)
python skills/feishu-doc/feishu_doc.py wiki-sync <md file> --parent <Node>   # Sync to knowledge base (idempotent)

Group Messages

When users say "Notify the group" or "Send to Feishu group":

bash

python skills/feishu-doc/feishu_doc.py notify "Title" "Markdown content"   # Send card message
python skills/feishu-doc/feishu_doc.py send "Plain text message"               # Send text
python skills/feishu-doc/feishu_doc.py read-chat [N]                  # Read latest N group messages

Typical Workflows

"Show me what's in the knowledge base"

```
wiki-tree
```
lists the structure
Use
```
read
```
to read the documents of interest
Summarize and return

"Write this report under the operation section of the knowledge base"

Organize content into Markdown and write to a temporary file
```
create --wiki <parent_node>
```
to create
If permissions are insufficient, automatically downgrade to
```
create
```
(cloud document) → prompt to migrate with
```
wiki-move
```
```
notify
```
to notify the group chat

"The data in the second paragraph of this document is wrong, change it to XXX"

```
list-blocks <URL>
```
lists all blocks and block_ids
Locate the target block

update-block <URL> <block_id> "New content"

for precise update

"Convert this WeChat article to a Feishu document"

```
import-wechat <WeChat URL>
```
to crawl and convert
Return the Feishu document link

Notes

Writing to a knowledge base requires the Bot to be added as an "editable" member of the space; public knowledge bases need manual addition

wiki-move

requires OAuth login: first execute

python skills/feishu-doc/feishu_doc.py login

Feishu API has rate limits; the tool has built-in automatic retry for 429 errors (exponential backoff)
```
wiki-sync
```
has idempotent protection; documents with the same name will not be created repeatedly
Tables with more than 9 rows will be automatically split into multiple consecutive tables (Feishu API limit)
Card message content supports Feishu Markdown (
```
**bold**
```
,
```
[link](url)
```
,
```
\n
```
for line breaks)

feishu-doc

NPX Install

Tags

SKILL.md Content (Chinese)

Feishu Document Assistant

Prerequisites

Trigger Conditions

Read Documents

Create Documents

Edit Existing Documents

Knowledge Base Management

Group Messages

Typical Workflows

"Show me what's in the knowledge base"

"Write this report under the operation section of the knowledge base"

"The data in the second paragraph of this document is wrong, change it to XXX"

"Convert this WeChat article to a Feishu document"

Notes