Lark Base Skill
- 408k installs
- 16.3k repo stars
- Updated August 11, 2026
- larksuite/cli
This is a copy of lark-base by open.feishu.cn - installs and ranking accrue to the original listing.
lark-base is a lark-cli agent skill that searches, schemas, reads, writes, and analyzes Feishu/Lark Base multidimensional tables for developers building automated internal tools, dashboards, and data pipelines.
About
lark-base is a larksuite/cli agent skill (version 1.2.1) for Feishu/Lark Base multidimensional table operations via lark-cli base commands. It covers table search and creation, field management including formulas and lookup references, record CRUD, view configuration, dashboards, workflows, and role management. Developers reach for lark-base when automating Bitable data, running filtered aggregations, or migrating legacy +table/+field/+record syntax to current +command forms. Query tasks with filters, Top/Bottom N, or cross-table joins require reading references/lark-base-data-analysis-sop.md before choosing record, view, or data-query paths. The skill depends on lark-shared for authentication and must read per-command reference docs before execution.
- Handles search, table creation, field management, record CRUD, sharing links, view configuration, and history queries.
- Manages workflows, dashboards, forms, roles, and permissions in Lark Base.
- Converts legacy +table/+field/+record commands into current atomic lark-cli base syntax.
- Enforces reading official reference docs before every base command execution.
- Requires data-analysis SOP review for any query involving filters, aggregation, sorting, Top-N, or cross-table joins.
Lark Base by the numbers
- 407,729 all-time installs (skills.sh)
- Security screen: HIGH risk (skills.sh audit)
- Data as of Aug 11, 2026 (Skillselion catalog sync)
npx skills add https://github.com/larksuite/cli --skill lark-baseAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 408k |
|---|---|
| repo stars | ★ 16.3k |
| Security audit | 2 / 3 scanners passed |
| Last updated | August 11, 2026 |
| Repository | larksuite/cli ↗ |
How do you automate Feishu Base tables from CLI?
Reliably operate Feishu (Lark) Base multidimensional tables through the lark-cli when building internal tools, dashboards, data pipelines, or automated workflows.
Who is it for?
Developers building agent-driven workflows over Feishu/Lark Bitable with field design, formulas, aggregations, or cross-table analytics.
Skip if: Skip lark-base for importing local Excel or CSV into a new Base—use lark-drive +import --type bitable first.
When should I use this skill?
User needs to search Base, manage fields, read/write records, configure views, or run filtered aggregations on Feishu multidimensional tables.
What you get
Created or updated Base tables, fields, records, views, and query results from lark-cli base operations.
- Base table schema
- queried or updated records
By the numbers
- Skill version 1.2.1 in larksuite/cli
- Requires reading lark-base-data-analysis-sop.md before aggregation queries
Files
base
前置条件： 先阅读 `../lark-shared/SKILL.md`。
执行前必做： 执行任何 base 命令前，必须先阅读对应命令的 reference 文档，再调用命令。查询类任务必做： 涉及筛选、排序、Top/Bottom N、聚合、多表关联、查询后写入或判断全局结论时，必须先阅读 `references/lark-base-data-analysis-sop.md`，再选择 record / view / data-query 路径。命名约定： Base 业务命令仅使用lark-cli base +...形式；解析 Wiki 链接使用lark-cli wiki +node-get。
分流规则： 如果用户要“把本地文件导入成 Base / 多维表格 / bitable”，第一步不是base，而是lark-cli drive +import --type bitable；导入完成后再回到lark-cli base +...做表内操作。
1. 何时使用本 Skill
1.1 触发条件
以下场景应使用本 skill：
- 用户明确要操作飞书多维表格 / Base。
- 用户要建表、改表、查表、删表，或管理字段、记录、视图。
- 用户要做公式字段、lookup 字段、派生指标、跨表计算。
- 用户要做临时统计、聚合分析、比较排序、求最值。
- 用户要管理 workflow、dashboard、表单、角色权限。
- 用户给出
/base/{token}链接。 - 用户给出
/wiki/{token}链接，且最终解析为bitable。 - 用户要把旧的 Base 聚合式写法改成当前原子命令写法，例如把旧
+table / +field / +record / +view / +history / +workspace改写成当前命令。
以下场景不应使用本 skill：
- 用户只是做认证、初始化配置、切换
--as user/bot、处理 scope。此时先读../lark-shared/SKILL.md。 - 用户只是泛化地讨论“数据分析 / 字段设计”，但并不在 Base 场景中。不要因为提到“统计 / 公式 / lookup”就误触发。
1.2 前置约束
1. 先阅读 `../lark-shared/SKILL.md`。 2. Base 业务命令仅使用 lark-cli base +... 形式的 shortcut 命令。 3. 如果输入是 Wiki 链接或 Wiki token，并且用户想读取/操作其中的 Base，先执行 lark-cli wiki +node-get --node-token <wiki_url_or_token>；当返回 data.obj_type=bitable 时，把 data.obj_token 当作 --base-token。不要把 URL 里的 /wiki/{token} 当成 Base token。（旧的 --token flag 仍可用，但已 deprecated，会在 stderr 打印迁移提示。） 4. 定位到命令后，先读该命令对应的 reference，再执行命令。 5. 如果用户要把本地 Excel / CSV / .base 快照导入成 Base / 多维表格 / bitable，第一步不是 base，而是 lark-cli drive +import --type bitable；导入完成后再回到 lark-cli base +... 做表内操作。 6. 不要在 Base 场景改走 lark-cli api /open-apis/bitable/v1/...。 7. 如果用户只给 Base 名称、关键词，或说“帮我找一个多维表格”，先通过 lark-cli drive +search --query <keyword> --doc-types bitable 搜索 Base / 多维表格资源；拿到 Base URL 后再使用本 skill 的 base +... 命令。复杂搜索再读 `../lark-drive/references/lark-drive-search.md`：标题精确匹配、限定 owner（--mine / --creator-ids，owner 语义非"最初创建人"）/群/文件夹/时间范围、只搜标题/评论、分页/全量搜索。
2. 模块与命令导航
本章按“先选模块，再选命令”的方式组织。先判断用户目标属于哪个大模块，再进入对应子模块，按要求阅读 reference 后执行命令。
2.1 模块地图
| 大模块 | 处理什么问题 | 包含的小模块 / 能力 |
|---|---|---|
| Base 模块 | 管理 Base 本体，或从链接进入 Base 场景 | base-create / base-get / base-copy，Base / Wiki 链接解析 |
| 表与数据模块 | 管理 Base 内部结构与日常数据操作 | table / field / record / view |
| 公式 / Lookup 模块 | 处理派生字段、条件判断、跨表计算、固定查找引用 | formula / lookup 字段创建与更新 |
| 数据分析模块 | 做一次性筛选、分组、聚合分析 | data-query |
| Workflow 模块 | 管理自动化流程 | workflow-list / get / create / update / enable / disable |
| Dashboard 模块 | 管理仪表盘和图表组件 | dashboard-* / dashboard-block-* |
| 表单模块 | 管理表单和表单题目 | form-* / form-questions-* |
| 权限与角色模块 | 管理高级权限和自定义角色 | advperm-* / role-* |
2.2 Base 模块
用于管理 Base 本体，或从用户给出的链接进入后续 Base 操作。 模块索引：`references/lark-base-workspace.md`
| 命令 | 用途 / 何时使用 | 必读 reference | 路由提醒 |
|---|---|---|---|
lark-cli drive +search --query <keyword> --doc-types bitable | 按名称、关键词查找 Base / 多维表格 / bitable | 复杂搜索再读 `../lark-drive/references/lark-drive-search.md` | 先定位资源，再回到 base +... 操作表内数据 |
+base-create | 创建新的 Base | `lark-base-base-create.md`、`lark-base-workspace.md` | 写入操作；执行前先读 reference；--folder-token、--time-zone 都是可选项 |
+base-get | 获取 Base 信息 | `lark-base-base-get.md`、`lark-base-workspace.md` | 适合确认 Base 本体信息，不替代表/字段结构读取 |
Related skills
Agent BrowserGive their coding agent reliable, high-fidelity control over any website or Electron desktop app.655k40.4k
Twitter AutomationAutomate X/Twitter posts, scheduling, and engagement via X API integration568k693
Lark ApprovalLet their AI coding agent create, read, update, and approve items in Lark (Feishu) approval workflows without leaving the coding environment.558kLark EventHandle Feishu/Lark bot events, webhooks, and subscription callbacks in agent-driven backend code.557kLark Workflow Meeting SummaryAutomatically generate structured meeting summaries and action items from Lark/Feishu calls without manual note-taking.556kLark Workflow Standup ReportAutomatically generate and post daily standup reports in Lark/Feishu from their workflow and activity data.556kHow it compares
Pick lark-base for live Bitable CRUD and analytics; use lark-drive when importing local Excel, CSV, or .base snapshots into a new table.
FAQ
When must lark-base read the data-analysis SOP?
lark-base requires reading references/lark-base-data-analysis-sop.md before any task involving filters, sorting, Top/Bottom N, aggregations, multi-table joins, or query-then-write workflows, so the agent picks record, view, or data-query correctly.
What lark-cli prefix does lark-base use?
lark-base uses only lark-cli base +... business commands for tables, fields, records, views, dashboards, and workflows. Legacy +table, +field, and +record forms should be migrated to the current +command syntax guided by the skill.
Is Lark Base safe to install?
skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.