Feishu Doc
Look up Feishu document block type IDs and editability before your agent lists, updates, or deletes blocks via the Feishu doc tools.
Overview
feishu-doc is an agent skill for the Build phase that documents Feishu document block_type codes and edit rules for list, update, and delete block tools.
Install
npx skills add https://github.com/m1heng/clawdbot-feishu --skill feishu-docWhat is this skill?
- Maps block_type integers to names (Page, Text, Heading1–9, lists, code, todo, callout, and embed types)
- Flags which blocks are editable versus read-only or partial (e.g., Image, Equation)
- Aligns agent edits with Feishu block APIs instead of guessing structure from Markdown
- Covers layout and embed blocks (Bitable, Grid, Iframe, Sheet, Table) agents must not treat as plain text
- Pairs directly with list, update, and delete document block tool invocations
- Reference table spans 31+ Feishu document block types with editable flags
- Documents three companion tools: feishu_doc_list_blocks, feishu_doc_update_block, feishu_doc_delete_block
Adoption & trust: 1.9k installs on skills.sh; 4.3k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You are calling Feishu document block APIs but do not know which block_type values are editable or how embeds differ from text paragraphs.
Who is it for?
Indie builders shipping Feishu-connected agents, bots, or internal tools that programmatically maintain cloud docs.
Skip if: Teams only publishing static Markdown or PDFs with no Feishu doc API integration.
When should I use this skill?
You are about to list, update, or delete Feishu document blocks and need block_type IDs and editability rules.
What do I get? / Deliverables
Your agent picks valid block operations and payloads so Feishu doc list, update, and delete calls succeed on the right nodes.
- Correct block_type selection for API payloads
- Safer edit/delete targeting on Feishu doc trees
Recommended Skills
Journey fit
Canonical shelf is Build → integrations because this skill documents the Feishu Open API document model agents call during product wiring. It is a companion reference for feishu_doc_list_blocks, feishu_doc_update_block, and feishu_doc_delete_block—not general writing docs.
How it compares
Use as the typed API companion to generic Markdown or Notion-style doc skills—not a document authoring template on its own.
Common Questions / FAQ
Who is feishu-doc for?
Solo and indie developers wiring Claude Code, Cursor, or similar agents to Feishu/Lark document APIs who need an in-context block taxonomy.
When should I use feishu-doc?
During Build integrations whenever you list blocks, patch headings or todos, or delete sections—before and after each feishu_doc_* tool call.
Is feishu-doc safe to install?
It is reference-only text with no shell or network hooks; review the Security Audits panel on this Prism page before enabling related Feishu tool skills.
SKILL.md
READMESKILL.md - Feishu Doc
# Feishu Block Types Reference Complete reference for Feishu document block types. Use with `feishu_doc_list_blocks`, `feishu_doc_update_block`, and `feishu_doc_delete_block`. ## Block Type Table | block_type | Name | Description | Editable | |------------|------|-------------|----------| | 1 | Page | Document root (contains title) | No | | 2 | Text | Plain text paragraph | Yes | | 3 | Heading1 | H1 heading | Yes | | 4 | Heading2 | H2 heading | Yes | | 5 | Heading3 | H3 heading | Yes | | 6 | Heading4 | H4 heading | Yes | | 7 | Heading5 | H5 heading | Yes | | 8 | Heading6 | H6 heading | Yes | | 9 | Heading7 | H7 heading | Yes | | 10 | Heading8 | H8 heading | Yes | | 11 | Heading9 | H9 heading | Yes | | 12 | Bullet | Unordered list item | Yes | | 13 | Ordered | Ordered list item | Yes | | 14 | Code | Code block | Yes | | 15 | Quote | Blockquote | Yes | | 16 | Equation | LaTeX equation | Partial | | 17 | Todo | Checkbox / task item | Yes | | 18 | Bitable | Multi-dimensional table | No | | 19 | Callout | Highlight block | Yes | | 20 | ChatCard | Chat card embed | No | | 21 | Diagram | Diagram embed | No | | 22 | Divider | Horizontal rule | No | | 23 | File | File attachment | No | | 24 | Grid | Grid layout container | No | | 25 | GridColumn | Grid column | No | | 26 | Iframe | Embedded iframe | No | | 27 | Image | Image | Partial | | 28 | ISV | Third-party widget | No | | 29 | MindnoteBlock | Mindmap embed | No | | 30 | Sheet | Spreadsheet embed | No | | 31 | Table | Table | Partial | | 32 | TableCell | Table cell | Yes | | 33 | View | View embed | No | | 34 | Undefined | Unknown type | No | | 35 | QuoteContainer | Quote container | No | | 36 | Task | Lark Tasks integration | No | | 37 | OKR | OKR integration | No | | 38 | OKRObjective | OKR objective | No | | 39 | OKRKeyResult | OKR key result | No | | 40 | OKRProgress | OKR progress | No | | 41 | AddOns | Add-ons block | No | | 42 | JiraIssue | Jira issue embed | No | | 43 | WikiCatalog | Wiki catalog | No | | 44 | Board | Board embed | No | | 45 | Agenda | Agenda block | No | | 46 | AgendaItem | Agenda item | No | | 47 | AgendaItemTitle | Agenda item title | No | | 48 | SyncedBlock | Synced block reference | No | ## Editing Guidelines ### Text-based blocks (2-17, 19) Update text content using `feishu_doc_update_block`: ```json { "doc_token": "ABC123", "block_id": "block_xxx", "content": "New text content" } ``` ### Image blocks (27) Images cannot be updated directly via `update_block`. Use `feishu_doc_write` or `feishu_doc_append` with markdown to add new images. ### Table blocks (31) **Important:** Table blocks CANNOT be created via the `documentBlockChildren.create` API (error 1770029). This affects `feishu_doc_write` and `feishu_doc_append` - markdown tables will be skipped with a warning. Tables can only be read (via `list_blocks`) and individual cells (type 32) can be updated, but new tables cannot be inserted programmatically via markdown. ### Container blocks (24, 25, 35) Grid and QuoteContainer are layout containers. Edit their child blocks instead. ## Common Patterns ### Replace specific paragraph 1. `feishu_doc_list_blocks` - find the block_id 2. `feishu_doc_update_block` - update its content ### Insert content at specific location Currently, the API only supports appending to document end. For insertion at specific positions, consider: 1. Read existing content 2. Delete affected blocks 3. Rewrite with new content in desired order ### Delete multiple blocks Blocks must be deleted one at a time. Delete child blocks before parent containers. --- name: feishu-doc description: | Feishu document read/write operations + comment management. Activate when user mentions Feishu docs, cloud docs, docx links, or document comments. --- # Feishu Document Tool Single tool `feishu_doc` with action parameter for all document operations including comment management. ## Token Extraction From URL `https://xxx.feishu.cn/docx/ABC123def` → `doc_token` = `A