lark-approval

Query, process, and initiate Lark approval tasks and instances via lark-cli.

Updated Sep 13, 2026
One-click install
npx skills add https://github.com/U1traVeno/skills --skill lark-approval-u1traveno
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lark-approval
Source: https://github.com/U1traVeno/skills/tree/main/profiles/lark/lark-approval
Command: npx skills add https://github.com/U1traVeno/skills --skill lark-approval-u1traveno

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Handling Lark (Feishu) approvals manually through the client is slow when you need to search launchable approval definitions, review pending tasks, or act on approval instances at scale. This Skill lets an AI agent perform the full approval workflow through lark-cli commands. ## Core Features & Use Cases - Approval Task Processing: Query pending/completed approval tasks and approve, reject, transfer, roll back, add-sign, or remind on them using instance_code and task_id pairs. - Approval Initiation: Search launchable approval definitions, inspect form controls and node lists, then create native approval instances with correctly structured form values. - Instance Management: View instance details, cancel initiated instances, query initiated instances by definition, and add CC recipients. - Use Case: Ask the agent to "approve my pending leave requests" — it queries the todo list, retrieves instance_code and task_id, and executes the approval with a comment. ## Quick Start Ask the assistant to list your pending Lark approvals and approve a specific one, or to search for a leave approval definition and submit a new instance.

Frequently Asked Questions about lark-approval

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

FAQPage Schema
How do I approve a Lark approval task from the command line?▼

First run lark-cli approval tasks query with topic 1 to get the instance_code and task_id, then run lark-cli approval tasks approve with both values and an optional comment. The two IDs must be used together, and write operations require the --yes flag after user confirmation.

How to initiate a Lark approval instance via API?▼

Search launchable definitions with approvals search, fetch the definition with approvals get to read form controls and node_list, then call instances create with a JSON-array form string. Third-party definitions (is_external=true) cannot be created this way and must use their create_link.

What is the difference between Lark approval tasks and Lark tasks?▼

Approval todos are approval documents and instances, not Lark tasks. Any action on approval documents such as approve, reject, transfer, or query belongs to the approval skill; only non-approval todos should go to lark-task.

Why does my Lark approval write operation fail with error 1395001?▼

Error 1395001 means the task state changed or the write precondition failed, often because someone else already processed the task or your operation rights changed. Do not retry blindly; run one status query with tasks query or instances get, then report the conclusion.

Which approval form controls are not supported by the create instance API?▼

Unsupported controls include text, mutableGroup, account, serialNumber, tripGroup, and several HR control groups such as onboarding and offboarding groups. If a definition contains these, it cannot be fully submitted through the API alone.

Can I upload attachments or images when creating a Lark approval instance?▼

No, this skill does not upload files. For attachmentV2 and image controls the user must directly provide the file code; without it, the instance cannot be submitted through this skill.