lark-minutes

Search, download, upload, and edit Feishu Minutes recordings via lark-cli.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing Feishu Minutes (妙记) manually through the web UI is slow when you need to search recordings, download meeting media, convert local audio/video files into transcripts, or edit AI-generated todos and summaries at scale. ## Core Features & Use Cases - Search & Inspect Minutes: Find minutes by keyword, owner, participant, or time range, and retrieve metadata like title, duration, cover, and URL via minutes get. - Media Download & Upload: Download minute audio/video files (or get 1-day shareable links), and convert local media files into minutes through the drive +uploadminutes +uploadvc +notes pipeline instead of local transcription tools like ffmpeg or whisper. - Edit AI Artifacts: Rename minutes, replace transcript speakers, batch add/update/delete AI todos inside a minute, and replace the full AI summary. - Use Case: A user says "turn this mp3 recording into a transcript with a summary" — the skill uploads the file to Feishu Drive, generates a minute, then fetches the transcript and AI summary via vc +notes. ## Quick Start Ask the assistant to search your Feishu minutes from last week and download the matching recording to a local folder.

Frequently Asked Questions about lark-minutes

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

FAQPage Schema
How do I search Feishu minutes by keyword or date?

Use `lark-cli minutes +search` with `--query`, `--start`/`--end`, `--owner-ids`, or `--participant-ids` filters. At least one filter is required, and results paginate via `page_token` when `has_more` is true.

How to convert a local audio or video file into a Feishu transcript?

Upload the file with `lark-cli drive +upload` to get a file_token, run `lark-cli minutes +upload --file-token` to generate the minute, then extract the minute_token from the returned URL and call `lark-cli vc +notes --minute-tokens` for the transcript and summary.

Can I download the video file of a Feishu minute?

Yes, `lark-cli minutes +download --minute-tokens <token>` saves the media locally, or use `--url-only` for a download link valid for one day. The minute must have finished transcription, and the minutes:minutes.media:export scope is required.

What media formats does minute upload support?

Supported audio formats include wav, mp3, m4a, aac, ogg, wma, and amr; video formats include avi, wmv, mov, mp4, m4v, mpeg, ogg, and flv. Files must be under 6 hours long and 6 GB in size.

Why does speaker replacement in a minute fail?

The `+speaker-replace` command only accepts `ou_` prefixed open_ids, not display names. Resolve names to open_ids via the contact skill first, and ensure the from-user already exists as a speaker in that minute's transcript.

When should I not use this skill for meeting notes?

Do not use it to read transcripts, summaries, or chapters of an existing minute — that belongs to `vc +notes` in the lark-vc skill. Also avoid it for locating notes by natural-language title only, which routes to drive or doc search instead.