lark-base

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

2.0k|291|Updated Jul 24, 2026
One-click install
npx skills add https://github.com/Pinvou/pinvou-agent --skill lark-base-pinvou
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-base
Source: https://github.com/Pinvou/pinvou-agent/tree/main/pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-base
Command: npx skills add https://github.com/Pinvou/pinvou-agent --skill lark-base-pinvou

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Managing Feishu (Lark) Bitable data—creating tables, writing records, building dashboards, and configuring workflows—normally requires manual UI work or raw API calls. This Skill turns those operations into deterministic lark-cli commands an AI agent can execute safely. ## Core Features & Use Cases - Full Base lifecycle: Create and copy Bases, manage tables, fields, records, views, forms, dashboards, workflows, folders, and advanced permission roles through structured CLI commands. - Query and analysis: Filter, sort, and export records to NDJSON, run server-side aggregation with the data-query DSL, and read computed chart results from dashboard blocks. - BaseApp and Workspace support: Build app-mode pages with chart and list components bound to Base data inside Workspaces. - Use Case: Ask the agent to "create a project tracking Base with a status field, add 20 tasks, and build a dashboard showing tasks per owner"—it resolves tokens, creates the schema, batch-writes records, and assembles the dashboard in sequence. ## Quick Start Ask the agent to list the tables in a Feishu Base link you provide and show the first 20 records of one table.

Frequently Asked Questions about lark-base

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

FAQPage Schema
How do I create and write records to a Feishu Bitable from the command line?

Use lark-cli base +base-create to create the Base with an initial table and fields, then +record-batch-create with a JSON payload of field-to-CellValue mappings. Batches are limited to 200 records and writes to the same table must run serially.

How do I filter records in a Lark Base table?

Pass --filter-json to +record-list with tuple conditions like ["Status", "intersects", ["Doing"]], supporting operators such as ==, >=, contains, and ExactDate for datetime ranges. Export results with --format ndjson for local jq or Python processing.

Can this Skill build dashboards and charts in Feishu Base?

Yes. It creates dashboard containers with +dashboard-create and adds chart, ranking, statistics, or text blocks via +dashboard-block-create using a data_config that defines table, series, group_by, and filter. Computed chart results are read back with +dashboard-block-get-data.

Does lark-base support BaseApp application mode and Workspaces?

Yes, it manages Workspaces, BaseApps, pages, and page components using app_token and page_id coordinates. Limitations apply: BaseApp copy, page copy, page icons, and removing resources from a Workspace are not supported.

When should I not use the lark-base skill?

Do not use it for generic document or spreadsheet requests that should go to local tools, or for authentication and scope issues (lark-shared), file import/export (lark-drive), Docx body editing (lark-doc), or spreadsheet content (lark-sheets).

Why did my Base record write fail with a concurrency error?

Error 1254291 indicates parallel writes to the same table. Writes to one table must be serialized; split payloads larger than 200 records into sequential batches instead of running them concurrently.