Add VideoObject schema to video pages

SkillCloud & infra

This is a video skill for AI agents. It lets an agent audit how pages embed or host video content, including YouTube, Vimeo, and self-hosted video, by working through a front-end video skill checklist. It applies whenever video content is being added to a site or when structured data coverage needs checking.

Available today. Use it from your connected AI after setup.

Have an AI agent set up that can load skills.

Then ask your AI: use the Add VideoObject schema to video pages skill

What your AI can do with it

  • Audit how pages embed YouTube video
  • Audit how pages embed Vimeo video
  • Audit how pages host self-hosted video
  • Check video handling when adding video content to a site
  • Audit structured data coverage for video content

Getting started

  1. Have an AI agent set up that can load skills.
  2. Add the video skill to the agent's available skills.
  3. Point the agent at a page or site that embeds or hosts video.
  4. Ask the agent to audit the video embedding or structured data coverage using the skill's checklist.

What this skill tells your AI

The instructions your AI receives, as published by thedaviddias/front-end-checklist in skills/video/SKILL.md and read by ahel’s review.

Pages with valid VideoObject schema are eligible for video-specific rich results and carousels in Google Search — a visibility advantage that pages without schema cannot access.

Quick Reference

  • Add VideoObject JSON-LD schema to every page with embedded video content
  • Required properties: name, description, thumbnailUrl, uploadDate
  • Recommended: contentUrl (direct video file) or embedUrl (iframe embed URL)
  • Valid VideoObject schema can earn video carousels and rich results in Google Search and Google Discover

Check

Find pages with embedded <video> elements, YouTube iframes, or Vimeo players. Check for a <script type='application/ld+json'> block containing "@type": "VideoObject". Verify required properties are present: name, description, thumbnailUrl, uploadDate. Run through Google's Rich Results Test.

Fix

Add a VideoObject JSON-LD block to each page with video. Populate name (video title), description (video description), thumbnailUrl (absolute URL to thumbnail image), uploadDate (ISO 8601 format), and either contentUrl or embedUrl. Validate with the Rich Results Test.

Explain

Explain how VideoObject schema enables video-specific rich results, which properties are required vs. recommended by Google, and the difference between contentUrl (direct file) and embedUrl (embed iframe URL).

Code Review

Review metadata generation, rendered HTML, structured data, and response headers related to Add VideoObject schema to video pages. Flag exact routes or templates where search-facing output violates the rule, and describe how to verify the final page output.


For full implementation details, code examples, and framework-specific guidance, see references/rule.md.

Rule page: https://frontendchecklist.io/en/rules/seo/video

Signals

GitHub stars
74k
Forks
7k
Last commit
Aug 2026
Hacker News mentions
20

Questions

When should this skill be used?
Use it when a task applies to any page embedding or hosting video content (YouTube, Vimeo, self-hosted), when adding video content to a site, or when auditing structured data coverage.
What kinds of video does it cover?
It covers pages that embed or host video through YouTube, Vimeo, or self-hosted video.
What does the audit actually check?
It works through a front-end video skill checklist to review how pages embed or host video content.
Advanced
Item type
skill
Key
video-thedaviddias
Source
github.com/thedaviddias/front-end-checklist