lark-approval

Query and process Feishu approval tasks and instances via lark-cli.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/TrayMachi/dotfiles --skill lark-approval-traymachi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-approval
Source: https://github.com/TrayMachi/dotfiles/tree/main/agents/skills/lark-approval
Command: npx skills add https://github.com/TrayMachi/dotfiles --skill lark-approval-traymachi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Handling Feishu (Lark) approvals normally requires switching to the Feishu client and clicking through the approval center. This Skill lets you query your pending and completed approval tasks, inspect instance details, and execute actions like approve, reject, transfer, and rollback directly through lark-cli commands. ## Core Features & Use Cases - Task Querying: List pending, completed, unread, or read approval tasks using topic filters, returning the instance_code and task_id pairs required for all operations. - Approval Actions: Approve, reject, transfer, add signatories, roll back, or send reminders on tasks assigned to you. - Instance Management: View form details and progress, cancel instances, CC instances to others, and query instances you initiated. - Use Case: You receive a notification that three expense approvals are waiting. Ask the assistant to list your pending approvals, review each form's details, then approve two and reject one with a comment, all without opening the Feishu app. ## Quick Start List my pending Feishu approvals and approve the one from the finance team with the comment "approved".

Frequently Asked Questions about lark-approval

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

FAQPage Schema
How do I list my pending Feishu approvals from the command line?

Run lark-cli approval tasks query with the topic parameter set to 1 for pending tasks, using --as user. The result returns instance_code and task_id pairs, which are required together for any subsequent approval action.

How to approve or reject a Feishu approval task with lark-cli?

Use lark-cli approval tasks approve or tasks reject with a JSON data payload containing instance_code, task_id, and an optional comment. Both identifiers must come from a prior tasks query call since operations require them as a pair.

Can this skill create approval definitions or start new approvals?

No. Creating approval definitions and initiating new approval instances are out of scope and must be done in the Feishu client or the approval admin console. This skill only queries and processes existing tasks and instances.

What is the difference between Feishu approval todos and Feishu tasks?

Approval todos are items in the Feishu approval center and are handled by this approval skill. Non-approval task-type todos belong to the separate lark-task skill, so task-type items should not be processed through approval commands.

Why do approval operations fail with missing parameter errors?

Approval actions require both instance_code and task_id together, and field structures vary per method. Run lark-cli schema approval.<resource>.<method> before calling to check the exact parameter structure instead of guessing fields.