calendar (v4)

calendar (v4) Skill for Happycapy Skills Platform

What Is This

The calendar (v4) skill, identified as lark-calendar, is a robust integration for the Happycapy Skills platform that enables comprehensive management of Lark (Feishu) calendar events, schedules, and meeting invitations via API. This skill provides a suite of tools designed to help users view, search, create, update, and manage calendar events and meetings efficiently, all through automation and API-driven workflows. It is especially suited for users who require advanced scheduling capabilities, such as checking participant availability, sending out meeting invitations, managing RSVPs, and suggesting optimal meeting times.

The skill is implemented as a CLI extension (lark-cli calendar) and leverages a set of shortcuts for high-frequency operations such as agenda overview, event creation, free/busy queries, RSVP responses, and time slot suggestions.

Why Use It

Modern teams rely on tight, automated scheduling to coordinate meetings, manage busy calendars, and optimize productivity. The calendar (v4) skill is essential for organizations or individuals who:

• Need to automate the creation and management of calendar events within Lark/Feishu.
• Require accurate, context-aware scheduling that considers participant availability.
• Want to provide intelligent assistant-like decision support, rather than rigid form submission.
• Value error minimization in scheduling by enforcing strict rules for date, time, and participant handling.
• Need to integrate these capabilities into broader workflow automations, bots, or assistant frameworks.

By using this skill, you streamline the scheduling process and reduce the cognitive load on users, while ensuring that calendar operations are executed consistently, securely, and in compliance with best practices.

How to Use It

Prerequisites

• Install lark-cli and ensure it is accessible in your environment.
• Read and understand the shared authentication and permissions documentation located in ../lark-shared/SKILL.md before beginning any integration or automation.
• For each shortcut or operation, consult its documentation using the Read tool before execution. Never invoke shortcuts blindly.

Core Operations

1. View or Search Calendar Events

To view your agenda or search for events, use the +agenda shortcut:

lark-cli calendar +agenda

This provides a quick overview of today's or upcoming schedules.

2. Create a Calendar Event

To create a new event, use the +create shortcut. The system will intelligently infer default values for title, participants, and duration based on the current context:

lark-cli calendar +create --title "Design Review" --participants "user1,user2" --start "2024-07-01T10:00:00+08:00" --duration 60

If participants are ambiguous (e.g., multiple users match the name), the skill will prompt for disambiguation and remember your choice for future automation.

3. Check Free/Busy Status

To check the availability of participants before proposing a meeting time:

lark-cli calendar +freebusy --participants "user1,user2" --start "2024-07-01T10:00:00+08:00" --end "2024-07-01T11:00:00+08:00"

Events where a participant has already declined (RSVP: declined) are treated as free for that participant.

4. Respond to Invitations (RSVP)

To reply to a meeting invitation:

lark-cli calendar +rsvp --event-id "event_123" --response "accept"

5. Suggest Meeting Times

For scenarios where a specific time is not set, use the suggestion feature:

lark-cli calendar +suggestion --participants "user1,user2" --duration 30

This will recommend several candidate time slots based on everyone's availability.

Additional Notes

• For all operations, Monday is considered the first day of the week and Sunday the last. Date calculations (e.g., "next Monday") must strictly follow this convention.
• When referencing days like "tomorrow" or "today", the skill defaults to the entire day, not just working hours.
• You cannot schedule events entirely in the past, except for those currently spanning the present moment.
• Meeting room reservations are only supported if a room ID is already present in the context and starts with omm_.

When to Use It

Use the calendar (v4) skill whenever you need to:

• Automate Lark/Feishu calendar management within bots or workflow engines.
• Build assistant features that help users schedule, modify, or review meetings intelligently.
• Minimize the risk of double-booking or missed scheduling due to manual errors.
• Require context-aware, rule-driven scheduling that adapts to ambiguous or incomplete user input.

It is particularly valuable for design teams, project managers, and anyone coordinating meetings across busy schedules and multiple participants.

Important Notes

• Always consult the latest shared documentation on authentication and permissions before integrating or invoking the skill.
• Never execute a shortcut without first reading its specific documentation via the Read tool.
• Default behaviors (such as event titles, participant lists, and durations) are contextually inferred but can be overridden with explicit parameters.
• The skill is designed to provide decision support, not to make autonomous decisions or act as a simple form processor.
• Strictly observe all time and date conventions to ensure accurate scheduling and compliance with organizational standards.

For more details and source code, visit the official repository.