lark-contact

Search Feishu employees by keyword and retrieve user details via lark-cli contact endpoints.

Updated Sep 4, 2025
One-click install
npx skills add https://github.com/ykai55/dotfiles --skill lark-contact-ykai55
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-contact
Source: https://github.com/ykai55/dotfiles/tree/main/opencode/skills/lark-contact
Command: npx skills add https://github.com/ykai55/dotfiles --skill lark-contact-ykai55

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

When you need to quickly find coworkers and understand their roles inside your organization, manually browsing the Feishu contact directory is slow and often blocks you when you already know part of an identifier like open_id, email, or phone.

Core Features & Use Cases

  • Search employees by keyword: Look up people by name, email, or phone and get results sorted by relevance.
  • Retrieve user details: Get the full profile for the current user or for a specific user by user_id (with selectable user_id_type).
  • Practical scenarios: Use it when you need to provide an assistant with open_id/contacts, look up a colleague, or answer questions about employee information and department-related context.

Quick Start

Ask: lark-cli contact +search-user --query "张三" to find employees matching that keyword.

Frequently Asked Questions about lark-contact

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

FAQPage Schema
What is the best way to find a colleague's open_id from partial information in Feishu?

The best way to find a colleague's open_id is using keyword-based Feishu contact search. By inputting partial information like a name or email fragment, the search returns sorted matches with complete contact fields.

How do I search for Feishu employees by keyword like name or email?

Feishu employee search uses keyword queries like name, email, or phone to find contacts. Results are sorted by relevance and return enriched profile data including open_id and department context.

Can I retrieve a specific Feishu user profile using their open_id?

Yes, you can retrieve Feishu user details for a specific user by providing their user_id. The lookup supports selectable user_id_type parameters to fetch enriched profile data accurately.

What do I need to set up before querying the Feishu contact directory?

Querying Feishu contacts requires authenticated execution via lark-shared and depends on lark-cli contact endpoints. You must configure this environment before performing employee lookups or retrieving profile data.

Does Feishu contact search support pagination for large organizations?

Yes, Feishu contact search supports paginated queries to handle large organizational directories. This allows you to systematically retrieve employee profiles and collect open_id fields across extensive search results.

What is the best way to find a colleague's open_id from partial information in Feishu?

The best way to find a colleague's open_id is using keyword-based Feishu contact search. By inputting partial information like a name or email fragment, the search returns sorted matches with complete contact fields.