feishu-cli-work

Manage Feishu calendars, tasks, approvals, attendance, and OKR via feishu-cli commands.

1.4k|142|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-work
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feishu-cli-work
Source: https://github.com/riba2534/feishu-cli/tree/main/skills/feishu-cli-work
Command: npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-work

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Coordinating work operations in Feishu—scheduling meetings around busy calendars, tracking tasks, running approval flows, querying attendance records, and reporting OKR progress—normally requires switching between multiple web UIs and APIs. This Skill lets an AI agent perform all of these work-management operations directly through the feishu-cli command line.

Core Features & Use Cases

  • Smart Calendar Scheduling: Find mutual free time with calendar suggestion, locate meeting rooms by capacity/floor with room-find, reply to invitations with rsvp, and manage recurring events via RRULE.
  • Task & Tasklist Management: Create, search, complete, and organize tasks and subtasks, including members, reminders, comments, and attachments.
  • Approval Lifecycle: Query approval definitions, initiate instances with structured form JSON, approve/reject/transfer tasks, cancel instances, and CC stakeholders.
  • Attendance & OKR Queries: Query punch-card records and attendance statistics (up to 50 users per call), list OKR cycles, and create progress records with percent, status, and source links.
  • Use Case: Ask the agent to find a 30-minute slot tomorrow morning for three colleagues, book a meeting room on floor F2, create the event, then file an approval request and log 80% progress on a key result—all in one conversation.

Quick Start

Ask the AI to find a common free time tomorrow for specific attendees and create the calendar event with a meeting room using the feishu-cli-work skill.

Frequently Asked Questions about feishu-cli-work

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find a common free time and book a meeting room in Feishu?

Use feishu-cli calendar suggestion with attendee open IDs and a duration to get recommended slots, then calendar room-find with the chosen slot and capacity or floor filters. Finally create the event with calendar create-event and add attendees and the room.

How do I create and approve a Feishu approval instance from the command line?

First run feishu-cli approval get with the approval code to read the form widget structure, then approval instance create with a JSON form array. Approvers use approval task query --topic todo and approval task approve or reject; all approval commands require a User Token from auth login.

Does feishu-cli attendance support querying multiple employees at once?

Yes, attendance user-task query accepts up to 50 comma-separated user IDs per call, while user-stats query supports up to 200. User-stats queries are limited to a 31-day date span, but user-task queries have no span limit.

What token type do Feishu approval and calendar RSVP commands need?

All approval commands and calendar rsvp require a User Token obtained via feishu-cli auth login. Task search and task my also need User Token, while OKR commands default to Tenant Token and calendar suggestion falls back to App Token.

Why does my OKR progress create command fail with a status error?

The --progress-status flag must be used together with --progress-percent; passing status alone is rejected. Also note the source URL is required by the API, so provide --source-url explicitly for meaningful links.

When should I not use this skill for Feishu operations?

Do not use it for contact directory lookups, email, meeting recordings, or Minutes—those belong to the feishu-cli-platform, feishu-cli-mail, and feishu-cli-meetings skills. Meeting notification messages go through feishu-cli-messaging.