Guide · Agent skill
How to use the Lark CLI Demo agent skill (lark-demo)
Updated · written with AI from the project's own documentation and checked against our catalogue data
lark-demo is a minimal demo skill from the larksuite/cli repository, stored as a test file for a skill scanner. It is not a working tool for everyday Lark work. This guide explains what the file contains, how to install it for an agent, what its example commands would do, and why you should review it before running anything.
Lark CLI Demolarksuite/cli · MIT Download the skill Quick start
- 1Download the ZIP. Download the lark-demo skill ZIP from this page.
- 2Unzip into a skills folder. Extract it to ~/.claude/skills/ for a personal install or to .claude/skills/ in a project.
- 3Or upload in the Claude apps. Open Settings, go to Capabilities, then Skills, and upload the ZIP.
- 4Read SKILL.md first. Open the file and review the example commands, especially the npx other-tool line.
- 5Check your requirements. Confirm whether you have lark-cli and Lark credentials if you plan to run the Lark commands.
- 6Test in a safe setting. Run commands only with a test account and placeholder-safe values, never against sensitive data.
What is an agent skill and what does lark-demo do?
An agent skill is a folder containing a SKILL.md file. The file has a short header with a name and description, followed by instructions or reference text that an AI agent can read when it is relevant.
The lark-demo skill is a test fixture. Its description is only "Demo skill". Its body is one code block with sample commands for the lark-cli tool: fetching a Lark document and listing chat messages. It also includes an unrelated npx command. The file does not define a workflow or say when the agent should use these commands.
Install the lark-demo skill
Download the ZIP of the skill from this page. Then use one of the following methods.
For Claude Code, unzip the download into ~/.claude/skills/ for a personal install, or into .claude/skills/ inside a project folder for a project-only install.
In the Claude apps, open Settings, go to Capabilities, then Skills, and upload the ZIP.
- Personal: ~/.claude/skills/lark-demo/SKILL.md
- Project: .claude/skills/lark-demo/SKILL.md
- Claude apps: Settings → Capabilities → Skills → upload the ZIP
Understand the example commands
The code block in SKILL.md contains three lines of examples. Nothing in the file runs them automatically. An agent would only see them as reference text, and only if it chose to use them.
The first command fetches a Lark document using API version v2. The second lists messages in a chat container, returning 20 per page. The third is npx other-tool, which is unrelated to Lark and is not identified or vetted in the file.
- lark-cli docs +fetch --api-version v2 --doc A3Ijdemo
- lark-cli im messages list --container-id oc_xxx --page-size 20
- npx other-tool (unrelated package; review before running)
# comment
lark-cli docs +fetch --api-version v2 --doc A3Ijdemo
lark-cli im messages list \
--container-id oc_xxx \
--page-size 20
npx other-toolRequirements for the example commands
The file does not state what is needed to run the Lark commands. To run them, you would need the lark-cli command-line tool and a Lark or Feishu account with credentials that can access the document and chat. The file does not explain how to set these up.
The npx line needs Node.js and npx. Because other-tool is not described in the file, you cannot confirm what it does.
- lark-cli, only if you actually run the example commands
- Lark/Feishu account and credentials for document and message access (not stated in the file)
- Node.js and npx, only for the other-tool line
Safety notes before you use it
This skill uses the network. The Lark commands would contact Lark services, and the npx command would download and run a package named other-tool. The file does not run scripts by itself, but any commands you execute from it can.
Review the npx line before you run it. Do not run it on a machine or account that holds sensitive data unless you have verified the package.
- Runs scripts: no, from the file itself
- Uses network: yes
- Check other-tool's source and publisher before executing it
- Use a test Lark account, not one with sensitive chats or documents
Tips for testing and maintaining it
If you maintain a skill scanner or validator, lark-demo is a small input for checking how SKILL.md files are parsed. The header fields, the single code block, and the comment line are all visible test cases.
If you need a skill that helps with Lark documents or messages, this file will not provide it. Write a SKILL.md with a specific description and clear steps for when and how to use the commands.
- Use it to test parsing of YAML front matter and fenced code blocks
- Do not expect the agent to know when to use the commands from this file alone
- Replace placeholder values such as oc_xxx and A3Ijdemo with real IDs if you run the commands yourself
What people use it for
- Testing a skill scanner or validator against a minimal SKILL.md with front matter and a code block
- Checking how the larksuite/cli maintainers' parsers read SKILL.md files
- Using the example lark-cli commands as a reference for the syntax of docs fetch and message listing
Frequently asked questions
Is the lark-demo skill free?
The skill is licensed under MIT, according to the repository listing. The file itself contains no pricing. Lark or Feishu accounts may have their own terms that apply to the commands.
What do I need to install lark-demo?
Download the ZIP from this page and unzip it into ~/.claude/skills/ or a project's .claude/skills/ folder. You can also upload the ZIP in the Claude apps under Settings, Capabilities, then Skills.
What does the lark-demo skill actually do?
It contains a one-line description and example lark-cli commands for fetching a Lark document and listing chat messages. It does not define a workflow, so it does not give the agent real instructions.
Why won't my agent use lark-demo for Lark tasks?
The description is only "Demo skill" and the file gives no guidance on when to use the commands. For real Lark work, you need a skill with a clear description and step-by-step instructions.
Is the npx other-tool command safe to run?
The file does not identify or vet other-tool, so it is not known to be safe. Check the package's source and publisher before running it, and do not run it on a machine with sensitive data.
Is there a better alternative for working with Lark documents and messages?
This file does not name alternatives. Look for a skill or tool that documents its commands, requirements and permissions clearly, and that is maintained for end users rather than scanner testing.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
lark-demo is a test fixture for developers building or maintaining skill scanners and SKILL.md parsers. It is not suitable for everyday users who want help with Lark documents or messages, because it has no real instructions. If you are testing parsers, install it and inspect the file; if you need Lark automation, choose a skill with clear instructions and review any npx command before running it.
Download the skill