lark-okr

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

3|2|Updated Jul 21, 2026
One-click install
npx skills add https://github.com/zlsbksdxl/codex-lark --skill lark-okr-zlsbksdxl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-okr
Source: https://github.com/zlsbksdxl/codex-lark/tree/main/plugins/feishu2codex/skills/lark-okr
Command: npx skills add https://github.com/zlsbksdxl/codex-lark --skill lark-okr-zlsbksdxl

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, alignments, quantitative indicators, and progress records directly through structured lark-cli commands. ## Core Features & Use Cases - Cycle and Objective Management: List OKR cycles, fetch full cycle details with objectives and key results, and batch-create objectives with KRs in one command. - Progress Tracking: Create, update, list, and delete progress records with rich text content, progress percentages, and image uploads. - Alignment and Weighting: Create and delete objective alignment relationships, reorder objectives/KRs, and adjust weights with automatic normalization. - Use Case: Ask the assistant to "show my current OKR cycle and add a progress record of 80% to my first key result" — it will resolve your user ID, find the active cycle, and post the progress update. ## Quick Start Ask the assistant to list my 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 view my OKR objectives and key results in Feishu?

Use lark-cli okr +cycle-list with your user ID to find OKR cycles, then run +cycle-detail with the cycle ID to list all objectives and key results. The skill resolves the current user's ID automatically when you ask about your own OKRs.

How to create OKR progress records via command line?

Run lark-cli okr +progress-create with the target objective or key result ID, content in simple or richtext style, and an optional progress percentage. You can also update or delete records with +progress-update and +progress-delete.

Can I batch create multiple OKR objectives and key results at once?

Yes, the +batch-create shortcut accepts a JSON array of objectives, each with nested key results, and creates them all in a specified cycle. It supports mentions, file-based input, and dry-run preview before execution.

Does lark-okr support updating OKR progress percentages or scores?

Yes, use +indicator-update to set an objective or KR's current indicator value, or +patch to update scores between 0 and 1. Note that score updates may fail with error 1001001 if the tenant has disabled the scoring feature.

What is the difference between simple and richtext styles in OKR content?

Simple style uses SemiPlainContent, a plain-text JSON with text and mention fields suitable for most cases. Richtext style uses the full ContentBlock format, required when you need images, document links, or precise formatting control.

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

Todo task management belongs to lark-task, calendar and meeting scheduling belongs to lark-calendar, and performance evaluation requires lark-openapi-explorer for native API access. This skill only covers OKR cycles, objectives, key results, alignments, indicators, and progress records.