Agent skill

Video Optimization

by kostja94 in kostja94/marketing-skills

When the user wants to optimize videos for Google Search, video sitemap, VideoObject schema, or video SEO on websites.

MITAuto-check passedMarketing & SEO

Install Video Optimization

skills CLI
$ npx skills add kostja94/marketing-skills --skill video-optimization -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install kostja94/marketing-skills video-optimization --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/kostja94/marketing-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo/on-page/video-optimization .claude/skills/video-optimization && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
video-optimization
GitHub stars
1k
Token cost
~2.4k tokens
SKILL.md length
984 words
Files
1
Skills in repo
102
Repo updated
First seen
Licence
MIT

At a glance

When the user wants to optimize videos for Google Search, video sitemap, VideoObject schema, or video SEO on websites.

  • Works in 9 steps: Discovery & Indexing → Stable URLs → Thumbnail & Metadata → …
  • Wants to optimize videos for Google Search
  • SKILL.md covers Scope, YouTube in Google Search (2025+), Initial Assessment and 1. Discovery & Indexing, plus 10 more sections
  • Reaches youtube.com and sitemaps.org

What it does

Video Optimization is an agent skill from kostja94/marketing-skills. 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.

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering Web search. It works with YouTube. The repository describes itself as: Agent Skills for Marketing — SEO, Social, Influencer & More. 160+ open-source skills for SEO, content, 40+ page types, paid ads, channels, and strategies. Add project context… The licence is MIT.

When your agent uses it

  • Wants to optimize videos for Google Search
  • VideoObject schema
  • Video SEO on websites
  • The user mentions video SEO

Example prompts

  • “video SEO,”
  • “video sitemap,”
  • “VideoObject,”
  • “/video-optimization”

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Discovery & Indexing
  2. Stable URLs
  3. Thumbnail & Metadata
  4. VideoObject Schema
  5. Video Features
  6. Allow Google to Fetch Video File
  7. Third-Party Embeds (YouTube, Vimeo)
  8. Removal & Restrictions
  9. SafeSearch & Monitoring

What it can do on your machine

Read from SKILL.md and the folder at commit 8dd89c5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are xml and json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • youtube.com
    • sitemaps.org
    • google.com
    • schema.org

    Also links to:

    • developers.google.com
    • semrush.com
    • searchengineland.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Video Optimization loads about 2.4k tokens when it runs. Until then it costs about 95 tokens; SKILL.md has 984 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~95
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from kostja94/marketing-skills at commit 8dd89c5, republished under its MIT licence (© kostja94). 984 words, ~2,409 tokens.

