lark-base

Operate Feishu Base tables, records, views, dashboards, workflows, and roles via lark-cli.

2|Updated Aug 9, 2026
One-click install
npx skills add https://github.com/DeepJH/doubao-skill-and-info --skill lark-base-deepjh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-base
Source: https://github.com/DeepJH/doubao-skill-and-info/tree/main/skills/lark-base
Command: npx skills add https://github.com/DeepJH/doubao-skill-and-info --skill lark-base-deepjh

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Managing Feishu (Lark) Base / Bitable data 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 partial record pages. This Skill provides a complete command routing and safety contract for operating Base through the lark-cli base shortcuts. ## Core Features & Use Cases - Full Base operations: create and copy Bases, manage tables, fields, records, views, forms, dashboards, workflows, and advanced permission roles through lark-cli base +... shortcuts. - Correct data analysis: enforce cloud-side filtering, sorting, and aggregation with +data-query instead of local jq processing, so Top N, totals, and global conclusions are trustworthy. - Safe writes: read-modify-write rules, CellValue construction specs, formula/lookup field guides, and confirmation gates for high-risk operations like deletes and form submissions. - Use Case: A user pastes a /base/ link and asks for the top 10 sales by region. The Skill resolves the URL to a real base_token, reads the table schema, runs a cloud-side aggregation, and returns verified results. ## Quick Start Ask the assistant to use the lark-base skill to list the tables and fields in the Base behind your shared /base/ link.

Frequently Asked Questions about lark-base

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

FAQPage Schema
How do I query and aggregate records in a Feishu Base table?

Use lark-cli base +data-query with a DSL containing dimensions, measures, filters, sort, and pagination so aggregation runs in the Base cloud service. For raw record rows with conditions, use +record-list or +record-search with --filter-json and --sort-json instead of pulling pages locally.

How do I create formula or lookup fields in Lark Bitable?

Create them with lark-cli base +field-create --json including type formula or lookup, after reading the formula-field-guide or lookup-field-guide references. The CLI requires the --i-have-read-guide flag, and table and field names in expressions must exactly match +table-get output.

Why does my 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 lark-cli base +url-resolve for links or +title-resolve for names, then reuse the returned base_token and IDs.

Can lark-cli import or export Base data as local files?

File import and export between local files and Base is handled by the separate lark-drive skill, not lark-base. For copying a Base online inside Feishu, use the +base-copy shortcut instead of an export-import round trip.

What are the limits when writing records to Lark Base in bulk?

Batch writes are limited to 200 records per call, and writes to the same table should run serially. Error 1254291 indicates a write conflict requiring a short wait and retry, and only storage fields are writable since formula, lookup, and system fields are read-only.