lark-skill-maker

Original🇨🇳 Chinese
Translated

Create custom Skills for lark-cli. Use this when you need to package Feishu API operations into reusable Skills (wrapping atomic APIs or orchestrating multi-step workflows).

308.6kinstalls
Added on

NPX Install

npx skill4agent add larksuite/cli lark-skill-maker

SKILL.md Content (Chinese)

View Translation Comparison →

Skill Maker

Create new Skills based on lark-cli. A Skill is a
SKILL.md
file that teaches AI to complete tasks using CLI commands.

Core CLI Capabilities

bash
lark-cli <service> <resource> <method>          # Registered API
lark-cli <service> +<verb>                      # Shortcut (advanced encapsulation)
lark-cli api <METHOD> <path> [--data/--params]  # Any Feishu OpenAPI
lark-cli schema <service.resource.method>       # Check parameter definitions
Priority: Shortcut > Registered API > Raw
api
call.

Research APIs

bash
# 1. View existing API resources and Shortcuts
lark-cli <service> --help

# 2. Check parameter definitions
lark-cli schema <service.resource.method>

# 3. For unregistered APIs, call directly with api
lark-cli api GET /open-apis/vc/v1/rooms --params '{"page_size":"50"}'
lark-cli api POST /open-apis/vc/v1/rooms/search --data '{"query":"5F"}'
If the above commands cannot cover your needs (the CLI does not have a corresponding registered API or Shortcut), use lark-openapi-explorer to dig through the official Feishu documentation library layer by layer to obtain complete method, path, parameter, and permission information, then complete the task via raw
lark-cli api
calls.
Confirm which APIs, parameters, and scopes are needed through the above process.

SKILL.md Template

Place the file at
skills/lark-<name>/SKILL.md
:
markdown
---
name: lark-<name>
version: 1.0.0
description: "<Function description>. Use when users need <trigger scenario>."
metadata:
  requires:
    bins: ["lark-cli"]
---


# <Title>

> **Prerequisite:** Read [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md) first.

## Commands

\```bash
# Single-step operation
lark-cli api POST /open-apis/xxx --data '{...}'

# Multi-step orchestration: Explain data transfer between steps
# Step 1: ... (Record the returned xxx_id)
# Step 2: Use xxx_id from Step 1
\```

## Permissions

| Operation | Required scope |
|------|-----------|
| xxx | `scope:name` |

Key Principles

  • description determines triggering — Include function keywords + "Use when users need..."
  • Authentication — Specify required scopes, use
    lark-cli auth login --domain <name>
    for login
  • Security — Confirm user intent before write operations, recommend
    --dry-run
    for preview
  • Orchestration — Explain data transfer, failure rollback, and parallelizable steps