Skills

Introduction
Tencent Effects SDK Skills is a structured guidance resource package designed for SDK integration scenarios, covering core capabilities such as beauty enhancement, filters, animated stickers, portrait segmentation, and 3D effects. By directly injecting domain-specific SDK knowledge into the context of AI coding assistants, it translates natural language requirements into standardized, executable steps, enabling developers to efficiently integrate the SDK across Android, iOS, and Flutter platforms.
Advantages
Advantages
Description
Multi-platform Coverage
Supports Android, iOS, and Flutter.
Flexible integration options
Supports both manual API-based integration and the official TEBeautyKit panel approach to meet diverse business needs.
Seamless audio/video integration
Deeply integrated with TRTC and Live Streaming SDKs.
Standardized workflows
Includes built-in, reusable processes for license authentication, resource downloading, and lifecycle management.
Zero runtime dependencies
Uses purely static assets; introduces no additional runtime overhead.
One-stop scripting
Includes built-in scripts for the automatic downloading of panel JSON configurations and asset packages; the agent can proactively handle resource preparation for the user.
Prerequisites
Before use, please ensure that your AI programming tool supports the Skills feature. Currently supported tools include:
CodeBuddy
Trae
Cursor
Codex
Claude Code
Claude Desktop
Installation Method
The Skills resource package contains Skills for three platforms (iOS, Android, and Flutter); you can import one or more of them as required by your project.
1. Click to download tencent-effect-skills.zip.
2. Extract the package to obtain three Skill directories:tencent-effect-ios/、tencent-effect-android/、tencent-effect-flutter/.
3. Copy the required Skill directory（e.g. tencent-effect-ios/、tencent-effect-android/、tencent-effect-flutter/）to the directory where the corresponding AI coding tool stores its Skills.
Usage Examples
The following are example descriptions of four typical integration scenarios, applicable to all platforms (Android, iOS, and Flutter):
Scenario 1: Integrating only the SDK (pure API/manual approach)
"Please help me integrate the Tencent Effects SDK into my project; I do not need the beauty panel UI, as I will handle the video frame processing myself."
The Agent guides you through the processes of license authentication, SDK dependency configuration, core API initialization, and manual video frame processing.
Scenario 2: Integrating TEBeautyKit (with the official panel)
"Integrate the Tencent Effects SDK and the official beauty panel UI."
The Agent utilizes the TEBeautyKit workflow to configure panel dependencies, automatically download panel JSON resources and package assets, and provide the complete code for panel initialization and beauty parameter callbacks.
Scenario 3: Integrating TEBeautyKit + TRTC
"Integrate TEBeautyKit into your project and use it with TRTC to enable real-time audio and video beautification."
The Agent utilizes the Adapter approach to handle TRTC video processing callback registration, bind the panel to the Adapter, synchronize the beauty effect toggle state, and manage rotation orientation adaptation.
Scenario 4: Integrating TEBeautyKit with Live Streaming
"Integrate TEBeautyKit and the live streaming SDK to enable beauty effects during stream broadcasting."
The Agent guides you through registering video processing callbacks for the live streaming SDK and configuring the integration between TEBeautyKit and the live streaming push module, while also highlighting the correct order for lifecycle management and license authentication.
Trigger keywords
The AI ​​Agent will automatically activate this Skill when your query contains the following keywords:
Key Business Terms: XMagic、XmagicApi、TEBeautyKit、TELicenseCheck、TencentEffectApi、TencentEffect.
Platform / Class Name Keywords:
Android：XmagicApi、TEBeautyTRTCAdapter、TEPanelView、TEUIConfig、TEPanelViewCallback、TEBeautyKit.EffectState
iOS：XMagic、TEBeautyKit、TELicenseCheck、TRTCVideoFrameDelegate、V2TXLivePusherObserver、YTProcessInput、YTProcessOutput、TRTCAdapter、TELiveAdapter
Flutter：tencent_effect_flutter、TencentEffectApi、XmagicProcesserFactory、TEBeautyPanelView、TEResConfig
SDK Package / Dependency Keywords:TencentEffect_S1-07、TencentEffect_S1、TencentEffect_A1、pod TencentEffect_、pod TEBeautyKit、te_sub_spec
Skills Content Structure
Android
iOS
Flutter
tencent-effect-android/
   ├── SKILL.md                              # Android Skills main file
   ├── examples/
   │   ├── standalone/                       # Standalone camera example
   │   ├── trtc/                             # TRTC example
   │   └── mlvb/                             # Live streaming SDK example
   ├── references/
   │   ├── 00-overview.md                    # Suite selection & License application
   │   ├── 01-license.md                     # License initialization
   │   ├── 02-api-xmagicapi.md               # XmagicApi core API
   │   ├── 10-standalone.md                  # Standalone camera integration
   │   ├── 11-with-trtc.md                   # TRTC integration (Adapter + manual)
   │   ├── 12-with-mlvb.md                   # Live streaming SDK integration
   │   ├── 13-beauty-panel-assets.md         # Panel resource handling
   │   ├── 14-suite-resources.md             # Suite resources handling
   │   ├── 20-atomic-abilities.md            # Atomic abilities (segmentation/landmark)
   │   ├── 21-advanced-mode.md               # Performance tuning & advanced mode
   │   └── 30-faq-troubleshooting.md         # FAQ & troubleshooting
   └── snippets/
       ├── license-init.kt                   # License initialization
       ├── resource-copy.kt                  # Resource copy to sandbox
       ├── lifecycle.kt                      # Lifecycle management
       ├── gradle-deps.txt                   # Gradle dependencies & permissions
       ├── fetch-beauty-panel.sh             # Panel JSON download script
       └── fetch-suite-resources.sh          # Suite resources download script
