lark-base

Operate Feishu Bitable tables, fields, records, views, dashboards, and workflows via lark-cli.

Updated Jun 29, 2026
One-click install
npx skills add https://github.com/trungpr1990-coder/AMI-MAKEUP --skill lark-base-trungpr1990-coder
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lark-base
Source: https://github.com/trungpr1990-coder/AMI-MAKEUP/tree/main/.agents/skills/lark-base
Command: npx skills add https://github.com/trungpr1990-coder/AMI-MAKEUP --skill lark-base-trungpr1990-coder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lark-cli, and includes references (resource) components.

What problem does it solve? Managing Feishu Base (Bitable) through raw APIs is error-prone: tokens get confused with wiki links, field JSON shapes are easy to get wrong, and global statistics cannot be answered from paginated record reads. This Skill routes every Base operation through the correct lark-cli base +... shortcut with the right references. ## Core Features & Use Cases - Table, field, and record management: create and update tables, fields (including formula and lookup), and records with correct CellValue formats, batch limits, and attachment commands. - Query and aggregation: run server-side filtering, sorting, TopN, and grouped aggregation via +data-query instead of pulling raw records locally. - Forms, dashboards, workflows, and roles: submit forms, build dashboard blocks with data_config, manage workflow steps, and configure advanced permissions and custom roles. - Use Case: A user pastes a /base/ link and asks for the top 10 sales by region. The Skill resolves the base token, reads the real field list, runs a +data-query aggregation in the cloud, and returns a traceable answer. ## Quick Start Ask the assistant to list all tables in a Feishu Base by providing its share link, and it will resolve the token and run the appropriate lark-cli base command.

Frequently Asked Questions about lark-base

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create or update records in a Feishu Bitable from the command line?▼

Use lark-cli base +record-upsert, +record-batch-create, or +record-batch-update with JSON CellValues keyed by field name or ID. Read the field list first, write only storage fields, and keep batches under 200 records.

How do I run aggregation or TopN queries on Feishu Base data?▼

Use lark-cli base +data-query with a DSL containing dimensions, measures, filters, sort, and pagination so aggregation runs in the Base cloud service. Do not compute global statistics from paginated +record-list output locally.

How do I create a formula or lookup field in Feishu Bitable?▼

Create it with +field-create or +field-update using JSON with type formula or lookup, after reading the formula or lookup field guide. The CLI requires the --i-have-read-guide confirmation flag for these field types.

Why does my Feishu Base command fail with an invalid base token error?▼

The error usually means a wiki token, workspace token, or full URL was passed as --base-token. Resolve the real token first with +url-resolve for links or +title-resolve for title keywords.

Can I import an Excel or CSV file into Feishu Base with this skill?▼

No, file import is out of scope. Use lark-cli drive +import --type bitable from the lark-drive skill to convert Excel, CSV, or .base files, then return to base commands for further operations.

How do I add charts to a Feishu Base dashboard?▼

Create a dashboard with +dashboard-create, then add blocks serially with +dashboard-block-create using a data_config JSON that references real table and field names. The series and count_all options are mutually exclusive.