Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add m1heng/clawdbot-feishu --skill feishu-task -a claude-code
Open on GitHub

What 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.pdf to the task with guid e297ddff-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-code

2Manually: put the files in place

~/.claude/skills/feishu-task/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/feishu-task/

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

Similar skills

All skills for Notes, tasks and projects →

From the same set8

Project sponsors

Companies that keep this analytics open