# Lark Skill Maker > Crea Skills personalizados para lark-cli, útil cuando hay que envolver operaciones de la API de Feishu en un Skill reutilizable (API atómica o flujo de varios pasos). Fuente: https://skillsagentes.com/skills/larksuite/cli/lark-skill-maker Markdown: https://skillsagentes.com/skills/larksuite/cli/lark-skill-maker.md Repositorio: https://github.com/larksuite/cli Autor: larksuite Licencia: MIT Actualizado: hace 6 meses Coste de contexto: 39 tok instalada, 615 tok al activarse, 615 tok con todos los archivos del bundle Bundle: 1 archivo, 2 KB Permisos que pide: ninguno declarado ## Instalación Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina. ```bash # Claude Code npx -y skills add larksuite/cli --skill lark-skill-maker --agent claude-code # Cursor npx -y skills add larksuite/cli --skill lark-skill-maker --agent cursor # Codex npx -y skills add larksuite/cli --skill lark-skill-maker --agent codex # Gemini CLI npx -y skills add larksuite/cli --skill lark-skill-maker --agent gemini # Windsurf npx -y skills add larksuite/cli --skill lark-skill-maker --agent windsurf # Cline npx -y skills add larksuite/cli --skill lark-skill-maker --agent cline ``` ## Qué hace - Genera un nuevo SKILL.md en skills/lark-/SKILL.md siguiendo una plantilla estándar - Guía la investigación de las APIs de lark-cli disponibles: lark-cli --help, lark-cli schema, y lark-cli api para llamadas no registradas - Define la prioridad de uso: Shortcut > API ya registrada > llamada directa con lark-cli api - Indica cómo documentar permisos (scopes) y pasos de orquestación entre múltiples llamadas - Remite a lark-openapi-explorer cuando la API necesaria no está cubierta por el CLI ## Cuándo usarla - El usuario necesita empaquetar una operación de la API de Feishu/Lark en un Skill reutilizable - Se requiere envolver una API atómica o encadenar varios pasos en un flujo (orquestación) ## Qué la activa - "Crea un Skill de lark-cli para reservar salas de reuniones" - "Necesito envolver esta API de Feishu en un Skill reutilizable" - "Ayúdame a documentar los scopes y pasos para un nuevo SKILL.md de lark-cli" ## Antes de instalar - Requiere el binario lark-cli instalado y, para APIs no registradas, puede necesitar lark-openapi-explorer. ## Archivos - SKILL.md — 2 KB ## SKILL.md Reproducido tal cual desde larksuite/cli bajo MIT. Esta sección es el documento original y está en inglés. # Skill Maker 基于 lark-cli 创建新 Skill。Skill = 一份 `SKILL.md`，教 AI 用 CLI 命令完成任务。 ## CLI 核心能力 ```bash lark-cli # 已注册 API lark-cli + # Shortcut（高级封装） lark-cli api [--data/--params] # 任意飞书 OpenAPI lark-cli schema # 查参数定义 ``` 优先级：Shortcut > 已注册 API > `api` 裸调。 ## 调研 API ```bash # 1. 查看已有的 API 资源和 Shortcut lark-cli --help # 2. 查参数定义 lark-cli schema # 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](../lark-openapi-explorer/SKILL.md) 从飞书官方文档库逐层挖掘原生 OpenAPI 接口，获取完整的方法、路径、参数和权限信息，再通过 `lark-cli api` 裸调完成任务。 通过以上流程确定需要哪些 API、参数和 scope。 ## SKILL.md 模板 文件放在 `skills/lark-/SKILL.md`： ```markdown --- name: lark- 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 ` - **安全** — 写入操作前确认用户意图，建议 `--dry-run` 预览 - **编排** — 说明数据传递、失败回滚、可并行步骤 ## Dónde encaja - Categoría: [Herramientas para desarrolladores](https://skillsagentes.com/categorias/herramientas-desarrollo.md) — Skills que cambian cómo tu agente escribe, revisa y despliega código. - Creador: [larksuite](https://skillsagentes.com/creators/larksuite.md) — 28 skills en el directorio - [Todas las skills](https://skillsagentes.com/skills.md) - [Ranking de instalaciones](https://skillsagentes.com/ranking.md) ## Otras skills del mismo repositorio - [Lark Doc](https://skillsagentes.com/skills/larksuite/cli/lark-doc.md): Operaciones sobre documentos en la nube de Lark (Docx/Wiki): leer, crear y editar documentos, insertar o descargar imágenes/adjuntos, y gestionar notas mentales. - [Lark Drive](https://skillsagentes.com/skills/larksuite/cli/lark-drive.md): Drive de Feishu/Lark: gestiona archivos y carpetas (subir/descargar, copiar/mover/eliminar, metadatos, permisos, comentarios, versiones, etiquetas de confidencialidad) e importa archivos locales como docx/sheet/bitable/slides. - [Lark Slides](https://skillsagentes.com/skills/larksuite/cli/lark-slides.md): 飞书幻灯片: crea y edita presentaciones, lee contenido de slides, gestiona páginas (crear, eliminar, leer, reemplazo parcial). No cubre documentos, pizarras ni archivos generales. - [Lark Base](https://skillsagentes.com/skills/larksuite/cli/lark-base.md): Operaciones en Lark Base (multitabla): tablas, campos, registros, vistas, fórmulas/lookup, formularios, dashboards, workflows y roles; se usa ante Base/多维表格/bitable o enlaces /base/. - [Lark Im](https://skillsagentes.com/skills/larksuite/cli/lark-im.md): Mensajería instantánea de Feishu/Lark: enviar y responder mensajes, buscar historial, gestionar miembros de grupo, subir/descargar archivos, reacciones, avisos urgentes y tarjetas interactivas con sus callbacks. ## Skills relacionadas - [Finishing A Development Branch](https://skillsagentes.com/skills/obra/superpowers/finishing-a-development-branch.md): Úsalo cuando la implementación esté completa, todos los tests pasen, y necesites decidir cómo integrar el trabajo. - [Using Git Worktrees](https://skillsagentes.com/skills/obra/superpowers/using-git-worktrees.md): Úsalo al empezar trabajo de feature que necesita aislamiento del workspace actual, o antes de ejecutar planes de implementación: asegura un workspace aislado vía herramientas nativas o fallback a git worktree. - [Writing Skills](https://skillsagentes.com/skills/obra/superpowers/writing-skills.md): Úsala al crear nuevas skills, editar skills existentes o verificar que funcionan antes de desplegarlas. - [Code Review](https://skillsagentes.com/skills/mattpocock/skills/code-review.md): Revisa los cambios desde un punto fijo por dos ejes — Standards (¿sigue los estándares del repo?) y Spec (¿hace lo que pedía el issue?) — en sub-agentes paralelos, y los reporta lado a lado. - [Codebase Design](https://skillsagentes.com/skills/mattpocock/skills/codebase-design.md): Vocabulario compartido para diseñar módulos profundos. Úsalo para diseñar o mejorar la interfaz de un módulo, decidir dónde va un seam, o hacer el código más testeable y navegable para una IA. --- Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)