video-optimization
Skill0 starsChanged 3 months agoMITView on GitHub
When the user wants to optimize videos for Google Search, video sitemap, VideoObject schema, or video SEO on websites. Also use when the user mentions "video SEO," "video sitemap," "VideoObject," "video thumbnail," "video indexing," "video preview," "key moments," "Clip schema," or "embedded video optimization." For page template, use article-page-generator.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- gaznilmuzammil12-prog/seo-skills-by-gaznilword for word, first seen Nov 16, 2026
Other versions1 project uses a version of this.
Word for word · 1
- gaznilmuzammil12-prog/seo-skills-by-gaznil★ 0100% same
Edited · 0
None found.
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository85 other files it gives its agents.
- AGENTS.mdAGENTS.md
- docs/llms-full.txtllms.txt
- docs/llms.txtllms.txt
- llms-full.txtllms.txt
- llms.txtllms.txt
- ab-testingSkill
- accessibilitySkill
- ai-seoSkill
- analyticsSkill
- attributionSkill
- blog-analyzeSkill
- blog-audioSkill
- blog-auditSkill
- blog-brandSkill
- blog-briefSkill
- blog-calendarSkill
- blog-cannibalizationSkill
- blog-chartSkill
- blog-clusterSkill
- blog-discourseSkill
- blog-factcheckSkill
- blog-flowSkill
- blog-geoSkill
- blog-googleSkill
- blog-imageSkill
- blog-locale-auditSkill
- blog-localizeSkill
- blog-multilingualSkill
- blog-notebooklmSkill
- blog-outlineSkill
- blog-personaSkill
- blog-repurposeSkill
- blog-rewriteSkill
- blog-schemaSkill
- blog-seo-checkSkill
- blogSkill
- blog-strategySkill
- blog-taxonomySkill
- blog-translateSkill
- blog-writeSkill
- canonical-tagSkill
- competitorsSkill
- content-optimizationSkill
- content-strategySkill
- copywritingSkill
- core-web-vitalsSkill
- croSkill
- directory-submissionsSkill
- eeat-signalsSkill
- entity-seoSkill
- featured-snippetSkill
- google-search-consoleSkill
- heading-structureSkill
- indexingSkill
- indexnowSkill
- internal-linksSkill
- keyword-researchSkill
- local-seoSkill
- meta-descriptionSkill
- mobile-friendlySkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 3 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 34
Check for project context first: If .claude/project-context.md or .cursor/project-context.md exists, read it for brand and page context.
- Distinctive: line 54
JavaScript injection: If video is injected via JS, ensure it appears in rendered HTML.
- Distinctive: line 82
Watch page: must be indexed and perform well in search
- Distinctive: line 112
Use same thumbnail URL across all metadata sources.
- Very specific: line 166
Use BroadcastEvent schema for live streams to show "LIVE" in results.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
SEO On-Page: Video Optimization
Guides video optimization for Google Search (main results, video mode, Google Images, Discover), video sitemap, VideoObject schema, and indexing. Note: Google now prioritizes YouTube video results in search; YouTube + Reddit comprise ~78% of social media citations in AI Overviews. For YouTube-specific optimization, see youtube-seo; for GEO distribution via YouTube, see generative-engine-optimization. References: Google Video SEO, Semrush YouTube SEO.
When invoking: On first use, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.
Scope
- Discovery & indexing: HTML embed elements, video sitemap
- Metadata: Title, description, thumbnail; stable URLs
- Structured data: VideoObject schema
- Features: Video preview, key moments (Clip, SeekToAction), LIVE badge
- YouTube prioritization: Google favors YouTube in search; embed or host on YouTube for GEO citation
YouTube in Google Search (2025+)
Google prioritizes YouTube video results across search. YouTube receives 48.6B monthly visits (second to Google.com) and is treated as core search infrastructure for AI-driven discovery. Search Engine Land
| Context | Implication |
| AI Overviews | YouTube citations surged 25.21% since Jan 2025; instructional (+35.6%), visual demos (+32.5%); long-form dominates (94%) |
| GEO | YouTube + Reddit = ~78% of social media citations; Perplexity (38.7%) and Google AI Overviews (36.6%) drive most YouTube citations |
| Strategy | Embed YouTube on site pages for dual indexing; or host on YouTube for GEO citation. See youtube-seo, generative-engine-optimization |
Initial Assessment
Check for project context first: If .claude/project-context.md or .cursor/project-context.md exists, read it for brand and page context.
Identify:
- Hosting: Self-hosted vs YouTube/Vimeo embed
- Page type: Dedicated watch page vs supplementary (e.g. blog with embedded video)
- Features needed: Preview, key moments, LIVE badge
1. Discovery & Indexing
Use Standard HTML Embed Elements
Google finds videos in <video>, <embed>, <iframe>, or <object>. Do not use fragment identifiers to load video; avoid requiring user interaction (click, swipe) to load.
| Do | Don't |
<video><source src="...mp4"/></video> | Fragment-only load; JS-injected without fallback |
<iframe src="https://youtube.com/embed/..."> | Hide video behind paywall without paywall structured data |
JavaScript injection: If video is injected via JS, ensure it appears in rendered HTML; use URL Inspection in Search Console. If using Media Source API, inject HTML video container even when API fails so Google can find metadata.
Video Sitemap
Submit a video sitemap to help Google discover videos. Use <video:video> extension; <loc> = watch page URL.
Structure (from Google):
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
xmlns:video="http://www.google.com/schemas/sitemap-video/1.1">
<url>
<loc>https://example.com/videos/watch-page.html</loc>
<video:video>
<video:thumbnail_loc>https://example.com/thumbs/123.jpg</video:thumbnail_loc>
<video:title>Grilling steaks for summer</video:title>
<video:description>Bob shows you how to grill steaks perfectly.</video:description>
<video:player_loc>https://example.com/player?video=123</video:player_loc>
</video:video>
</url>
</urlset>See xml-sitemap for sitemap index. Video sitemap is an extension; can be standalone or combined.
Indexing Requirements
- Watch page must be indexed and perform well in search
- Video embedded on watch page; not hidden behind elements
- Thumbnail: Valid, stable URL; ≥60×30 px; ≥80% alpha >250 (no heavy transparency)
- Supported formats: 3GP, 3G2, ASF, AVI, DivX, M2V, M3U, M3U8, M4V, MKV, MOV, MP4, MPEG, OGV, WebM, WMV, etc. Data URLs not supported.
Dedicated Watch Page
For video features (main results, video mode, key moments, LIVE badge), create a dedicated watch page per video—page whose primary purpose is to display that video. Examples: video landing page, episode player page, news video page. Not watch pages: blog with embedded video, product page with 360° video, category page with multiple videos.
2. Stable URLs
- Thumbnail: Stable URL; CDNs with fast-expiring URLs can prevent indexing
- Content URL: Stable for video preview and key moments; use
contentUrlin VideoObject - Player URL: Stable for
embedUrl/player_loc
3. Thumbnail & Metadata
Thumbnail Sources (in priority order)
| Source | How |
<video> poster | poster attribute |
| Video sitemap | <video:thumbnail_loc> |
| VideoObject | thumbnailUrl |
| OGP | og:video:image |
Use same thumbnail URL across all metadata sources.
Thumbnail Specs
| Spec | Requirement |
| Formats | BMP, GIF, JPEG, PNG, WebP, SVG, AVIF |
| Size | Min 60×30 px; larger preferred |
| Transparency | ≥80% of pixels with alpha >250 |
| Access | Must be crawlable (no robots.txt block, no login) |
Unique Metadata per Video
Provide unique thumbnailUrl, name, and description for each video in structured data and sitemap. Consistency with visible content is required.
4. VideoObject Schema
{
"@context": "https://schema.org",
"@type": "VideoObject",
"name": "Grilling steaks for summer",
"description": "Bob shows you how to grill steaks perfectly every time.",
"thumbnailUrl": "https://example.com/thumbs/123.jpg",
"uploadDate": "2025-01-15T08:00:00Z",
"contentUrl": "https://example.com/video/123.mp4",
"embedUrl": "https://example.com/player?video=123"
}Required for rich results: thumbnailUrl, name, description. Add contentUrl for video preview and key moments. See schema-markup for full VideoObject; serp-features for Video SERP feature.
5. Video Features
Video Preview
Google selects short clips as dynamic previews. Allow Google to fetch video file; use max-video-preview robots meta to limit duration.
Key Moments (Chapters)
| Method | Use |
| Clip | Exact start/end + label per segment; all languages |
| SeekToAction | Tell Google where timestamps live in URL; auto-detect; supported languages: en, es, pt, it, zh, fr, ja, de, tr, ko, nl, ru |
| YouTube | Timestamps in description; see youtube-seo |
Disable key moments: nosnippet meta.
LIVE Badge
Use BroadcastEvent schema for live streams to show "LIVE" in results.
6. Allow Google to Fetch Video File
For video preview and key moments, Google must fetch the actual video bytes. Do not block contentUrl with noindex or robots.txt. Use stable URLs; ensure both watch page host and video/CDN host have sufficient capacity for crawling.
7. Third-Party Embeds (YouTube, Vimeo)
Google may index both your page and the platform's page. For your watch page: still add VideoObject and optionally video sitemap. For more features (preview, key moments), confirm the platform allows Google to fetch video files.
8. Removal & Restrictions
- Remove: 404 on watch page, or
noindex; or setexpiresin schema /<video:expiration_date>in sitemap - Geo-restrict:
regionsAllowedorineligibleRegionin VideoObject;<video:restriction>in sitemap
9. SafeSearch & Monitoring
- Mark pages appropriately for SafeSearch if content is adult. See Google SafeSearch.
- Search Console: Video indexing report; Video rich results report; Performance filtered by "Video" search appearance.
Specs by Context
| Context | Priority | Notes |
| Website video | VideoObject, sitemap, thumbnail | This skill |
| YouTube | Title, description, chapters, thumbnail | See youtube-seo |
| GEO / AI citation | YouTube distribution; long-form | See generative-engine-optimization |
| Featured Snippet (video) | Video schema; timestamps | See featured-snippet |
Related Skills
- youtube-seo: YouTube titles, descriptions, thumbnails, chapters
- schema-markup: VideoObject, BroadcastEvent; rich results
- serp-features: Video SERP feature; rich results
- featured-snippet: Video snippet format
- xml-sitemap: Video sitemap extension
- google-search-console: Video indexing report; Video rich results
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

