feishu-task — Claude Code skill: what it does, how to install
feishu-task manages tasks, tasklists, subtasks, comments, and attachments in Feishu directly from the coding agent. Helpful for tracking team action items without opening Feishu manually.
MIT 175 installs ★ 4,217 updated 2026-03-29
npx skills add m1heng/clawdbot-feishu --skill feishu-task -a claude-codeWhat feishu-task does
This skill gives the assistant access to task management functions in Feishu. It handles task creation, subtasks, comments, and file attachments. Attachments accept either a local file_path or a remote file_url, checked against runtime media safety rules and the mediaMaxMb size cap.
A key limitation applies to task nesting. The bot can only generate subtasks for parent tasks it created itself. Task visibility requires an assigned user, so the agent assigns the requesting user when nobody else is named. Otherwise, the creator cannot view the item.
Tasklists recognize owner, editor, and viewer roles. Moving items between tasklists requires dedicated tools rather than feishu_task_update. Keeping the bot as the tasklist owner prevents it from losing access when permissions change.
What it helps with
- Create Feishu tasks and subtasks with assignees and due dates
- Attach local files or remote URLs to an existing task
- Leave comments on a task using its
task_guid - Set up tasklists with editor and viewer roles
Example prompts for the agent
- Create a task in Feishu titled 'Prepare review notes' due tomorrow and assign it to me
- Upload
/path/to/report.pdfto the task with guide297ddff-06ca-4166-b917-4ce57cd3a7a0 - List tasklists using open_id format
How to install feishu-task
1Skills CLI (Vercel)
npx skills add m1heng/clawdbot-feishu --skill feishu-task -a claude-code2Manually: put the files in place
~/.claude/skills/feishu-task/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/feishu-task/
1Skills CLI (Vercel)
npx skills add m1heng/clawdbot-feishu --skill feishu-task -a codex2Manually: put the files in place
.agents/skills/feishu-task/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add m1heng/clawdbot-feishu --skill feishu-task -a cursor2Manually: put the files in place
.cursor/skills/feishu-task/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install m1heng/clawdbot-feishu skills/feishu-task2Manually: put the files in place
.github/skills/feishu-task/SKILL.md1Skills CLI (Vercel)
npx skills add m1heng/clawdbot-feishu --skill feishu-task -a gemini-cli2Platform CLI
gemini skills install https://github.com/m1heng/clawdbot-feishu --path skills/feishu-taskManually: put the files in place
.devin/skills/feishu-task/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add m1heng/clawdbot-feishu --skill feishu-task -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about feishu-task
How to install feishu-task in Claude Code?
Run npx skills add m1heng/clawdbot-feishu --skill feishu-task -a claude-code. The skill file is placed in ~/.claude/skills/feishu-task/SKILL.md.
What does the feishu-task skill do?
It connects coding assistants to Feishu Tasks for issue and tasklist tracking. The tool handles task creation, attachment uploads, comments, and member permissions without manual web dashboard actions.
Why does subtask creation fail on some parent tasks?
The bot can only generate subtasks for parent items that the bot created itself. Adding subtasks to external or existing manual tasks is currently restricted.
Source text
SKILL.md · MIT
---
name: feishu-task
description: |
Feishu Task, tasklist, subtask, comment, and attachment management. Activate when user mentions tasks, tasklists, subtasks, task comments, task attachments, or task links.
---
# Feishu Task Tools
Tools:
- `feishu_task_create`
- `feishu_task_subtask_create`
- `feishu_task_get`
- `feishu_task_update`
- `feishu_task_delete`
- `feishu_task_comment_create`
- `feishu_task_comment_list`
- `feishu_task_comment_get`
- `feishu_task_comment_update`
- `feishu_task_comment_delete`
- `feishu_task_attachment_upload`
- `feishu_task_attachment_list`
- `feishu_task_attachment_get`
- `feishu_task_attachment_delete`
- `feishu_task_add_tasklist`
- `feishu_task_remove_tasklist`
- `feishu_tasklist_create`
- `feishu_tasklist_get`
- `feishu_tasklist_list`
- `feishu_tasklist_update`
- `feishu_tasklist_delete`
- `feishu_tasklist_add_members`
- `feishu_tasklist_remove_members`
## Notes
- `task_guid` can be taken from a task URL (guid query param) or from `feishu_task_get` output.
- `comment_id` can be obtained from `feishu_task_comment_list` output.
- `attachment_guid` can be obtained from `feishu_task_attachment_list` output.
- `user_id_type` controls returned/accepted user identity type (`open_id`, `user_id`, `union_id`).
- If no assignee is specified, set the assignee to the requesting user. Avoid creating unassigned tasks because the user may not be able to view them.
- Task visibility: users can only view tasks when they are included as assignee.
- Current limitation: the bot can only create subtasks for tasks created by itself.
- Attachment upload supports local `file_path` and remote `file_url`. Remote URLs are fetched with runtime media safety checks and size limit (`mediaMaxMb`).
- Keep tasklist owner as the bot. Add users as members to avoid losing bot access.
- Use tasklist tools for tasklist membership changes; do not use `feishu_task_update` to move tasks between tasklists.
## Create Task
```json
{
"summary": "Quarterly review",
"description": "Prepare review notes",
"due": { "timestamp": "1735689600000", "is_all_day": true },
"members": [
{ "id": "ou_xxx", "role": "assignee", "type": "user" }
],
"user_id_type": "open_id"
}
```
## Create Subtask
```json
{
"task_guid": "e297ddff-06ca-4166-b917-4ce57cd3a7a0",
"summary": "Draft report outline",
"description": "Collect key metrics",
"due": { "timestamp": "1735689600000", "is_all_day": true },
"members": [
{ "id": "ou_xxx", "role": "assignee", "type": "user" }
],
"user_id_type": "open_id"
}
```
## Create Comment
```json
{
"task_guid": "e297ddff-06ca-4166-b917-4ce57cd3a7a0",
"content": "Looks good to me",
"user_id_type": "open_id"
}
```
## Upload Attachment (file_path)
```json
{
"task_guid": "e297ddff-06ca-4166-b917-4ce57cd3a7a0",
"file_path": "/path/to/report.pdf",
"user_id_type": "open_id"
}
```
## Upload Attachment (file_url)
```json
{
"task_guid": "e297ddff-06ca-4166-b917-4ce57cd3a7a0",
"file_url": "https://oss-example.com/bucket/report.pdf",
"filename": "report.pdf",
"user_id_type": "open_id"
}
```
## Tasklist Membership For Tasks
### Add Task to Tasklist
```json
{
"task_guid": "e297ddff-06ca-4166-b917-4ce57cd3a7a0",
"tasklist_guid": "cc371766-6584-cf50-a222-c22cd9055004",
"section_guid": "6d0f9f48-2e06-4e3d-8a0f-acde196e8c61",
"user_id_type": "open_id"
}
```
### Remove Task from Tasklist
```json
{
"task_guid": "e297ddff-06ca-4166-b917-4ce57cd3a7a0",
"tasklist_guid": "cc371766-6584-cf50-a222-c22cd9055004",
"user_id_type": "open_id"
}
```
## Tasklists
Tasklists support three roles: owner (read/edit/manage), editor (read/edit), viewer (read).
### Create Tasklist
```json
{
"name": "Project Alpha Tasklist",
"members": [
{ "id": "ou_xxx", "type": "user", "role": "editor" }
],
"user_id_type": "open_id"
}
```
### Get Tasklist
```json
{
"tasklist_guid": "cc371766-6584-cf50-a222-c22cd9055004",
"user_id_type": "open_id"
}
```
### List Tasklists
```json
{
"page_size": 50,
"page_token": "aWQ9NzEwMjMzMjMxMDE=",
"user_id_type": "open_id"
}
```
### Update Tasklist
```json
{
"tasklist_guid": "cc371766-6584-cf50-a222-c22cd9055004",
"tasklist": {
"name": "Renamed Tasklist",
"owner": { "id": "ou_xxx", "type": "user", "role": "owner" }
},
"update_fields": ["name", "owner"],
"origin_owner_to_role": "editor",
"user_id_type": "open_id"
}
```
### Delete Tasklist
```json
{
"tasklist_guid": "cc371766-6584-cf50-a222-c22cd9055004"
}
```
### Add Tasklist Members
```json
{
"tasklist_guid": "cc371766-6584-cf50-a222-c22cd9055004",
"members": [
{ "id": "ou_xxx", "type": "user", "role": "editor" }
],
"user_id_type": "open_id"
}
```
### Remove Tasklist Members
```json
{
"tasklist_guid": "cc371766-6584-cf50-a222-c22cd9055004",
"members": [
{ "id": "ou_xxx", "type": "user", "role": "viewer" }
],
"user_id_type": "open_id"
}
```
© m1heng · MIT · m1heng/clawdbot-feishu