Skip to content

Add AI skill to prepare docs for a new major version of THEOplayer - #787

Open
MattiasBuelens wants to merge 3 commits into
mainfrom
prepare-major-version-skill
Open

Add AI skill to prepare docs for a new major version of THEOplayer#787
MattiasBuelens wants to merge 3 commits into
mainfrom
prepare-major-version-skill

Conversation

@MattiasBuelens

Copy link
Copy Markdown
Collaborator

Summary

  • Adds .agents/skills/ as the home for project-specific AI agent skills (following the Agent Skills standard), with a README describing the format
  • Adds a prepare-major-version skill: a step-by-step playbook for preparing the documentation for a new THEOplayer major version (snapshot the current docs into theoplayer_versioned_docs/version-v<OLD>, prepare /theoplayer for v)

The playbook is distilled from the commit history of the previous version bumps (#576 for v11, #407 for v10), including the gotchas discovered there:

  • Delete the copied assets/, external/ and static/ directories before committing the snapshot
  • Make the current version config entry conditional so production builds don't fail while v is the last version
  • Keep the same number of ../ segments when rewriting theoplayer_versioned_docs/ links inside the versioned docs
  • Only copy the examples/ subfolder of static/theoplayer/v<OLD>/
  • Only point changelog links at /theoplayer/v<OLD>/... migration guides after the release flips lastVersion back to current

Test plan

  • Validated with a full dry run preparing a hypothetical v12 in a git worktree: all steps executed as one commit each, and npm run build (PR mode) passed with no broken links

Generated with Devin

MattiasBuelens and others added 2 commits July 30, 2026 17:41
Sets up the repository to support the Agent Skills standard so team
members can add shared SKILL.md workflows for AI coding tools.

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Playbook distilled from the version-bump PRs #576 (v11) and #407 (v10), validated with a test run preparing v12.

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@MattiasBuelens
MattiasBuelens requested a review from a team as a code owner July 30, 2026 17:25
@MattiasBuelens MattiasBuelens changed the title Add AI skill to prepare docs for a new major version Add AI skill to prepare docs for a new major version of THEOplayer Jul 30, 2026
Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant