yikart/AiToEarn / project/aitoearn-backend/apps/aitoearn-ai/src/core/agent/skills/extracting-thumbnails
extracting-thumbnails
VerifiedExtracts thumbnails from video URLs. Use when publishing video content that requires a cover image, when the user does not provide a cover/thumbnail, or before publishing to platforms that require cover images (Kwai, Bilibili, YouTube). 提取封面、视频封面、生成封面、缩略图提取、视频缩略图、截取封面。
Thumbnail Extraction
Extracts thumbnails from video URLs for use as cover images.
When to Use
Use this skill when:
- Publishing video content that requires a cover image
- User doesn't provide a cover/thumbnail for video content
- Before publishing to platforms that require cover images (Kwai, Bilibili)
Platform Cover Requirements
| Platform | Cover Required | Notes |
|---|---|---|
| Kwai | Yes | Mandatory for all videos |
| Bilibili | Recommended | Improves click-through rate |
| YouTube | Recommended | Custom thumbnails increase views |
| TikTok | Optional | Auto-generated if not provided |
| Optional | Recommended for better display |
Workflow
Step 1: Check if Thumbnail Needed
Determine if the target platform requires a cover image.
Step 2: Submit Extraction Task
Call createThumbnailTask with video URL.
Step 3: Poll for Results
- First check: Wait 15 seconds after submission
- Subsequent checks: Wait 10 seconds between polls
- Call
getThumbnailTaskStatusto check progress
Step 4: Return Results
On success, return the thumbnail URL for use as coverUrl.
Examples
Example 1: Extract for Publishing
User wants to publish video to Kwai without cover
1. createThumbnailTask:
- url: "https://example.com/video.mp4"
2. Wait 15 seconds
3. Poll getThumbnailTaskStatus until success
4. Use returned thumbnail URL as coverUrl
5. Proceed with createChannelPublishFlow
Example 2: Generate Cover Before Publishing
1. User provides video URL, title, description
2. Check if coverUrl is provided
3. If no coverUrl:
a. createThumbnailTask with videoUrl
b. Poll getThumbnailTaskStatus
c. Use returned thumbnail as coverUrl
4. Proceed with publishing
Task Status Values
| Status | Description |
|---|---|
| pending | Task created, waiting to start |
| processing | Task is actively extracting thumbnail |
| success | Thumbnail extracted successfully |
| failed | Task failed with error |
Important Notes
- Thumbnail extraction typically takes 10-15 seconds
- Always generate thumbnails for platforms that require covers (Kwai)
- Handle failures gracefully - inform user or use platform default
- Generated thumbnails can be used directly as coverUrl in publish tools
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |