lark-okr

Manage Lark OKR cycles, objectives, key results, alignments, and progress records via lark-cli.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lark-cli, and includes references (resource) components.

What problem does it solve? Managing OKRs in Feishu/Lark through the web UI is slow for bulk or scripted operations. This Skill lets you view, create, and update OKR cycles, objectives, key results, alignments, indicators, and progress records directly through the lark-cli command line. ## Core Features & Use Cases - Cycle and Objective Management: List OKR cycles, view full cycle details with objectives and key results, and batch-create objectives with their KRs in one command. - Progress Tracking: Create, update, list, and delete progress records with rich-text ContentBlock content, progress percentages, and image attachments. - Structure Control: Reorder objectives and KRs, adjust weights with automatic normalization, update quantitative indicator values, and manage alignment relationships between objectives. - Use Case: At the start of a quarter, ask the assistant to list your current OKR cycle, batch-create three objectives each with two key results, then post a weekly progress update with a percentage to a specific KR. ## Quick Start Ask the assistant to list my current OKR cycle and show all my objectives and key results using the lark-okr skill.

Frequently Asked Questions about lark-okr

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

FAQPage Schema
How do I list my Lark OKR cycles from the command line?

Run lark-cli okr +cycle-list with the target user's ID, optionally filtering by a time range like 2025-01--2025-06. The command returns cycle IDs, start and end times, and status, which you then pass to +cycle-detail.

How to create OKR objectives and key results in bulk?

Use lark-cli okr +batch-create with a cycle ID and a JSON array of objectives, each containing its key results. The input can be inline JSON, a file via @path, or stdin, and --dry-run previews the API calls.

How do I update OKR progress percentage in Feishu?

Use lark-cli okr +progress-create or +progress-update with --progress-percent and an optional status of normal, overdue, or done. For direct indicator values, use +indicator-update with the objective or key-result level and the new value.

Can I attach images to OKR progress records?

Yes. Upload a local image with lark-cli okr +upload-image using a relative file path, then reference the returned file_token in a ContentBlock gallery element when creating or updating the progress record.

Why does adjusting OKR weights return error 1001001?

Error 1001001 usually means the tenant has not enabled the weight-setting feature for objectives or key results. If your cycle ID, entity IDs, and weight sums are correct, confirm with the tenant admin that OKR weight configuration is enabled.

What is outside the scope of the lark-okr skill?

It does not handle to-do task management, calendar or meeting scheduling, or performance reviews. Use lark-task for tasks, lark-calendar for scheduling, and lark-openapi-explorer for performance-related native APIs.