lark-event

Stream Lark and Feishu real-time events as structured NDJSON.

195|12|Updated Jul 19, 2026
One-click install
npx skills add https://github.com/ZJU-REAL/HugAgentOS --skill lark-event-zju-real
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-event
Source: https://github.com/ZJU-REAL/HugAgentOS/tree/main/src/backend/plugin_bundles/marketplace/feishu-cli/skills/lark-event
Command: npx skills add https://github.com/ZJU-REAL/HugAgentOS --skill lark-event-zju-real

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies reliable real-time consumption of Lark and Feishu events, eliminating the need to build custom subscription, filtering, lifecycle, and shutdown handling for event-driven bots.

Core Features & Use Cases

  • Event Discovery: List available event keys and inspect their schemas, parameters, field paths, and decoded field semantics.
  • Bounded or Continuous Consumption: Stream events as NDJSON with maximum-event and timeout limits, readiness signaling, graceful shutdown, and exit-status handling.
  • Filtering and Projection: Use jq expressions to filter messages, project fields, process interactive cards, and distinguish flat from versioned event envelopes.
  • Use Case: Build a Feishu bot that listens for incoming group messages, extracts sender and message content, and processes interactive cards without incorrectly parsing ordinary text as JSON.

Quick Start

Use the lark-event skill to discover the appropriate Lark event key, inspect its schema, and consume a bounded stream of incoming events as a bot.

Frequently Asked Questions about lark-event

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

FAQPage Schema
How do I stream and process Feishu events in real time?

You can stream Feishu events in real time by using the lark-event skill to consume structured NDJSON streams, enabling event-driven automation for bots and message processors without building custom subscription handlers.

How do I filter Lark messages and extract specific fields using jq?

To filter Lark messages and extract fields, apply schema-guided jq expressions to the NDJSON event stream, allowing you to project specific field paths and process interactive cards while distinguishing flat from versioned event envelopes.

Can I run a bounded Lark event subscription with a timeout and graceful shutdown?

Yes, you can run a bounded Lark event subscription by configuring maximum-event and timeout limits, which supports readiness signaling, graceful shutdown, and proper exit-status handling for long-running subscribers.

How can I prevent a Feishu bot from incorrectly parsing ordinary text as JSON cards?

To prevent incorrectly parsing ordinary text as JSON, use schema-guided event discovery and jq filtering to distinguish interactive card events from standard flat messages, ensuring accurate content extraction for your Feishu bot.

Do I need the lark-cli command-line tool to consume Lark webhook events?

Yes, consuming Lark webhook events and processing real-time event streams requires the lark-cli command-line tool, which manages subprocess lifecycle and bounded execution for your automation workflows.