lark-cli-agent-skill

name	lark-cli-agent-skill
description	Agent skill that operates Feishu/Lark strictly via the official lark-cli.

Skill: lark-cli-agent-skill

Overview

This skill enables an agent to operate Feishu/Lark strictly through the official lark-cli command line, returning concise and reliable summaries of results.

Philosophy of Usage

• CLI-first, API-never: The agent must execute all Feishu actions through lark-cli, never through direct API calls or SDKs.
• Explicit over implicit: Prefer explicit parameters and ids to avoid ambiguous behavior.
• Safe and observable: Validate CLI availability and auth state before any action, and surface clear summaries and errors.
• Respect least surprise: Choose domain commands and shortcuts that best match user intent.

First-Time Use Guidance

• If this is the first time using the skill, gather examples by running lark-cli --help and lark-cli <domain> --help.
• Use the help output to map user intent to a safe, supported command before executing it.

When Stuck

• If a command is unclear, the agent must use --help on the CLI or domain command to discover flags and subcommands.
• If no command fits, the agent must refuse and explain that only lark-cli operations are allowed.

Core Skills

• Translate Feishu requests into the appropriate lark-cli domain command or shortcut.
• Validate lark-cli availability and authentication before execution.
• Execute commands with explicit parameters and return a concise summary.
• Refuse unsupported requests with a CLI-only explanation and alternatives.

Use Cases

• Send or read Feishu messages and manage chats.
• Check calendars, agendas, and free/busy data.
• Search contacts and retrieve profile details.
• Create or query docs, drive files, sheets, and slides.
• Manage tasks and task lists.

Constraints

• All Feishu operations MUST be executed by the agent via lark-cli commands only.
• Do NOT call Feishu APIs directly or use any other SDKs/tools.
• If a request cannot be mapped to a lark-cli command, refuse and explain.

Prerequisites

• lark-cli installed: npm install -g @larksuite/cli
• CLI skill installed: npx skills add larksuite/cli -y -g
• Auth configured: lark-cli config init --new
• Logged in: lark-cli auth login --recommend

Supported Domains (initial)

• Messaging: lark-cli im
• Calendar: lark-cli calendar
• Contacts: lark-cli contact
• Docs: lark-cli doc
• Drive: lark-cli drive
• Tasks: lark-cli task
• Sheets: lark-cli sheets
• Slides: lark-cli slides
• Base: lark-cli base
• Mail: lark-cli mail
• Wiki: lark-cli wiki

Execution Rules

1. Validate CLI availability (lark-cli --version).
2. Validate authentication (lark-cli auth status).
3. Select the correct domain command or shortcut.
4. Execute the exact lark-cli command with explicit parameters.
5. Summarize stdout and provide key IDs or links.
6. On failure, report error summary and recovery steps.

Error Handling

• Missing CLI: instruct to install and add the CLI skill.
• Missing auth: instruct to run lark-cli auth login --recommend.
• Missing scopes: instruct to re-login with recommended or explicit scopes.
• Unsupported request: explain the limitation and suggest available commands.

CLI-Only Enforcement

If the requested action cannot be performed with lark-cli, do not attempt any non-CLI method. Respond with a refusal and a suggestion to use a supported command.