lark-okr

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

Updated May 22, 2026
One-click install
npx skills add https://github.com/CalWade/aigc-creator --skill lark-okr-calwade
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lark-okr
Source: https://github.com/CalWade/aigc-creator/tree/main/.agents/skills/lark-okr
Command: npx skills add https://github.com/CalWade/aigc-creator --skill lark-okr-calwade

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Managing OKRs in Lark (Feishu) through the web UI is slow for bulk or programmatic workflows. This Skill lets you view and edit OKR cycles, objectives, key results, alignments, quantitative indicators, and progress records directly through the lark-cli command line. ## Core Features & Use Cases - Cycle and Objective Management: List a user's OKR cycles with time-range filters, then fetch all objectives and key results within a cycle, including scores, weights, and deadlines. - Progress Tracking: Create, read, update, and delete progress records on objectives or key results, with percent and status (normal/overdue/done), plus image uploads for rich-text progress content. - Alignment and Indicators: Create and query objective alignment relationships, update objective/key result positions and weights, and patch quantitative indicators with custom units. - Use Case: Ask the assistant to show your current-cycle OKRs, then post a progress update with 80% completion and a screenshot to a specific key result. ## Quick Start Ask the assistant to list my current OKR cycle and show all objectives and key results with their progress.

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 cycles in Lark from the command line?▼

Run lark-cli okr +cycle-list with your user ID, optionally adding --time-range in YYYY-MM--YYYY-MM format to filter periods. The command returns cycle IDs, start and end times, and cycle status for each period.

How do I create an OKR progress record with lark-cli?▼

Use lark-cli okr +progress-create with --content in ContentBlock JSON format, --target-id for the objective or key result ID, and --target-type. You can also set --progress-percent and --progress-status to record completion.

What is the ContentBlock format used in Lark OKR content fields?▼

ContentBlock is a rich-text JSON structure used in objective, key result, and progress content fields. It supports paragraphs with styled text runs, lists, document links, user mentions, and image galleries for progress records.

Can I upload images to Lark OKR progress records?▼

Yes, use lark-cli okr +upload-image with a relative file path, target ID, and target type. The returned file_token is then embedded in a ContentBlock gallery element when creating or updating the progress record.

Why does updating OKR objective weights fail with a parameter error?▼

The cycles.objectives_weight API requires updating all objectives in the cycle at once, and all weight values must sum to exactly 1. Partial updates or weights that do not total 1 are rejected by parameter validation.

What permission scopes does the Lark OKR API require?▼

Read operations need scopes like okr:okr.content:readonly or okr:okr.period:readonly, while writes require okr:okr.content:writeonly. Progress operations use okr:okr.progress scopes, and image upload requires okr:okr.progress.file:upload.