# feishu-binding

This skill walks through device flow authorization so your agent can message you on Feishu or Lark. Handy the first time you bind an account.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1400 installs · ★ 29
- Author: starchild
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/feishu-binding/SKILL.md
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/skills/feishu-binding

## What it does

\`feishu-binding` manages the connection between your agent and a Feishu (飞书) or Lark account. Everything runs through one `feishu` tool with four actions: `status` reports the current app state, `connect` starts the device flow and returns a verification link plus a `device_code`, `poll` checks whether the user confirmed, and `disconnect` unbinds the app.

The skill first asks which brand you use. Mainland China means `feishu` on feishu.cn; everywhere else means `lark` on larksuite.com. The domains differ, so picking the wrong brand fails silently or lands you on the wrong login page. The agent then shows a QR code and a link, waits for you to confirm, and only then polls for status — auto-polling just burns API calls. A device flow lasts about 5 minutes, so an `expired` result from `poll` means starting `connect` over.

One user can hold a single Feishu or Lark app at a time. Switching brands means calling `disconnect` first, and that call stops the Feishu/Lark gateway instance, which is why the skill asks you to confirm it. How the QR code gets shown depends on your channel: web replies carry a `file_path` the frontend renders inline, Telegram gets it as a photo, and WeChat only gets the link, since scanning a QR code inside that messenger does not work.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill feishu-binding -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/feishu-binding/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/feishu-binding/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill feishu-binding -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/feishu-binding/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill feishu-binding -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/feishu-binding/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Starchild-ai-agent/official-skills feishu-binding
```

2. **Manually: put the files in place**
- File: `.github/skills/feishu-binding/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill feishu-binding -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Starchild-ai-agent/official-skills --path feishu-binding
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/feishu-binding/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill feishu-binding -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/feishu-binding/SKILL.md

## When to use it
- bind a Feishu account to the agent through device flow
- check whether Feishu or Lark is already connected
- unbind the app before switching brands
- restart binding after a device flow expires
- show the link or QR code in a way the current channel supports

## Example prompts
- Connect Feishu to the agent
- Check the Lark binding status
- Disconnect Feishu, I want to switch to Lark

## Similar
- [feishu-lark](https://affpapa.org/en/nevibecode/skills/feishu-lark.md) — skill · 1600 installs
- [feishu-notify](https://affpapa.org/en/nevibecode/skills/feishu-notify.md) — skill · 489 installs
- [add-feishu](https://affpapa.org/en/nevibecode/skills/add-feishu.md) — skill · 454 installs
- [feishu-drive](https://affpapa.org/en/nevibecode/skills/feishu-drive.md) — skill · 879 installs
- [mcp-lark](https://affpapa.org/en/nevibecode/skills/mcp-lark.md) — skill · 2600 installs
- [lark-event](https://affpapa.org/en/nevibecode/skills/lark-event.md) — skill · 466800 installs

From the same set: [starchild-ai-agent/official-skills](https://affpapa.org/en/nevibecode/by/starchild-ai-agent/official-skills.md) — 18 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md