lark-okr

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

8|2|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/luojiaaoo/xpeech --skill lark-okr-luojiaaoo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lark-okr
Source: https://github.com/luojiaaoo/xpeech/tree/main/xpeech/agent/skills/buildin/lark-skills/lark-okr
Command: npx skills add https://github.com/luojiaaoo/xpeech --skill lark-okr-luojiaaoo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing OKRs in Feishu (Lark) through the web UI is slow and hard to automate. This Skill lets an AI agent view, create, and update OKR cycles, objectives, key results, alignments, quantitative indicators, and progress records directly through lark-cli commands. ## Core Features & Use Cases - Full OKR lifecycle management: List user cycles, view cycle details, create single or batched Objectives and Key Results, and patch content, notes, scores, and deadlines. - Progress and indicator tracking: Update quantitative indicator values, create/update/delete progress records with rich text and images, and manage objective alignment relationships. - Use Case: Ask the agent to "set my Q3 objective to improve user satisfaction with KRs for NPS and retention" and it will look up your current cycle, batch-create the Objective and KRs, and later update progress percentages as you report them. ## Quick Start Ask the agent to show my current OKR cycle and list all my objectives and key results.

Frequently Asked Questions about lark-okr

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

FAQPage Schema
How do I create OKR objectives and key results in Feishu from the command line?▼

Use lark-cli okr +create for a single objective or KR, or +batch-create to create multiple objectives with their KRs in one call. You first need the cycle ID from lark-cli okr +cycle-list, then pass content as JSON.

How do I update OKR progress or completion percentage in Lark?▼

Use lark-cli okr +indicator-update with the objective or key result ID and the new numeric value for quantitative progress. For text-based updates, use +progress-create to add a progress record, optionally with a percent and status.

What is the difference between OKR score and progress in Feishu?▼

Score is a 0-1 rating with at most one decimal, changed only via +patch --score when explicitly requested. Progress or completion refers to quantitative indicator values or progress records, updated with +indicator-update or +progress-create.

Does lark-cli OKR support rich text and images in progress records?▼

Yes. Use --style richtext with ContentBlock JSON for formatted paragraphs, mentions, and document links. Images require uploading first with +upload-image to get a file_token, then referencing it in a gallery block.

Why does updating an OKR score return error 1001001 invalid parameters?▼

This happens when the tenant has disabled the objective or key result scoring feature or manual score calculation. Retry the patch without the --score parameter and confirm with the user whether scoring is enabled.

What tasks are 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.