🎯

lark-skill-maker

🎯Skill

Helps you write your own skills for lark-cli, the command-line tool for Feishu (Lark). A skill is a SKILL.md file that teaches your AI a Feishu task, from one action to a multi-step process.

larksuite/cli443,130 InstallsAdded Mar 28, 2026

Installation

$npx skills add larksuite/cli --skill lark-skill-maker

Run it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).

Uses skills.sh · Node.js 22.20+

After installing

Ask for related work and the agent uses it on its own, or call it yourself.

Run it (Claude Code)/lark-skill-maker

Install by hand

Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.

Open the skill folder →

This project .claude/skills/lark-skill-maker/
All projects ~/.claude/skills/lark-skill-maker/

These paths are for Claude Code. For other tools, the command above puts it in the right place.

📦Same repositorylarksuite/cli (11 items)

What this skill does

Overview

Here, a skill is a SKILL.md file that teaches an AI how to finish a task with lark-cli commands. This skill shows how to find the Feishu API you need (the interface that programs use to talk to Feishu) and gives you a ready template to fill in. It also lists rules that help the new skill start at the right time and run safely.

Key Features

Look up available commands with lark-cli <service> --help and check parameters with lark-cli schema.
Call any Feishu API directly with lark-cli api when no ready-made command exists.
Choose commands in a set order: a Shortcut (a ready-made higher-level command) first, then a registered API, then a direct api call.
Start from a template saved at skills/lark-<name>/SKILL.md, with commands and a table of required permissions.
Apply safety rules, such as confirming with the user before write actions and previewing with --dry-run.

Who is this for?

It is for people who repeat the same Feishu or Lark tasks and want their AI assistant to do them on request. It helps most when a task chains several steps and passes an ID from one step to the next.

Summarized by AI from this skill's SKILL.md. Suggest a better one

SKILL.md

View on GitHub →

创建 lark-cli 的自定义 Skill。当用户需要把飞书 API 操作封装成可复用的 Skill（包装原子 API 或编排多步流程）时使用。

Skill Maker

基于 lark-cli 创建新 Skill。Skill = 一份 SKILL.md，教 AI 用 CLI 命令完成任务。

CLI 核心能力

lark-cli <service> <resource> <method>          # 已注册 API
lark-cli <service> +<verb>                      # Shortcut（高级封装）
lark-cli api <METHOD> <path> [--data/--params]  # 任意飞书 OpenAPI
lark-cli schema <service.resource.method>       # 查参数定义

优先级：Shortcut > 已注册 API > api 裸调。

调研 API

# 1. 查看已有的 API 资源和 Shortcut
lark-cli <service> --help

# 2. 查参数定义
lark-cli schema <service.resource.method>

# 3. 未注册的 API，用 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"}'

如果以上命令无法覆盖需求（CLI 没有对应的已注册 API 或 Shortcut），使用 lark-openapi-explorer 从飞书官方文档库逐层挖掘原生 OpenAPI 接口，获取完整的方法、路径、参数和权限信息，再通过 lark-cli api 裸调完成任务。

通过以上流程确定需要哪些 API、参数和 scope。

SKILL.md 模板

文件放在 skills/lark-<name>/SKILL.md：

---
name: lark-<name>
version: 1.0.0
description: "<功能描述>。当用户需要<触发场景>时使用。"
metadata:
  requires:
    bins: ["lark-cli"]
---


# <标题>

> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)。

## 命令

\```bash
# 单步操作
lark-cli api POST /open-apis/xxx --data '{...}'

# 多步编排：说明步骤间数据传递
# Step 1: ...（记录返回的 xxx_id）
# Step 2: 使用 Step 1 的 xxx_id
\```

## 权限

| 操作 | 所需 scope |
|------|-----------|
| xxx | `scope:name` |

关键原则

description 决定触发 — 包含功能关键词 + "当用户需要...时使用"
认证 — 说明所需 scope，登录用 lark-cli auth login --domain <name>
安全 — 写入操作前确认用户意图，建议 --dry-run 预览
编排 — 说明数据传递、失败回滚、可并行步骤

More from this repository10

🎯

lark-mail🎯Skill

Lets Claude read, search, organize and write your Feishu (Lark) email from the command line. New messages are saved as drafts first, and nothing is sent until you approve it.

🎯

lark-event🎯Skill

This skill lets your AI agent listen for live events in Lark (Feishu), a work chat app, such as new messages, approvals, task updates and meetings. The agent can then react to each event as it arrives.

🎯

lark-contact🎯Skill

Helps your AI assistant find people in Feishu/Lark, a workplace messaging app, by name or email, and search for bots by keyword. It can also show a person's department, email, status or profile signature.

🎯

lark-openapi-explorer🎯Skill

This skill lets your AI use features of Feishu/Lark, a workplace chat and office app, that lark-cli has no command for yet. It looks them up in the official docs step by step and then calls them with `lark-cli api`.

🎯

lark-slides🎯Skill

Lets your AI agent create, read and edit presentations in Lark (Feishu) Slides. It plans each deck first and checks every slide's layout before saving it.

🎯

lark-apps🎯Skill

A skill that helps your AI agent build, publish and run apps on Miaoda (Spark), the app building and hosting service in Feishu/Lark. It also manages app data, logs, settings, team access and automatic tasks.

🎯

cli-e2e-testcase-writer🎯Skill

Part of the official Lark/Feishu CLI, providing 200+ commands and 26 AI agent skills across 18 business domains including Messenger, Docs, Sheets, Calendar, and Mail. Designed for both humans and AI agents with agent-friendly structured output.

🎯

good-skill-minimal🎯Skill

The official Lark/Feishu CLI tool providing 200+ commands and 26 AI agent skills across core business domains including Messenger, Docs, Base, Sheets, Calendar, Mail, Tasks, and Meetings.

🎯

good-skill-complex🎯Skill

Part of the official Lark/Feishu CLI tool with 200+ commands and 26 AI agent skills across 18 business domains including Calendar, Messenger, Docs, Sheets, Base, Tasks, and Mail, featuring agent-native design and structured output.

🎯

good-skill🎯Skill

The official Lark/Feishu CLI tool with 200+ commands and 26 AI agent skills covering Messenger, Docs, Base, Sheets, Calendar, Mail, Tasks, Meetings, and more. Designed for both humans and AI agents.