tencent-effect-ios/
   ├── SKILL.md                              # iOS Skills main file
   ├── examples/
   │   │   ├── standalone.md                 # Standalone camera example
   │   ├── trtc.md                           # TRTC integration example
   │   └── mlvb.md                           # Live streaming SDK integration example
   ├── references/
   │   ├── 00-overview.md                    # Environment requirements, suite selection, Pod dependencies
   │   ├── 01-license.md                     # License authentication
   │   ├── 02-api-xmagic.md                  # Pure XMagic API reference
   │   ├── 03-tebeautykit.md                 # TEBeautyKit system reference
   │   ├── 10-standalone.md                  # Standalone camera integration guide
   │   ├── 11-with-trtc.md                   # TRTC integration guide
   │   ├── 12-with-mlvb.md                   # Live streaming SDK integration guide
   │   └── 30-faq-troubleshooting.md         # FAQ & troubleshooting
   └── snippets/
       ├── license-init.m                    # License authentication snippet
       ├── resource-bundle.m                 # Resource bundle configuration
       ├── lifecycle.m                       # Lifecycle management
       ├── podfile.txt                       # Podfile dependency example
       ├── fetch-beauty-panel.sh             # Panel JSON resources download script
       └── fetch-adapter.sh                  # Adapter library download script
tencent-effect-flutter/
   ├── SKILL.md                              # Flutter Skills main file
   ├── examples/
   │   ├── trtc/                             # trtc_cloud example
   │   ├── tencent-rtc-sdk/                  # tencent_rtc_sdk example
   │   └── live/                             # live_flutter_plugin example
   ├── references/
   │   ├── 00-overview.md                    # Suite selection + Flutter plugin setup
   │   ├── 01-license.md                     # License authentication (Dart layer)
   │   ├── 02-api-tencenteffectapi.md        # TencentEffectApi full API
   │   ├── 11-with-trtc-cloud.md             # tencent_trtc_cloud integration
   │   ├── 11b-with-tencent-rtc-sdk.md       # tencent_rtc_sdk integration
   │   ├── 12-with-live-flutter-plugin.md    # live_flutter_plugin integration
   │   ├── 13-beauty-panel-assets.md         # Panel resource handling
   │   ├── 14-suite-resources.md             # Suite resources handling
   │   └── 30-faq-troubleshooting.md         # FAQ & troubleshooting
   └── snippets/
       ├── license-init.dart                 # License initialization (Dart)
       ├── init-flow.dart                    # Full initialization flow
       ├── native-register-beauty-factory.md # Native layer BeautyFactory registration
       ├── lifecycle.dart                    # Lifecycle management
       ├── pubspec.yaml.txt                  # pubspec.yaml key dependencies
       ├── fetch-beauty-panel.sh             # Panel resources download script
       └── fetch-suite-resources.sh          # Suite resources download script
﻿
Advantages	Description
Multi-platform Coverage	Supports Android, iOS, and Flutter.
Flexible integration options	Supports both manual API-based integration and the official TEBeautyKit panel approach to meet diverse business needs.
Seamless audio/video integration	Deeply integrated with TRTC and Live Streaming SDKs.
Standardized workflows	Includes built-in, reusable processes for license authentication, resource downloading, and lifecycle management.
Zero runtime dependencies	Uses purely static assets; introduces no additional runtime overhead.
One-stop scripting	Includes built-in scripts for the automatic downloading of panel JSON configurations and asset packages; the agent can proactively handle resource preparation for the user.