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). 提取封面、视频封面、生成封面、缩略图提取、视频缩略图、截取封面。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.9 KB |
SKILL.md
View on GitHub---
name: extracting-thumbnails
description: Extracts 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 |
| Facebook | 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
1. First check: Wait **15 seconds** after submission
2. Subsequent checks: Wait **10 seconds** between polls
3. Call `getThumbnailTaskStatus` to 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 |