Skip to content

GuideGetting Started

Build with AI

Install the Video.js skill and give AI coding agents version-matched docs for building and migrating players

The Video.js skill gives coding agents the context they need to build, customize, debug, and migrate Video.js players. It teaches the agent how Video.js 10 is composed, then points it to documentation that matches the version installed in your project.

AI Quickstart

Paste this prompt into your coding agent:

Install the Video.js skill using one method. In Codex, run `codex plugin marketplace add videojs/skills`, then `codex plugin add videojs@videojs`, and start a new session. In Claude Code, run `claude plugin marketplace add videojs/skills`, then `claude plugin install videojs@videojs`, and start a new session or run `/reload-plugins`. In VS Code or Cursor, install `https://github.com/videojs/skills` as a plugin from source. For another agent, run `npx skills add https://github.com/videojs/skills --skill videojs` and select the agent. Then use the Video.js skill when working on this project.

Video.js Skill

The skill contains guidance and Markdown references. It does not install Video.js, run background services, or connect to an account.

Install the skill

Codex

Add the Video.js plugin marketplace, then install the plugin:

codex plugin marketplace add videojs/skills
codex plugin add videojs@videojs

Start a new Codex session after installation.

Claude Code

Add the Video.js plugin marketplace, then install the plugin:

claude plugin marketplace add videojs/skills
claude plugin install videojs@videojs

Start a new Claude Code session, or run /reload-plugins in the current session. You can invoke the skill directly with /videojs:videojs.

VS Code

Enable chat.plugins.enabled, run Chat: Install Plugin From Source from the Command Palette, and enter:

https://github.com/videojs/skills

Cursor

Open Customize, select Plugins, choose From GitHub Repository, and enter:

https://github.com/videojs/skills

Other coding agents

Use the open skills installer and select your agent when prompted:

npx skills add https://github.com/videojs/skills --skill videojs

Project-local installation is the default. Add -g if you want the skill available in every project.

Use the skill

Ask for the player you want to build or the problem you want to solve. For example:

Add an HLS player with captions and a quality menu to the product page using Video.js.

Play this Mux playback ID in our Next.js app with Video.js, with Mux Data turned on.

Migrate this Video.js 8 embed to Video.js 10 in React.

The skill checks your framework and installation method before choosing player, skin, and media code. It also checks imports and playback setup against current documentation before handing the work back.

How the skill finds current docs

The skill uses documentation in this order:

  1. Installed package docs. node_modules/@videojs/react/docs/llms.txt and node_modules/@videojs/html/docs/llms.txt index the docs shipped with each package version. These files work offline and match the code in your project.
  2. Live docs. If Video.js is not installed yet, or the project uses the CDN, the skill reads the framework index on videojs.org and opens only the pages needed for the task.
  3. Installed types. If the docs are unavailable, the skill checks package exports and TypeScript declarations instead of guessing version-specific APIs.

This order matters because most model training data describes Video.js 8. Video.js 10 has a different component model, package structure, and installation flow.

Troubleshoot

If your agent does not use the skill, start a new session or reload plugins, then ask it to use the Video.js skill explicitly. If it writes videojs(), data-setup, registerPlugin, or other Video.js 8 APIs, ask it to read the installed llms.txt before changing code.

Report problems with the skill in the videojs/skills repository. Report package and documentation problems in videojs/v10.

Use the docs

You can still provide documentation directly when a tool cannot install skills.

Copy one page

Each docs page has a Copy page menu. Copy the Markdown, open the .md version, or send the page to ChatGPT or Claude.

Open a Markdown URL

Add .md to any docs URL. For this page, use:

https://videojs.org/docs/framework/html/guides/build-with-ai.md

Each docs page also advertises its Markdown URL as an alternate format so compatible tools can discover it.

Request Markdown

Request the normal docs URL with an Accept: text/markdown header:

curl -H "Accept: text/markdown" \
  https://videojs.org/docs/framework/html/guides/build-with-ai

Start from llms.txt

videojs.org/docs/framework/html/llms.txt lists every HTML guide and reference page with a short description. Give the index to your tool, then load only the pages the task needs.

The llms-full.txt files contain the complete documentation corpus. Use them only when your tool requires one file because they are larger than most useful task contexts.

Guides