lark-okr

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

Updated Jun 29, 2026
One-click install
npx skills add https://github.com/trungpr1990-coder/AMI-MAKEUP --skill lark-okr-trungpr1990-coder
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lark-okr
Source: https://github.com/trungpr1990-coder/AMI-MAKEUP/tree/main/.agents/skills/lark-okr
Command: npx skills add https://github.com/trungpr1990-coder/AMI-MAKEUP --skill lark-okr-trungpr1990-coder

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Managing Objectives and Key Results in Feishu/Lark through raw API calls is tedious and error-prone. This Skill wraps the Lark OKR v2 API into high-level shortcuts so you can view, create, and update OKR cycles, objectives, key results, alignments, quantitative indicators, and progress records with simple commands. ## Core Features & Use Cases - Cycle & Objective Management: List OKR cycles by user and time range, retrieve full cycle details with objectives and key results, and batch-create objectives with KRs in one call. - Progress & Indicator Tracking: Create, update, list, and delete progress records with rich text (mentions, images, doc links), and update quantitative indicator values for objectives or key results. - Structure Control: Reorder objectives/KRs, adjust weights with automatic normalization, and manage alignment relationships between objectives. - Use Case: Ask to "show my current OKR cycle and add a progress record of 80% to my first key result" — the Skill resolves your user ID, finds the active cycle, locates the KR, and posts the progress update. ## Quick Start Ask the assistant to list your current OKR cycle and show all objectives and key results in it.

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 OKR objectives and key results in Lark?▼

First run lark-cli okr +cycle-list with your user ID to get cycle IDs, then run lark-cli okr +cycle-detail with the cycle ID to retrieve all objectives and their key results. Output defaults to a simplified plain-text style.

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

Use lark-cli okr +batch-create with a cycle ID and a JSON array describing objectives and their KRs, optionally with user mentions. The command returns the created objective and KR IDs, and supports dry-run preview.

How do I update OKR progress or indicator values?▼

For a quick current-value update, use lark-cli okr +indicator-update with the level, target ID, and new value. For narrative updates, use +progress-create or +progress-update with content and an optional progress percentage and status.

Can I add images or rich text to OKR progress records?▼

Yes. Upload a local image with lark-cli okr +upload-image to get a file_token, then build a richtext ContentBlock with a gallery element and pass it to +progress-create using --style richtext. The simple style does not support images.

Why does updating OKR weights or scores return error 1001001?▼

Error 1001001 occurs when the tenant has disabled the weight or score features for objectives or key results, or disabled manual score calculation. Verify your parameters, then confirm with the tenant admin whether these OKR features are enabled.

What tasks are outside the scope of this 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.