Agent Skills › videojs/video.js › maintain-vjsc-skin-gaps

maintain-vjsc-skin-gaps

GitHub

用于维护 VJSC 皮肤功能差异清单，当在 skins 包中发现或处理行为、样式等可见差异时，同步更新 gaps.md 以记录或关闭差异。

.agents/skills/maintain-vjsc-skin-gaps/SKILL.md videojs/video.js

触发场景

发现皮肤行为、样式或标记的差异实现或故意推迟差异修复

安装

npx skills add videojs/video.js --skill maintain-vjsc-skin-gaps -g -y

更多选项

非标准路径

npx skills add https://github.com/videojs/video.js/tree/main/.agents/skills/maintain-vjsc-skin-gaps -g -y

不安装直接使用

npx skills use videojs/video.js@maintain-vjsc-skin-gaps

指定 Agent (Claude Code)

npx skills add videojs/video.js --skill maintain-vjsc-skin-gaps -a claude-code -g -y

安装 repo 全部 skill

npx skills add videojs/video.js --all -g -y

预览 repo 内 skill

npx skills add videojs/video.js --list

SKILL.md

Frontmatter

{
    "name": "maintain-vjsc-skin-gaps",
    "description": "Maintain deferred VJSC parity gaps. Use when work under packages\/skins\/src adds, closes, or explicitly defers a parity gap."
}

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

Describe the observable published behavior and identify the affected Default or Neutral skin.
Inspect the equivalent source component, style rule, and generated HTML and React output. Similar names or classes are not evidence of parity.
If the change implements parity, verify all affected targets and CSS or Tailwind outputs, then remove any obsolete gap.
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.
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:

## 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 Neutral; 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.