lark-attendance

Query personal attendance check-in records via the Lark attendance API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets you retrieve your own Feishu (Lark) attendance check-in records directly from the command line without manually navigating the Lark web or mobile app. ## Core Features & Use Cases - Attendance Record Query: Calls the user_tasks.query API through lark-cli to fetch your personal clock-in and clock-out records. - Automatic Parameter Filling: Automatically injects required parameters (employee_type as "employee_no" and user_ids as an empty array) so you never have to provide them manually. - Schema-First API Calls: Inspects the API parameter structure with lark-cli schema before every call to avoid malformed requests. - Use Case: Ask the assistant to show your check-in times for this week, and it queries the Lark attendance API and returns your punch records. ## Quick Start Ask the assistant to query my Lark attendance check-in records for this month.

Frequently Asked Questions about lark-attendance

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

FAQPage Schema
How do I query my Lark attendance check-in records from the command line?

Use lark-cli with the attendance user_tasks query method after checking the parameter structure via lark-cli schema. The skill automatically fills employee_type as employee_no and user_ids as an empty array, so you only supply date or filter parameters.

What permissions are needed to query Feishu attendance records?

Querying attendance records requires the attendance:task:readonly scope granted to the Lark app used by lark-cli. Without this scope, the user_tasks.query API call will fail with a permission error.

Can I query attendance records for other employees with lark-cli?

This skill is designed to query your own attendance records and always sends user_ids as an empty array. It does not support querying other employees' punch data.

Why does the Lark attendance API call fail with invalid parameters?

Failures usually come from guessing the --data or --params field format. Always run lark-cli schema attendance.user_tasks.query first to inspect the exact expected structure before invoking the API.

What tools are required to use Lark attendance queries?

The lark-cli binary must be installed and authenticated. The skill also depends on the shared lark-shared instructions for authentication and permission handling, which must be read before making any API call.