lark-base

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

Updated Jun 26, 2026
One-click install
npx skills add https://github.com/dulltackle/kangkang-skills --skill lark-base-dulltackle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-base
Source: https://github.com/dulltackle/kangkang-skills/tree/main/lark-base
Command: npx skills add https://github.com/dulltackle/kangkang-skills --skill lark-base-dulltackle

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing Feishu Bitable (多维表格) programmatically requires navigating a complex resource model of tables, fields, records, views, forms, dashboards, workflows, and BaseApp pages. This Skill provides structured operational guidance for every Base operation through the lark-cli command line, eliminating guesswork about tokens, filters, and JSON payloads. ## Core Features & Use Cases - Table and Record Operations: Create tables and fields, batch create/update records with typed CellValues, and run filtered queries with server-side predicate pushdown and NDJSON export. - Dashboards and Analytics: Build dashboards with charts, metric cards, and rankings, read computed chart results, and run aggregation queries via the data-query DSL. - BaseApp and Workflow Management: Organize Workspaces, create BaseApp pages and components, configure workflows, forms, and advanced permission roles. - Use Case: A user shares a /base/ URL and asks for a sales dashboard. The Skill resolves the URL to a base_token, locates the table and fields, creates a dashboard with a statistics card, trend line chart, and Top-N ranking, then arranges the layout. ## Quick Start Ask the assistant to list the tables in a Feishu Bitable by pasting its /base/ link, then request a summary chart of any field.

Frequently Asked Questions about lark-base

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

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

Use lark-cli base +record-batch-create with --base-token, --table-id, and a --json payload mapping field names to typed cell values. Batches are limited to 200 records and writes to the same table must run serially to avoid concurrency conflicts.

How do I filter Bitable records with conditions?

Pass --filter-json to +record-list using tuple conditions with a logic of and/or. Operators include intersects for select and text fields, numeric comparisons, and ExactDate for datetime ranges; empty checks use empty or non_empty without a value.

Can I build a Feishu Base dashboard with charts programmatically?

Yes. Create the dashboard with +dashboard-create, then add components serially with +dashboard-block-create using a data_config that specifies table_name, series or count_all, group_by, and optional filters. Supported types include column, line, pie, ranking, statistics, and text.

Does lark-base support BaseApp (AppMode) pages and components?

Yes, BaseApp is managed within this Skill using app_token, page_id, and block_id via +app-create, +app-page-*, and +app-block-* commands. BaseApp does not use lark-apps, and copying a BaseApp or deleting page components is not currently supported.

What operations are outside the scope of this Bitable skill?

Authentication, scope, and identity issues go to lark-shared; Excel or CSV import/export goes to lark-drive; embedded Docx body editing goes to lark-doc; spreadsheet content goes to lark-sheets. This Skill only handles Base-domain operations.

Why did my Bitable record write not appear when I read it back immediately?

Most table updates apply through an asynchronous pipeline, so immediate reads may show stale state. Treat the write success response as the result, and only read back after completing all related changes in the workflow.