feishu-perm — Claude Code skill: Feishu permission management
A skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that handles Feishu document and file permissions through one tool, feishu_perm. Triggers when you mention sharing, collaborators, or access rights.
MIT 264 installs ★ 4,217 updated 2026-03-29
npx skills add m1heng/clawdbot-feishu --skill feishu-perm -a claude-codeWhat feishu-perm does
The skill exposes a single tool, feishu_perm, with three actions: list returns current collaborators, add grants access, and remove revokes it. Every call takes a token and a type — docx, sheet, bitable, folder, file, wiki, mindnote, or the legacy doc.
When adding a member you specify the identity type (email, openid, userid, unionid, openchat, or opendepartmentid) and a permission level: view, edit, or full_access. The full_access level lets the member manage permissions themselves.
The tool ships disabled by default; you have to set perm: true under channels.feishu.tools in config. The Feishu API scope drive:permission is also required — without it the tool will not start.
What it helps with
- Add a collaborator to a Feishu document by email with edit rights
- Grant a group chat view-only access to a folder via
openchat - List all collaborators and their permission levels on a file
- Remove a specific user from a
bitableormindnote - Switch a user from
edittofull_accesson a shared sheet
Example prompts for the agent
- Give
[email protected]edit access to documentdoxcnXXX - List all collaborators on the folder with token
fldcnXXX - Remove
[email protected]from documentABC123
How to install feishu-perm
1Skills CLI (Vercel)
npx skills add m1heng/clawdbot-feishu --skill feishu-perm -a claude-code2Manually: put the files in place
~/.claude/skills/feishu-perm/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/feishu-perm/
1Skills CLI (Vercel)
npx skills add m1heng/clawdbot-feishu --skill feishu-perm -a codex2Manually: put the files in place
.agents/skills/feishu-perm/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add m1heng/clawdbot-feishu --skill feishu-perm -a cursor2Manually: put the files in place
.cursor/skills/feishu-perm/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install m1heng/clawdbot-feishu skills/feishu-perm2Manually: put the files in place
.github/skills/feishu-perm/SKILL.md1Skills CLI (Vercel)
npx skills add m1heng/clawdbot-feishu --skill feishu-perm -a gemini-cli2Platform CLI
gemini skills install https://github.com/m1heng/clawdbot-feishu --path skills/feishu-permManually: put the files in place
.devin/skills/feishu-perm/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add m1heng/clawdbot-feishu --skill feishu-perm -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about feishu-perm
How do I install feishu-perm in Claude Code?
Run npx skills add m1heng/clawdbot-feishu --skill feishu-perm -a claude-code; the skill file will be placed at ~/.claude/skills/feishu-perm/SKILL.md.
What does the feishu-perm skill do?
It adds, removes, and lists collaborators on Feishu documents, folders, spreadsheets, wiki nodes, and other file types — all through the feishu_perm tool with a single JSON call.
Why is feishu-perm disabled by default?
Permission changes are sensitive, so the author requires an explicit opt-in: set perm: true under channels.feishu.tools. The Feishu API scope drive:permission must also be granted.
Source text
SKILL.md · MIT
---
name: feishu-perm
description: |
Feishu permission management for documents and files. Activate when user mentions sharing, permissions, collaborators.
---
# Feishu Permission Tool
Single tool `feishu_perm` for managing file/document permissions.
## Actions
### List Collaborators
```json
{ "action": "list", "token": "ABC123", "type": "docx" }
```
Returns: members with member_type, member_id, perm, name.
### Add Collaborator
```json
{ "action": "add", "token": "ABC123", "type": "docx", "member_type": "email", "member_id": "[email protected]", "perm": "edit" }
```
### Remove Collaborator
```json
{ "action": "remove", "token": "ABC123", "type": "docx", "member_type": "email", "member_id": "[email protected]" }
```
## Token Types
| Type | Description |
|------|-------------|
| `doc` | Old format document |
| `docx` | New format document |
| `sheet` | Spreadsheet |
| `bitable` | Multi-dimensional table |
| `folder` | Folder |
| `file` | Uploaded file |
| `wiki` | Wiki node |
| `mindnote` | Mind map |
## Member Types
| Type | Description |
|------|-------------|
| `email` | Email address |
| `openid` | User open_id |
| `userid` | User user_id |
| `unionid` | User union_id |
| `openchat` | Group chat open_id |
| `opendepartmentid` | Department open_id |
## Permission Levels
| Perm | Description |
|------|-------------|
| `view` | View only |
| `edit` | Can edit |
| `full_access` | Full access (can manage permissions) |
## Examples
Share document with email:
```json
{ "action": "add", "token": "doxcnXXX", "type": "docx", "member_type": "email", "member_id": "[email protected]", "perm": "edit" }
```
Share folder with group:
```json
{ "action": "add", "token": "fldcnXXX", "type": "folder", "member_type": "openchat", "member_id": "oc_xxx", "perm": "view" }
```
## Configuration
```yaml
channels:
feishu:
tools:
perm: true # default: false (disabled)
```
**Note:** This tool is disabled by default because permission management is a sensitive operation. Enable explicitly if needed.
## Permissions
Required: `drive:permission`
© m1heng · MIT · m1heng/clawdbot-feishu