lark-okr

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

Updated May 28, 2026
One-click install
npx skills add https://github.com/changfengpro/agent-skills --skill lark-okr-changfengpro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-okr
Source: https://github.com/changfengpro/agent-skills/tree/main/skills/lark-okr
Command: npx skills add https://github.com/changfengpro/agent-skills --skill lark-okr-changfengpro

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 and hard to automate. This Skill lets you view, create, and update OKR cycles, objectives, key results, quantitative indicators, alignment relationships, and progress records directly through lark-cli commands. ## Core Features & Use Cases - View and navigate OKRs: List a user's OKR cycles, drill into cycle details with all objectives and key results, and inspect quantitative indicators and progress records. - Create and edit OKRs: Batch-create objectives with key results, add single objectives or KRs, and patch content, notes, scores, deadlines, order, and weights. - Track progress: Update numeric indicator values, write text progress records with optional percent and status, and upload images for rich-text progress entries. - Manage alignments: Query, create, and delete objective-to-objective alignment relationships. - Use Case: Ask the assistant to "show my current OKRs and update the KR 'user satisfaction' progress to 75%" — it will fetch your user ID, find the active cycle, locate the KR, and update its indicator value. ## Quick Start Ask the assistant to show my current OKR cycle and all its 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 view my OKRs in Feishu using the command line?

Use lark-cli okr +cycle-list with your user ID to list OKR cycles, then run lark-cli okr +cycle-detail with the cycle ID to see all objectives and key results. Get your own user ID first via lark-cli contact +get-user.

How do I create OKR objectives and key results in bulk?

Use lark-cli okr +batch-create with a cycle ID and a JSON input array where each objective includes its text and a krs list. For a single objective or one KR under an existing objective, use lark-cli okr +create instead.

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

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

Can I update an OKR indicator's unit or target value?

The +indicator-update shortcut only changes the current value. To modify unit, target_value, or start_value, query the indicator with objective.indicators list or key_result.indicators list, then use the native indicators patch API.

Why does updating an OKR score return error 1001001?

Error 1001001 (invalid parameters) can occur when the tenant has disabled the score feature or manual score calculation for objectives or key results. Retry without the --score parameter and confirm the tenant settings with the user.

What tasks are outside the scope of the lark-okr skill?

It does not handle to-do task management (use lark-task), calendar or meeting scheduling (use lark-calendar), or performance reviews (use lark-openapi-explorer to find native APIs). It focuses solely on OKR cycles, objectives, key results, indicators, progress, and alignments.