---
id: daily-lark-skill-maker
name: "lark-skill-maker"
url: https://skills.yangsir.net/skill/daily-lark-skill-maker
author: larksuite
domain: ai-skill-platform-ecosystem
tags: ["developer-tools", "documentation", "skill-development", "automation", "cli"]
install_count: 154400
rating: 4.80 (20 reviews)
github: https://github.com/larksuite/cli
---

# lark-skill-maker

> 基于飞书CLI创建新Skill，自动生成SKILL.md模板，帮助快速构建AI可用的命令行工具文档

**Stats**: 154,400 installs · 4.8/5 (20 reviews)

## Before / After 对比

### Skill开发

**Before**:

手动编写SKILL.md文档、研究CLI命令格式、编写示例代码，创建一个Skill需要2小时

**After**:

运行命令自动生成SKILL.md模板、自动提取CLI命令和参数，创建一个Skill只需10分钟

| Metric | Before | After | Change |
|---|---|---|---|
| 开发时间 | 120分钟 | 10分钟 | -92% |

## Readme

# lark-skill-maker

# 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](https://github.com/larksuite/cli/blob/HEAD/skills/lark-skill-maker/../lark-openapi-explorer/SKILL.md) 从飞书官方文档库逐层挖掘原生 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` 预览

- **编排** — 说明数据传递、失败回滚、可并行步骤

Weekly Installs3.5KRepository[larksuite/cli](https://github.com/larksuite/cli)GitHub Stars1First SeenTodaySecurity Audits[Gen Agent Trust HubPass](/larksuite/cli/lark-skill-maker/security/agent-trust-hub)[SocketWarn](/larksuite/cli/lark-skill-maker/security/socket)[SnykPass](/larksuite/cli/lark-skill-maker/security/snyk)Installed oncodex3.5Kopencode3.5Kgithub-copilot3.5Kcursor3.5Kgemini-cli3.5Kcline3.5K

---
*Source: https://skills.yangsir.net/skill/daily-lark-skill-maker*
*Markdown mirror: https://skills.yangsir.net/api/skill/daily-lark-skill-maker/markdown*