wiki-sub-readme and wiki-readme: add the video embedding rules (paths from the page root, width attribute since style is stripped, verify the rendered page)

Overview Files Packages Releases Dependencies Issues1 Breadcrumbs Pull Requests Activity

Closed general

John Lauer · 1mo ago ·closed by Colby Knox

Found on 2026-09-12 publishing adom/hydrogen/files/project-workspaces/README.md. The wiki-sub-readme skill already says images are referenced by repo-root path and to verify the rendered page; two things it and wiki-readme do not say cost a round trip:

<video> in a README: the sanitizer keeps controls / preload / poster / src / width and strips style; the markdown stylesheet constrains img but not video, so an unsized video renders at its intrinsic width and runs off the column. A numeric width="1080" attribute is the workaround (adom/wiki#205 asks for a CSS rule). Suggested line for both skills: "A video needs a numeric width attribute; style is stripped and there is no max-width rule for video."
The path rule applies to video src and poster too, and to a README inside a folder (project-workspaces/README.md must write project-workspaces/demo.mp4, not demo.mp4).

The full checklist now lives in adom/demo-authoring-skillpack as demo-video-publishing; a one-line pointer from wiki-readme's "embedding live demos / videos" section would route people there. Happy to push the wording if you prefer a PR.

2 Replies

Colby Knox · 1mo ago

Both skills updated in adom/adom-wiki-skillpack 0.8.14 (published + repo pushed):

wiki-readme: the video example now uses a numeric width="1080", followed by the three rules verbatim from your findings: numeric width attribute required (sanitizer keeps controls/preload/poster/src/width, strips style; stylesheet constrains img but not video, so unsized video runs off the column, adom/wiki#205 noted), repo-root paths apply to video src and poster including READMEs inside folders (your project-workspaces example quoted), verify the rendered page. Plus the one-line pointer to demo-video-publishing in adom/demo-authoring-skillpack under the embed examples.
wiki-sub-readme: the repo-root-path section now extends explicitly to video src/poster with the folder-README example, the numeric-width rule, and the same skillpack pointer.

Fleet picks it up on the next pkg update. Thanks for writing the exact wording; both lines went in nearly verbatim.

John Lauer · 1mo ago

Confirmed, thanks Colby. Read both updated skills in adom-wiki-skillpack 0.8.14: the numeric width rule, the repo-root paths for video src and poster including folder READMEs, the verify-the-rendered-page step, and the demo-video-publishing pointer are all there. Nothing more needed from my side.