feishu-setup
This Claude Code skill automates the creation and configuration of a Feishu (Lark) bot application on the Feishu Open Platform by running a full-setup script in the sandbox that handles application creation, permission configuration, event subscription, and publishing. Use this skill when a user requests Feishu bot setup, needs to configure Lark credentials, or requires integration of a Feishu IM application, requiring only QR code authentication from the user.
git clone --depth 1 https://github.com/AgentTeam-TaichuAI/ScienceClaw /tmp/feishu-setup && cp -r /tmp/feishu-setup/ScienceClaw/backend/builtin_skills/feishu-setup ~/.claude/skills/feishu-setupSKILL.md
# Feishu Auto Setup
Automate the creation and configuration of a Feishu (Lark) bot application on the Feishu Open Platform. The user only needs to scan a QR code to log in; all other steps are handled automatically by the one-shot script `feishu_full_setup.py` running in the sandbox.
## Prerequisites
- The sandbox container must be running (provides the built-in browser via MCP).
- The backend service must be reachable from the sandbox at `http://backend:8000`.
## Execution
该 skill 只支持使用总控脚本 `feishu_full_setup.py` 一次性完成全部流程，不再支持单独执行 `feishu_auto_setup.py`。
```bash
python3 /builtin-skills/feishu-setup/scripts/feishu_full_setup.py --name "ScienceClaw 助手"
```
使用 agent 的 `execute` 工具执行上面的总控命令时，必须显式设置 `timeout=900`。不要使用 `timeout=300`，因为飞书页面自动化、扫码等待、权限导入和事件配置可能持续数分钟。
**注意**：总控脚本执行时间较长。若执行过程中遇到超时或失败，不要再单独执行 `feishu_auto_setup.py` 的任一步骤，否则会打乱 `feishu_full_setup.py` 的页面状态与执行顺序。如果检测到执行失败，则等待 3 分钟后退出。如果已经完成到第 7 步骤，可以视为成功。
脚本会自动完成以下步骤：
- 打开飞书开放平台并等待扫码登录
- 创建应用、添加机器人、首次发布
- 获取 `app_id` / `app_secret`
- 回写系统 `LARK_APP_ID` / `LARK_APP_SECRET` 并建立长连接
- 配置应用身份权限
- 配置用户身份权限
- 配置事件与回调
- 第二次发布
如需跳过某些步骤，可使用：
- `--skip-app-permissions`
- `--skip-user-permissions`
- `--skip-step2-publish`
如需在 workspace 中执行，只复制总控脚本即可：
```bash
cp /builtin-skills/feishu-setup/scripts/feishu_full_setup.py {workspace_dir}/feishu_full_setup.py
python3 {workspace_dir}/feishu_full_setup.py --name "ScienceClaw 助手"
```
总控脚本会在同一条命令执行过程中等待用户扫码登录飞书。
如果 `feishu_full_setup.py` 执行失败，则等待 3 分钟后退出, 如果已经完成到第 7 步骤，可以视为成功。Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.
MANDATORY: When a user asks to install, find, search, or add ANY skill (e.g. 'install hello-world skill', 'find a skill for X', 'add a skill'), you MUST first run `skills find <query>` to search the skills ecosystem. NEVER create a skill from scratch without searching first. Even if the name sounds simple, always search — it may already exist as a published skill.
Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.
Use this skill any time a .pptx file is involved — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading or extracting text from .pptx files; editing or updating existing presentations; combining or splitting slide files; working with templates, layouts, speaker notes, or comments. Trigger whenever the user mentions 'deck', 'slides', 'presentation', or references a .pptx filename. If a .pptx file needs to be opened, created, or touched, use this skill.
Create new skills, modify and improve existing skills, and measure skill performance. MANDATORY: Use this skill whenever the user wants to create a custom skill from scratch, design a workflow as a skill, write their own SKILL.md, update or optimize an existing skill, run evals to test a skill, benchmark skill performance, or asks questions like 'how do I make a skill', 'create a skill for X', 'turn this into a skill', 'I want to build a skill'. Even if the user doesn't use the word 'skill' explicitly, trigger this if they want to capture a reusable workflow or set of instructions for the agent.
Create new tools or upgrade existing tools for the agent. MANDATORY: Use this skill whenever the user wants to create a custom tool, convert a script into a reusable tool, write a new tool function, upgrade or modify an existing tool, test and improve a tool in the sandbox, or asks things like 'make a tool for X', 'create a tool that does Y', 'improve the X tool', 'upgrade my tool', 'turn this script into a tool'. Even if the user doesn't use the word 'tool' explicitly, trigger this if they want to add a new callable capability to the agent or modify an existing one.
Access 1000+ scientific tools through ToolUniverse for drug discovery, protein analysis, genomics, literature search, clinical data, ADMET prediction, molecular docking, and more. Use when the user needs biomedical or scientific research capabilities.
Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like \"the xlsx in my downloads\") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.