How do I install the Feishu Doc skill?

Run npx skillmds@latest add grtninja/feishu-doc in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Feishu Doc safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Feishu Doc?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Feishu Doc free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Feishu Doc?

grtninja (@grtninja) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Feishu Doc by grtninja — Agent Skill

Name: Feishu Doc
Rating: 4.2 (5 reviews)
Author: grtninja

Feishu Doc

Read, write, append, and manage Feishu/Lark documents via the feishu_doc tool. Use when creating, reading, or editing Feishu Docx documents, managing document blocks, creating tables, uploading images or file attachments, or extracting doc_token from Feishu URLs.

grtninja Updated Sep 10, 2026

File contents

Feishu Document Tool

Single tool feishu_doc with an action parameter for all Feishu Docx operations. Extract doc_token from URL: https://xxx.feishu.cn/docx/ABC123def -> token is ABC123def.

Workflow

Extract doc_token from the Feishu document URL.

Read the document to understand current content:

{ "action": "read", "doc_token": "ABC123def" }

Check the hint field in the response — if present, structured content (tables, images) exists; use list_blocks to access it.
Apply changes using the appropriate action (write, append, create, update_block, create_table, etc.).
Verify the result by re-reading the document.

Actions Summary

Action	Description
`read`	Get title, plain text, block statistics
`write`	Replace entire document with markdown
`append`	Append markdown to end of document
`create`	Create new document (always pass `owner_open_id`)
`list_blocks`	Get full block data including tables and images
`get_block`	Read a single block by ID
`update_block`	Update text content of a block
`delete_block`	Delete a block by ID
`create_table`	Create a Docx table block
`write_table_cells`	Write values to table cells
`create_table_with_values`	Create table and fill cells in one step
`upload_image`	Upload image from URL or local path
`upload_file`	Upload file attachment from URL or local path

Key Constraints

Markdown tables not supported in write/append — use create_table actions instead.
Always pass owner_open_id when creating documents so the user gets full_access (otherwise only the bot has access).
Image display size follows uploaded pixel dimensions — scale small images to 800px+ width before uploading.
For uploads, provide exactly one of url or file_path; do not send both.
parent_block_id and positional fields such as index are optional and should only be used when placement must be explicit.
feishu_wiki depends on this tool for reading/writing wiki page content.

References

references/block-types.md — complete block type table, editing guidelines, and common patterns.
See also: references/action-examples.md for full JSON examples of each action.

Configuration

channels:
  feishu:
    tools:
      doc: true  # default: true

Required permissions: docx:document, docx:document:readonly, docx:document.block:convert, drive:drive.

Guardrails

Use local or trusted tools only; avoid untrusted install pipelines.
Do not paste secrets/tokens into chat output.
Keep outputs in deterministic local paths for reproducible review.

---name: feishu-docdescription: Read, write, append, and manage Feishu/Lark documents via the feishu_doc tool. Use when creating, reading, or editing Feishu Docx documents, managing document blocks, creating tables, uploading images or file attachments, or extracting doc_token from Feishu URLs.---# Feishu Document ToolSingle tool `feishu_doc` with an `action` parameter for all Feishu Docx operations. Extract `doc_token` from URL: `https://xxx.feishu.cn/docx/ABC123def` -> token is `ABC123def`.## Workflow1. Extract `doc_token` from the Feishu document URL.2. Read the document to understand current content: ```json { "action": "read", "doc_token": "ABC123def" } ```3. Check the `hint` field in the response — if present, structured content (tables, images) exists; use `list_blocks` to access it.4. Apply changes using the appropriate action (write, append, create, update_block, create_table, etc.).5. Verify the result by re-reading the document.## Actions Summary| Action | Description || ------ | ----------- || `read` | Get title, plain text, block statistics || `write` | Replace entire document with markdown || `append` | Append markdown to end of document || `create` | Create new document (always pass `owner_open_id`) || `list_blocks` | Get full block data including tables and images || `get_block` | Read a single block by ID || `update_block` | Update text content of a block || `delete_block` | Delete a block by ID || `create_table` | Create a Docx table block || `write_table_cells` | Write values to table cells || `create_table_with_values` | Create table and fill cells in one step || `upload_image` | Upload image from URL or local path || `upload_file` | Upload file attachment from URL or local path |## Key Constraints- **Markdown tables not supported** in `write`/`append` — use `create_table` actions instead.- Always pass `owner_open_id` when creating documents so the user gets `full_access` (otherwise only the bot has access).- Image display size follows uploaded pixel dimensions — scale small images to 800px+ width before uploading.- For uploads, provide exactly one of `url` or `file_path`; do not send both.- `parent_block_id` and positional fields such as `index` are optional and should only be used when placement must be explicit.- `feishu_wiki` depends on this tool for reading/writing wiki page content.## References- `references/block-types.md` — complete block type table, editing guidelines, and common patterns.- See also: `references/action-examples.md` for full JSON examples of each action.## Configuration```yamlchannels: feishu: tools: doc: true # default: true```Required permissions: `docx:document`, `docx:document:readonly`, `docx:document.block:convert`, `drive:drive`.## Guardrails- Use local or trusted tools only; avoid untrusted install pipelines.- Do not paste secrets/tokens into chat output.- Keep outputs in deterministic local paths for reproducible review.

Frequently asked questions