lark-base

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

1.3k|142|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/MiniMax-AI/minimax-code --skill lark-base-minimax-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-base
Source: https://github.com/MiniMax-AI/minimax-code/tree/main/packages/local-runtime/assets/skills/lark-tools/cli-skills/lark-base
Command: npx skills add https://github.com/MiniMax-AI/minimax-code --skill lark-base-minimax-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Managing Feishu (Lark) Base spreadsheets through raw APIs is error-prone and slow. This Skill routes every Base operation—table creation, field management, record CRUD, view configuration, formula/lookup fields, aggregation queries, dashboards, forms, workflows, and role permissions—through the correct lark-cli shortcut command with the right reference documentation. ## Core Features & Use Cases - Full Base lifecycle management: create, copy, and inspect Bases; manage tables, fields, records, and views with atomic lark-cli base +... commands. - Formula and lookup fields: guided creation of derived fields, cross-table calculations, and conditional logic using a strict formula function whitelist. - Analytics and visualization: run one-off aggregation queries with +data-query, and build dashboards with charts, metric cards, and Markdown text blocks. - Automation and governance: manage workflows, forms, advanced permissions, and custom roles with admin-level safeguards. - Use Case: A user provides a /base/{token} link and asks to add a formula field computing each deal's weighted revenue, then build a bar-chart dashboard grouped by sales stage—the Skill routes through +field-list, the formula guide, +field-create, and +dashboard-block-create in sequence. ## Quick Start Ask the assistant to use the lark-base skill to list all tables and fields in your Feishu Base by providing its base token or share link.

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 table in Feishu Base from the command line?

Use lark-cli base +table-create with --base-token, --name, and a --fields JSON array defining each field's name, type, and properties. Read the lark-base-table-create reference first, and note that field names and types must follow the shortcut field properties specification.

How do I import a local Excel or CSV file into Feishu Base?

Do not start with base commands. Run lark-cli drive +import --type bitable to convert the local file into a Base first, then use lark-cli base +... commands for any further table, field, or record operations inside it.

Should I use a formula field or a lookup field in Feishu Base?

Prefer formula fields by default: they handle calculations, conditions, text processing, date differences, and cross-table aggregation in one expression. Use lookup only when explicitly requested or when the fixed from/select/where/aggregate modeling pattern naturally fits.

Why does lark-cli base +data-query return a permission error?

The caller must be an administrator of the target Base with Full Access, otherwise the query fails. Also verify your fields are supported: formula, lookup, attachment, system, and link fields cannot be used in dimensions, measures, filters, or sort.

Can I use a wiki link token directly as a base token?

No. A /wiki/{token} link's token is not a base token. Resolve it first with lark-cli wiki spaces get_node to obtain node.obj_token, then pass that value as --base-token to base commands.

How do I download an attachment stored in a Feishu Base record?

Get the file_token from the attachment field returned by +record-get, then run lark-cli docs +media-download. Do not use lark-cli drive +download, which returns a 403 error for Base attachments.