lark-base

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

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill lark-base-yuezhen-huang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-base
Source: https://github.com/yuezhen-huang/my-bytedance-skillhub/tree/main/lark-base
Command: npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill lark-base-yuezhen-huang

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Managing Feishu (Lark) Bitable spreadsheets through raw APIs is error-prone: agents guess field names, misuse tokens from wiki links, and pull full record sets for manual aggregation. This Skill provides a disciplined command playbook for lark-cli base operations so every table, field, record, view, workflow, role, form, and dashboard action follows validated procedures. ## Core Features & Use Cases - Table, Field & Record Management: Create tables, define fields (including formula and lookup fields), and upsert records using atomic lark-cli base +... commands with strict writability rules. - Server-Side Aggregation: Run grouped statistics, SUM/AVG/COUNT queries, and filtered analysis through +data-query DSL instead of exporting records for manual calculation. - Automation & Governance: Configure workflows, advanced permissions, custom roles, forms, and dashboards with chart blocks, including mandatory schema reading before any workflow creation. - Use Case: A user pastes a wiki link to a Bitable and asks for a per-city sales summary. The Skill resolves the wiki token to the real base token, fetches the actual field list, builds a +data-query DSL with exact field names, and returns aggregated results. ## Quick Start Ask the agent to list all tables and fields in your Feishu Bitable link, then create a formula field or run an aggregated data query on it.

Frequently Asked Questions about lark-base

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

FAQPage Schema
How do I create a formula field in Feishu Bitable with lark-cli?

First read the formula-field-guide reference, then fetch the real table structure with +table-list and +field-list. Create the field using lark-cli base +field-create with type=formula and an expression whose table and field names exactly match the returned schema.

How to run aggregation queries on Lark Bitable records?

Use lark-cli base +data-query with a JSON DSL defining dimensions, measures, filters, and sort. It performs server-side grouping and aggregation like SUM, AVG, and COUNT, so you should not pull full record lists with +record-list for manual calculation.

Why does my Bitable command fail with base token invalid?

This usually happens when a wiki token is passed as the base token. Resolve the link first with lark-cli wiki spaces get_node, confirm obj_type is bitable, then retry using node.obj_token as --base-token instead of switching to bitable/v1 APIs.

Should I use a formula field or a lookup field in Bitable?

Prefer formula fields by default because they cover calculations, conditionals, text handling, date differences, and cross-table aggregation. Use lookup only when the user explicitly requests it or the fixed from/select/where/aggregate model fits better.

What are the limits when listing or writing Bitable records?

The +record-list limit parameter caps at 200 per call, so use offset pagination for more data. Batch writes are limited to 500 records per call, must run serially, and all +xxx-list commands are forbidden from concurrent execution.