minutes (v1)

minutes (v1) for Happycapy Skills Platform

What Is This Skill?

The minutes (v1) skill, identified as lark-minutes, is a command-line interface (CLI) utility for retrieving foundational metadata about a Lark "Minutes" () meeting record. It is designed to extract and return essential information such as the meeting title, cover image URL, duration, owner ID, and the canonical URL of the minutes itself. This skill operates as an interface layer atop the Lark CLI, specifically targeting the minutes.get method, and is focused exclusively on providing core metadata rather than detailed meeting content or AI-generated notes.

• Skill ID: lark-minutes
• Category: design
• Source: lark-minutes on GitHub

Why Use the minutes (v1) Skill?

In collaborative environments, managing and referencing meeting records efficiently is vital. The minutes (v1) skill is purpose-built for scenarios where you need to programmatically fetch just the core metadata of a meeting capture without retrieving the full transcript, AI summary, or action items. This enables seamless integration with dashboards, automated reporting tools, or workflow orchestrators where only the high-level meeting context is required.

Key benefits include:

• Simplicity: Focuses solely on extracting core metadata, reducing unnecessary data transfer and processing overhead.
• Speed: Fast retrieval of critical meeting information for UI previews, notifications, or indexers.
• Integration: Easily scriptable and embeddable within broader CLI-driven or automated workflows.

How to Use minutes (v1)

Prerequisites

• You must have the Lark CLI installed and properly authenticated, as this skill delegates authentication, permissions, and configuration to the shared Lark CLI infrastructure.
• Before using this skill, you must familiarize yourself with the authentication and permission requirements outlined in the lark-shared SKILL.md.

Extracting the minute_token

The primary input parameter for this skill is the minute_token, which uniquely identifies a Lark Minutes record. You can extract the token from a standard Minutes URL. For example, given the following URL:

https://domain.feishu.cn/minutes/obc123456?project=xxx

The minute_token is obc123456 (the terminal path segment of the URL, excluding any query parameters).

Fetching Minutes Metadata

To fetch the core metadata for a given Minutes record, use the following CLI command:

lark-cli minutes minutes get --params '{"minute_token": "obcn***************"}'

Replace obcn*************** with your actual minute_token.

Example Output Structure

The command returns a JSON payload with fields such as:

• title: The meeting title
• cover: URL of the video or audio cover image
• duration: Duration in milliseconds
• owner_id: Owner or creator's identifier
• url: Canonical link to the Minutes record

{
  "title": "Project Kickoff",
  "cover": "https://assets.feishu.cn/cover/obcn***************",
  "duration": 5400000,
  "owner_id": "ou_abcdef123456",
  "url": "https://domain.feishu.cn/minutes/obcn***************"
}

Accessing Associated AI Artifacts

This skill does not provide access to the full meeting content, transcript, AI-generated summary, or action items. If you need those details, you should use the lark-cli vc +notes command as follows:

lark-cli vc +notes --minute-tokens obcn***************

This separation of concerns ensures that minutes (v1) remains focused on metadata retrieval, while other skills handle deeper content extraction.

When to Use minutes (v1)

The minutes (v1) skill is best used in scenarios such as:

• Previewing Meeting Records: When displaying a summary list of meetings, you can show titles, durations, and cover images without preloading full content.
• Automated Workflows: Use in scripts or bots that need to reference or index meetings but do not require the entire transcript or AI summary.
• Link Generation: When generating links or shareable references to specific meetings based on their metadata.
• Metadata Validation: Quickly verify the existence and key properties of a meeting before performing further actions.

It is not suitable for use cases where the full meeting content, AI summary, or granular action items are needed. For those, use the appropriate content retrieval skills.

Important Notes

• Authentication Required: All operations rely on the Lark CLI's authentication mechanisms. Ensure that your credentials are set up and permissions granted before invoking this skill.
• Token Extraction: Always correctly extract the minute_token from the Minutes URL. It is the final path segment, not including query parameters.
• Scope Limitation: This skill does not return transcripts, summaries, or action items. It is strictly for metadata.
• Error Handling: If an invalid or expired token is used, the CLI will return an error. Always validate tokens before use.
• Inter-skill Integration: For workflows requiring both metadata and content, orchestrate calls between minutes (v1) and vc +notes as needed.
• Usage Help: For more command options, refer to the CLI help command:

lark-cli minutes --help

This will display additional flags and usage scenarios relevant to the skill.

The minutes (v1) skill is an essential component for lightweight, high-performance meeting metadata retrieval in the Lark ecosystem, designed for integration with broader automation and reporting systems. Use it for fast, precise access to meeting properties whenever full content is not required.