Contributor guide
Skill media guide
Add animated thumbnails, GIF previews, and video loops to your skills. They play on hover in the catalog, and a good preview converts browsers into installers.
Quick start
Add a media block to your SKILL.md frontmatter:
--- name: My Skill description: What this skill does. media: thumbnail: https://raw.githubusercontent.com/you/skill/main/assets/preview.png gif: https://raw.githubusercontent.com/you/skill/main/assets/preview.gif alt: "Short description of what the preview shows" ---
Media fields
| Field | Format | Size | Purpose |
|---|---|---|---|
| thumbnail | PNG, JPG, WebP | 500 KB | Static preview + OG image |
| gif | Animated GIF | 3 MB | Hover animation in catalog |
| video | MP4 or WebM | 5 MB | Hover video loop (silent) |
| lottie | Lottie JSON URL | 200 KB | Vector animation |
| alt | Text (125 chars) | n/a | Screen reader description |
Recommended tools
Full guide
The complete media guide with hosting options, FFmpeg commands, and OG image specs is available as a Markdown file for contributors.