lark-base

Manage Feishu Base tables, fields, records, views, dashboards, and workflows via lark-cli.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/TrayMachi/dotfiles --skill lark-base-traymachi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-base
Source: https://github.com/TrayMachi/dotfiles/tree/main/agents/skills/lark-base
Command: npx skills add https://github.com/TrayMachi/dotfiles --skill lark-base-traymachi

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Operating Feishu Base (Bitable) through raw APIs is error-prone: field JSON shapes, formula/lookup expressions, filter DSLs, and token handling all have strict rules. This Skill routes every Base operation through the correct lark-cli base +... shortcut with validated structures and recovery guidance. ## Core Features & Use Cases - Table, Field & Record Management: Create and update tables, fields (including formula and lookup), and records with correct CellValue formats, batch limits, and read-only field rules. - Query & Aggregation: Run filtered record queries, Top N sorts, and server-side aggregations via +data-query instead of pulling raw rows locally. - Forms, Dashboards, Workflows & Roles: Submit forms, build dashboard chart blocks with data_config, manage workflow steps, and configure advanced permissions and roles. - Use Case: Given a /base/ link, locate the table, aggregate sales by region with +data-query, then create a dashboard with a bar chart and a statistics card showing the results. ## Quick Start Ask the assistant to list the tables and fields in a Feishu Base link you provide, then create or query records in 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 or update records in a Feishu Base table?

Use lark-cli base +record-upsert, +record-batch-create, or +record-batch-update after reading the field list. Construct CellValue per field type: strings for text, numbers for numeric fields, arrays for multi-select, and YYYY-MM-DD HH:mm:ss for dates. Batches are limited to 200 records.

How do I run aggregation or Top N queries on Feishu Base data?

Use lark-cli base +data-query with a DSL containing dimensions, measures, filters, sort, and pagination so aggregation runs server-side. Local jq processing of +record-list output only covers the fetched page and cannot support global conclusions.

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

Read the formula-field-guide or lookup-field-guide reference first, then call +field-create or +field-update with type formula or lookup and the --i-have-read-guide flag. Table and field names in expressions must exactly match +table-list and +field-get output.

Can I use a wiki or share link as a Base token?

No. A /wiki/ link requires wiki +node-get to resolve the obj_token when obj_type is bitable. Form share links go to +form-detail and +form-submit, while view, dashboard, and record share links cannot be accessed via CLI and must be opened in a browser.

Why does my Base command fail with permission error 91403?

Error 91403 means the identity has no access to that Base. Do not retry in a loop; follow the lark-shared authorization recovery flow, and only retry once with --as bot when user identity lacks resource-level access without a recovery hint.

When should I not use this Base skill?

Do not use it for authentication or scope issues (use lark-shared), for importing Excel or CSV files into Base (use lark-drive +import --type bitable), or for general data analysis discussions without a Base or bitable context.