Download SKILL.mdSave it as .claude/skills/video-optimization/SKILL.md (or your agent's skills folder).
name
video-optimization
description
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.
metadata.version
1.0.1

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

ContextImplication
AI OverviewsYouTube citations surged 25.21% since Jan 2025; instructional (+35.6%), visual demos (+32.5%); long-form dominates (94%)
GEOYouTube + Reddit = ~78% of social media citations; Perplexity (38.7%) and Google AI Overviews (36.6%) drive most YouTube citations
StrategyEmbed YouTube on site pages for dual indexing; or host on YouTube for GEO citation. See youtube-seo, generative-engine-optimization

Initial Assessment

Project context: Read root contextus.md when present and load only the modules relevant to this task. Without Contextus, use available project material or user-provided facts and ask for missing information; do not create a parallel context system.

Identify:

  1. Hosting: Self-hosted vs YouTube/Vimeo embed
  2. Page type: Dedicated watch page vs supplementary (e.g. blog with embedded video)
  3. 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.

DoDon'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
<?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 contentUrl in VideoObject
  • Player URL: Stable for embedUrl / player_loc

3. Thumbnail & Metadata

Thumbnail Sources (in priority order)
SourceHow
<video> posterposter attribute
Video sitemap<video:thumbnail_loc>
VideoObjectthumbnailUrl
OGPog:video:image

Use same thumbnail URL across all metadata sources.

Show full SKILL.md (383 more words)Show less
Thumbnail Specs
SpecRequirement
FormatsBMP, GIF, JPEG, PNG, WebP, SVG, AVIF
SizeMin 60×30 px; larger preferred
Transparency≥80% of pixels with alpha >250
AccessMust 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

json
{
  "@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)
MethodUse
ClipExact start/end + label per segment; all languages
SeekToActionTell Google where timestamps live in URL; auto-detect; supported languages: en, es, pt, it, zh, fr, ja, de, tr, ko, nl, ru
YouTubeTimestamps 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 set expires in schema / <video:expiration_date> in sitemap
  • Geo-restrict: regionsAllowed or ineligibleRegion in 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

ContextPriorityNotes
Website videoVideoObject, sitemap, thumbnailThis skill
YouTubeTitle, description, chapters, thumbnailSee youtube-seo
GEO / AI citationYouTube distribution; long-formSee generative-engine-optimization
Featured Snippet (video)Video schema; timestampsSee featured-snippet

  • 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

© kostja94, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/seo/on-page/video-optimization of kostja94/marketing-skills.

Open the folder on GitHubat commit 8dd89c5

Compare with similar skills

Video Optimization next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Video Optimization compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Video Optimization this skillkostja94/marketing-skills1k—~2.4kAutomated safety check: PassMIT
Performance Media Buyergrowthack88/growth-marketing-os115—~1.5kAutomated safety check: PassMIT
Blog StrategyInfrasity-Labs/dev-gtm-claude-skills139—~3.8kAutomated safety check: PassMIT
Agent ReachPanniantong/Agent-Reach93k1 repos~1.4kAutomated safety check: PassMIT
Ray Trend Searchimraywang/rayskills160—~2.1kAutomated safety check: PassCustom licence
Agent ReachEdisonChenAI/agent-reach1061 repos~1.3kAutomated safety check: PassMIT

Similar skills

  • Performance Media Buyer

    growthack88/growth-marketing-os

    Full-stack paid media skill. An agent skill from growthack88/growth-marketing-os.

    115 GitHub stars~1.5k tokensUpdated 6 days ago
    Marketing & SEOAuto-check passed
  • Blog Strategy

    Infrasity-Labs/dev-gtm-claude-skills

    Blog strategy development including topic cluster architecture with hub-and-spoke design, audience mapping, competitive landscape analysis, AI citation surface strategy across ChatGPT/Perplexity/AI…

    139 GitHub stars~3.8k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • Agent Reach

    Panniantong/Agent-Reach

    Routes web research and platform lookups across 16 sites, including Twitter, Reddit, YouTube, Bilibili, Xiaohongshu and GitHub, through one command-line tool.

    93k GitHub starsUsed in 1 repo~1.4k tokens
    Productivity & AutomationAuto-check passed
  • Ray Trend Search

    imraywang/rayskills

    Researches what people are saying about a topic over a recent window across X, Reddit, YouTube and the public web, reporting each source's status with links.

    160 GitHub stars~2.1k tokensUpdated 15 days ago
    Research & ScienceAuto-check passed
  • Agent Reach

    EdisonChenAI/agent-reach

    Use the internet: search, read, and interact with 13+ platforms including Twitter/X, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu (小红书), Douyin (抖音), WeChat Articles (微信公众号), LinkedIn, Boss直聘…

    106 GitHub starsUsed in 1 repo~1.3k tokens
    Productivity & AutomationAuto-check passed
  • SEO Coach

    petera2c/simple-table

    Enter a friendly OpenSEO coach mode that explains workflows, recommends next steps, and helps users use agents, web search, scraping, and MCP data effectively.

    229 GitHub starsUsed in 3 repos~1.2k tokens
    Marketing & SEOAuto-check passed

More from kostja94/marketing-skills

All 102 skills in this repo
  • Grokipedia Recommendations

    kostja94/marketing-skills

    When the user wants to add recommendations, links, or content to Grokipedia.

    1k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • AI Traffic Tracking

    kostja94/marketing-skills

    When the user wants to track AI search traffic in GA4 or GSC.

    1k GitHub stars~959 tokensUpdated 2 days ago
    Auto-check passed
  • Analytics Tracking

    kostja94/marketing-skills

    When the user wants to set up, audit, or optimize analytics tracking (GA4, events, conversions).

    1k GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • Brand Visual Generator

    kostja94/marketing-skills

    When the user wants to define, audit, or apply visual identity (typography, colors, spacing, design tokens, frontend aesthetics).

    1k GitHub stars~3k tokensUpdated 2 days ago
    Auto-check passed
  • Canonical Tag

    kostja94/marketing-skills

    When the user wants to configure canonical URLs, fix duplicate content, or consolidate URL signals.

    1k GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed
  • Content Strategy

    kostja94/marketing-skills

    When the user wants to plan content for SEO, create content calendar, or build topic clusters.

    1k GitHub stars~1.8k tokensUpdated 2 days ago
    Auto-check passed

Works with

Questions about Video Optimization

What does Video Optimization do?

When the user wants to optimize videos for Google Search, video sitemap, VideoObject schema, or video SEO on websites. Video Optimization is an agent skill from kostja94/marketing-skills. When the user wants to optimize videos for Google Search, video sitemap, VideoObject schema, or video SEO on websites.

When should I use Video Optimization?

Video Optimization fits situations like: wants to optimize videos for Google Search; videoObject schema; video SEO on websites; the user mentions video SEO.

How do I install Video Optimization in Claude Code?

Run `npx skills add kostja94/marketing-skills --skill video-optimization -a claude-code`. Or copy the skill folder (skills/seo/on-page/video-optimization in kostja94/marketing-skills) into .claude/skills/video-optimization in your project. Claude Code loads it when a task matches its description.

How do I install Video Optimization in Codex?

Run `npx skills add kostja94/marketing-skills --skill video-optimization -a codex`. Or copy the skill folder (skills/seo/on-page/video-optimization in kostja94/marketing-skills) into .agents/skills/video-optimization in your project. Codex loads it when a task matches its description.

Can I use Video Optimization in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kostja94/marketing-skills --skill video-optimization -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/video-optimization, .gemini/skills/video-optimization, .github/skills/video-optimization and .opencode/skills/video-optimization in your project.

What does Video Optimization need to run?

SKILL.md names no scripts, command-line tools or credentials: Video Optimization is instructions for the agent only.

Does Video Optimization access the network?

SKILL.md names 7 domains. In commands or code: youtube.com, sitemaps.org, google.com and schema.org; the agent is likely to contact these when it follows the instructions. As links in the text: developers.google.com, semrush.com and searchengineland.com. This is read from the text; nothing was executed.

Is Video Optimization safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Video Optimization use?

Video Optimization is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Video Optimization use?

About 2.4k tokens (SKILL.md is roughly 9.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Video Optimization?

Skills that share tags, products or a category with Video Optimization: Performance Media Buyer (growthack88/growth-marketing-os, 115 stars), Blog Strategy (Infrasity-Labs/dev-gtm-claude-skills, 139 stars), Agent Reach (Panniantong/Agent-Reach, 93k stars) and Ray Trend Search (imraywang/rayskills, 160 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Video Optimization?

kostja94 (a GitHub user) maintains it in kostja94/marketing-skills, which has 1,019 GitHub stars. The repository holds 102 skills in this directory. The repository was last updated on October 6, 2026.

Source: kostja94/marketing-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.