Feature: Agent-Readable Docs and Official Skill

[mihar-22]

Summary

Coding agents need faithful, version-aware documentation and a small official workflow layer that explains how Video.js fits together.

Outcome

Agents can discover Video.js, select the right installation path, read documentation that matches the installed version, avoid Video.js 8 APIs, and verify the result.

Scope

• Faithful Markdown exports
• Generated Markdown review
• Alternate Markdown and AI entry points
• Version-matched bundled docs
• Official Video.js skill and plugin
• Skill discovery across docs and READMEs
• Initial immutable skills release

References

• fix(site): improve markdown for agents #2883
• docs(site): document the Video.js agent skill #2888
• feat: add videojs agent skill skills#1
• Feature: Ship the Markdown Docs Tree Inside @videojs/react and @videojs/html Tarballs — AI Coding Agents Read It Locally #1557
• Organize docs llms.txt files by sidebar #1004
• https://app.notion.com/p/3e297a7f89d081868510c0d717e44f8f

[github-actions]

Planning recommendation: this issue is already on Roadmap project #7; retain its GA milestone and relate it to the #2891 Agent-Ready Launch Week umbrella. Treat PRs #2883, #2888, and videojs/skills#1 as its launch inputs; the scope also completes the bundled-docs work from #1557 and the llms.txt navigation work from #1004. Recommend P1 while it gates the GA launch experience. #2893 should validate this work after those inputs land; #2890 is a post-launch, non-blocking follow-up.