ReddRadar
Agent skill
feishu-openapi-dev
Expert guidance for Feishu (飞书) / Lark OpenAPI Python development. Build Feishu applications, robots, handle event subscriptions, card callbacks, and API integrations. Use when working with Feishu SDK, lark-oapi, building Feishu bots, or mentioning 飞书 development.
Install this agent skill to your Project
npx add-skill https://github.com/StrayDragon/my-claude-skills/tree/main/feishu-openapi-dev
SKILL.md
Feishu OpenAPI Python Development Expert
Expert guidance for Feishu (飞书) / Lark Open Platform Python development, covering API calls, event handling, robot development, and more.
📚 Source Documentation
This skill includes three official/community source repositories (managed via git submodule):
1. oapi-sdk-python (Official SDK)
Path: source/oapi-sdk-python/
Official Feishu Python SDK providing complete type system and semantic programming interface.
Core Directories:
lark_oapi/- SDK core codesamples/- Official sample codedoc/- Documentation resources
Main Features:
- Server-side API calls
- Event subscription handling
- Card callback processing
- Automatic access_token management
- Data encryption/decryption and signature verification
2. oapi-sdk-python-compact (Convenience Wrapper)
Path: source/oapi-sdk-python-compact/
Enhanced wrapper based on official SDK, providing convenient shortcut functions.
Core Directories:
src/lark_oapi_compact/shortcut/- High-level convenience APIssheets/- 电子表格 (Spreadsheet) operationsdriver/- 云文档/云空间 (Drive) operationsgroup_robot/- 群机器人 (Group robot) messagingmessage/- Message handlingcompact/- Core configuration
tests/- Test cases
Configuration Guide: See CLAUDE.md for development setup instructions.
3. lark-samples (Official Examples)
Path: source/lark-samples/
Official Feishu sample code collection with complete scenario-based implementations.
Example Projects:
robot_quick_start/- Quick start robot developmentweb_app_with_jssdk/- 网页应用 (Web app) developmentweb_app_with_auth/- Web app with authenticationecho_bot/- Echo bot (multi-language)card_interaction_bot/- Card interaction botmcp_larkbot_demo/- MCP intelligent Agentmcp_quick_demo/- MCP quick start
Quick Start
Installation
pip install lark-oapi
# Or use the enhanced version
pip install lark-oapi-compact
Basic Configuration
import lark_oapi as lark
# Create client
client = lark.Client.builder() \
.app_id("your_app_id") \
.app_secret("your_app_secret") \
.build()
Environment Variables
Development and testing require these environment variables:
FEISHU_APP_ID- Application ID (应用 ID)FEISHU_APP_SECRET- Application Secret (应用密钥)FEISHU_GROUP_ROBOT_WEBHOOK_URL- Group robot Webhook (optional)
Usage Guide
Finding API Usage
- Basic API calls: Check
source/oapi-sdk-python/samples/ - Convenience wrappers: Check
source/oapi-sdk-python-compact/src/lark_oapi_compact/shortcut/ - Complete scenarios: Check corresponding example projects in
source/lark-samples/
Recommended Development Workflow
- Identify your scenario (机器人/robot, 网页应用/web app, API call)
- Find similar examples in
lark-samples - Use
oapi-sdk-pythonfor API calls - For complex scenarios, use
oapi-sdk-python-compactshortcut functions
Updating Source
# Update all submodules
cd source
git submodule update --remote
# Update single repository
cd source/oapi-sdk-python
git pull origin v2_main
Official Resources
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
StrayDragon/my-claude-skills
mermaid-expert
Expert guidance for Mermaid.js diagramming library. Create flowcharts, sequence diagrams, class diagrams, state diagrams, Gantt charts, git graphs, and block diagrams. Use when working with Mermaid syntax, creating diagrams, or visualizing complex concepts and workflows.
StrayDragon/my-claude-skills
python-expert-tester
Expert guidance for Python testing that analyzes your existing setup and provides evidence-based recommendations. I'll examine your current tests, configurations, and dependencies before suggesting changes. Use when writing tests, improving coverage, debugging issues, or optimizing testing setup.
StrayDragon/my-claude-skills
langgraph-python-expert
Expert guidance for LangGraph Python library. Build stateful, multi-actor applications with LLMs using nodes, edges, and state management. Use when working with LangGraph, building agent workflows, state machines, or complex multi-step LLM applications. Requires langgraph, langchain-core packages.
StrayDragon/my-claude-skills
ui-ux-pro-max
UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 8 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient.
StrayDragon/my-claude-skills
vercel-react-best-practices
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.
StrayDragon/my-claude-skills
python-log-expert
Expert guidance for Python logging libraries including structlog, standard logging, and log analysis. Use when working with Python logs, troubleshooting logging issues, implementing logging best practices, or analyzing structlog source code implementation. Includes complete structlog source code in source/structlog/ for deep implementation analysis. Requires structlog package.
Didn't find tool you were looking for?