skills.rest
ykai55
ykai55COMMUNITY
Explore all skills by this author →
GitHub

lark-shared

Configures and troubleshoots Feishu/Lark CLI authentication for user and bot identities.

Updated Sep 4, 2025
Search Tags:#authentication#feishu#scopes#lark-cli#oauth login#permission denied#identity switching
One-click install
npx skills add https://github.com/ykai55/dotfiles --skill lark-shared-ykai55
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lark-shared
Source: https://github.com/ykai55/dotfiles/tree/main/opencode/skills/lark-shared
Command: npx skills add https://github.com/ykai55/dotfiles --skill lark-shared-ykai55

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you set up and operate Feishu/Lark CLI safely when you need first-time configuration, interactive OAuth-style login, identity switching between user and bot, and scope/permission error resolution.

Core Features & Use Cases

  • First-time configuration: Guides the initialization flow by launching the config process and obtaining the authorization link for the user.
  • Authentication and identity switching: Explains how to use user vs bot identities via the as parameter, including when bot cannot access user resources.
  • Permission denied recovery with scopes: Provides a structured response to permission violations, using console links and recommended login scope/domain steps while preventing unsafe actions like running auth login for bot.

Quick Start

Ask the AI to perform first-time setup and then help you handle any permission_violations by recommending the exact auth login strategy for the current identity (user or bot).

Frequently Asked Questions about lark-shared

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

FAQPage Schema
How do I configure Lark CLI for first-time setup and get an OAuth login link?▼

To configure Lark CLI for first-time setup, you launch the initialization process to generate the configuration file and obtain an interactive OAuth authorization link for secure login.

Why does my Feishu bot authentication fail with permission_violations when accessing user resources?▼

Feishu bot authentication fails with permission_violations because bots and users have separated identity semantics, requiring correct scope management and specific authorization strategies to access restricted resources.

How to switch between user and bot identity in Lark CLI using the as parameter?▼

To switch identity in Lark CLI, you use the as parameter to toggle between user and bot authentication, ensuring the selected identity has the correct scopes for the target Feishu resources.

What is the best way to resolve permission denied errors during Feishu CLI operations?▼

The best way to resolve permission denied errors is to follow structured troubleshooting using console_url hints to apply recommended login scope and domain steps for the current identity.

When do I need to run auth login for bot identity in Lark CLI?▼

You should never run auth login for bot identity in Lark CLI, as bots use distinct authentication rules and attempting interactive login for them is an unsafe action that causes errors.

Related Skills

Explore More Software Engineering Skills→
benjaminshafiibenjaminshafii
10

bitwarden

Configure Bitwarden CLI with API key authentication to retrieve vault credentials.

Community
Intermediate
chenguojun06-starchenguojun06-star
1

lark-sheets

Create, edit, search, and export Feishu spreadsheet data via lark-cli.

Community
Advanced
SpaceZephyrSpaceZephyr
14

lark-shared

Initialize Lark CLI configuration and authenticate user or bot identities.

Community
Intermediate
eatbreadseatbreads
1

lark-shared

Manage Lark CLI configuration, authentication, and identity switching for user and bot scopes.

Community
Intermediate