# Maintain Vjsc Skin Gaps

> Maintain deferred VJSC parity gaps. Use when work under packages/skins/src adds, closes, or explicitly defers a parity gap.

- Skill: `videojs/maintain-vjsc-skin-gaps` (Agent Skill)
- Install (CLI): `npx skillmds@latest add videojs/maintain-vjsc-skin-gaps`
- Raw SKILL.md: https://api.skillmd.com/api/skills/videojs/maintain-vjsc-skin-gaps/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: videojs (https://skillmd.com/u/videojs)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/videojs/maintain-vjsc-skin-gaps

---


# Track VJSC skin parity

Keep `packages/skins/src/gaps.md` synchronized with observable differences from the previously published skins.

## Triggers

- Discovering missing behavior, markup, selectors, data attributes, tokens, responsive rules, motion, or styles while
  working under `packages/skins/src`.
- Implementing or deliberately deferring a documented parity gap.

Do not use this workflow for documentation-only edits or generated-output changes that do not alter observable skin behavior.

## Workflow

1. Describe the observable published behavior and identify the affected Default or Minimal skin.
2. Inspect the equivalent source component, style rule, and generated HTML and React output. Similar names or classes are not evidence of parity.
3. If the change implements parity, verify all affected targets and CSS or Tailwind outputs, then remove any obsolete gap.
4. Otherwise, add or update one entry in `packages/skins/src/gaps.md` with `Source`, `Gap`, `Affected`, and `Recommendation` fields. Use the PR or commit when known; otherwise cite the relevant source or test.
5. Avoid duplicates. Describe user-visible behavior rather than copying a raw diff, and remove the entry only after implementation and verification.

## Example

Input: Testing shows the previously published skin has RTL control ordering without equivalent source rules.

Output: Add or update this entry in `packages/skins/src/gaps.md`:

```md
## RTL control layout

- Source: `caf179b83` / #2281
- Gap: VJSC menus are directional, but control regions do not preserve legacy control order under `dir="rtl"`.
- Affected: Default and Minimal; HTML and React; CSS and Tailwind.
- Recommendation: Add directional layout rules and VJSC matrix coverage.
```

## Validation

- Run the narrowest affected skin tests and refresh generated VJSC snapshots when output changes.
- Run `pnpm -F @videojs/skins test` for cross-target skin changes.
- Run `git diff --check`.