skill
Adom Wiki Skill Pack
Public Made by Adomby adom
The Adom Wiki Skill Pack : one main skill plus the focused sub-skills that teach the AI to publish to wiki.adom.inc without breaking pages, name the wiki repo archetypes (Page, Skillpack, Family), and publish rich component pages (chips, molecules, boards). The wiki is six tools in one: git, package manager, releases, discussions, pull requests, and discovery. One package manager install drops the whole set onto your container. Includes reviewed Z-up component artwork, surface-selected MPN marki
← Commit history
Publish 0.8.45
8 files changed
+171−9
README.md+6@@ -211,3 +211,9 @@ existing 3D viewer handles full chip rendering. The component and LOD skills now distinguish annotated wiki heroes from clean board-use LODs. Every LOD, including high, excludes footprint outlines, pad labels and silkscreen, while preserving actual terminals and reviewed chip markings. The LOD widget uses cached image previews before the user enables 3D. Component LOD guidance also covers exact micrometre placement transforms, real rendered MPN checks, authenticated lazy asset transport under the wiki sandbox, short-viewport preview activation, and recording review.++## Narrated videos, captions and chapters++Read [wiki-video-captions](skills/wiki-video-captions/SKILL.md) before embedding+a film in a README. It covers `::adom-video`, public/private manifests, speech+caption generation, timing after edits, dead-air checks and live player proof.
SKILL.md+7@@ -47,6 +47,13 @@ Plus a **presentation layer** (a plain `README.md`, or a custom `readme.html`, p a separate **private readme** for proprietary-source pages). Full model → **wiki-anatomy**. +## Narrated videos and captions++Before adding any video to a Wiki README, read **wiki-video-captions**. Use+`::adom-video`, generate timed speech captions and chapters, and verify the+actual sandboxed player. Requests such as "add captions", "no dead air",+"video widget", and "lead with the video" route here.+ ## Three repo archetypes (pick one before you publish) | Archetype | One line | Examples | Build skill |
install.sh+1@@ -26,6 +26,7 @@ install_skill wiki-anatomy skills/wiki-anatomy/SKILL.md install_skill wiki-api skills/wiki-api/SKILL.md install_skill wiki-publish-safely skills/wiki-publish-safely/SKILL.md install_skill wiki-readme skills/wiki-readme/SKILL.md+install_skill wiki-video-captions skills/wiki-video-captions/SKILL.md install_skill wiki-readme-html skills/wiki-readme-html/SKILL.md install_skill wiki-readme-slideshow skills/wiki-readme-slideshow/SKILL.md install_skill wiki-visibility skills/wiki-visibility/SKILL.md
package.json+13−4@@ -1,12 +1,12 @@ { "slug": "adom-wiki-skillpack", "title": "Adom Wiki Skill Pack",- "version": "0.8.44",+ "version": "0.8.45", "type": "skill", "hero": { "path": "screenshots/hero.png" },- "description": "The Adom Wiki Skill Pack : one main skill plus the focused sub-skills that teach the AI to publish to wiki.adom.inc without breaking pages, name the wiki repo archetypes (Page, Skillpack, Family), and publish rich component pages (chips, molecules, boards). The wiki is six tools in one: git, package manager, releases, discussions, pull requests, and discovery. One package manager install drops the whole set onto your container. Includes reviewed Z-up component artwork, surface-selected MPN marking, reusable thumbnail caches and component-page widgets.",+ "description": "The Adom Wiki Skill Pack : one main skill plus the focused sub-skills that teach the AI to publish to wiki.adom.inc without breaking pages, name the wiki repo archetypes (Page, Skillpack, Family), and publish rich component pages (chips, molecules, boards). The wiki is six tools in one: git, package manager, releases, discussions, pull requests, and discovery. One package manager install drops the whole set onto your container. Includes reviewed Z-up component artwork, surface-selected MPN marking, reusable thumbnail caches and component-page widgets. Includes canonical video widgets, synchronized captions and chapters, and voiceover pacing checks.", "discovery_triggers": [ "publish to the wiki", "the wiki",@@ -78,7 +78,15 @@ "workspace apply", "workspace export", "ship my hydrogen layout",- "open in hydrogen"+ "open in hydrogen",+ "::adom-video",+ "adom-video wiki widget",+ "video in README",+ "generate captions",+ "closed captions",+ "VTT subtitles",+ "no dead air",+ "voiceover gaps" ], "dependencies": { "adom/adom-wiki-hero-image": "^0.2.2",@@ -120,7 +128,8 @@ "skills/wiki-component-lod/references/runtime.md", "skills/wiki-workspaces/SKILL.md", "skills/wiki-brand/SKILL.md",- "skills/wiki-hero-glb/SKILL.md"+ "skills/wiki-hero-glb/SKILL.md",+ "skills/wiki-video-captions/SKILL.md" ], "scripts": { "install": "./install.sh",
page.json+13−4@@ -114,7 +114,15 @@ "workspace apply", "workspace export", "ship my hydrogen layout",- "open in hydrogen"+ "open in hydrogen",+ "::adom-video",+ "adom-video wiki widget",+ "video in README",+ "generate captions",+ "closed captions",+ "VTT subtitles",+ "no dead air",+ "voiceover gaps" ], "discovery_pitch": "Anything touching wiki.adom.inc: publishing, page archetypes, readmes, heroes, discovery, and the wiki-bloat rule (find where a thing already lives before creating any page).", "sample_prompts": [@@ -131,8 +139,8 @@ "prompt": "Before I create this wiki page, check whether the thing already has a home." } ],- "version": "0.8.44",- "description": "The Adom Wiki Skill Pack : one main skill plus the focused sub-skills that teach the AI to publish to wiki.adom.inc without breaking pages, name the wiki repo archetypes (Page, Skillpack, Family), and publish rich component pages (chips, molecules, boards). The wiki is six tools in one: git, package manager, releases, discussions, pull requests, and discovery. One package manager install drops the whole set onto your container. Includes reviewed Z-up component artwork, surface-selected MPN marking, reusable thumbnail caches and component-page widgets.",+ "version": "0.8.45",+ "description": "The Adom Wiki Skill Pack : one main skill plus the focused sub-skills that teach the AI to publish to wiki.adom.inc without breaking pages, name the wiki repo archetypes (Page, Skillpack, Family), and publish rich component pages (chips, molecules, boards). The wiki is six tools in one: git, package manager, releases, discussions, pull requests, and discovery. One package manager install drops the whole set onto your container. Includes reviewed Z-up component artwork, surface-selected MPN marking, reusable thumbnail caches and component-page widgets. Includes canonical video widgets, synchronized captions and chapters, and voiceover pacing checks.", "dependencies": { "adom/adom-wiki-hero-image": "^0.2.2", "adom/component-widgets": "^1.1.12"@@ -173,7 +181,8 @@ "skills/wiki-component-lod/references/runtime.md", "skills/wiki-workspaces/SKILL.md", "skills/wiki-brand/SKILL.md",- "skills/wiki-hero-glb/SKILL.md"+ "skills/wiki-hero-glb/SKILL.md",+ "skills/wiki-video-captions/SKILL.md" ], "scripts": { "install": "./install.sh",
skills/wiki-readme/SKILL.md+5@@ -21,6 +21,11 @@ Parent skill: **adom-wiki-skillpack** # How to make a README (the presentation layer) +**Adding a video? Read `wiki-video-captions` first.** Narrated videos use the+registered `::adom-video` widget with synchronized captions and chapters; put+it first when the user requests a video-led README. Do not default to raw HTML+`<video>`. This route applies to existing videos as well as newly edited demos.+ On the Adom Wiki the **README is the page**, the Overview tab is the first thing a human sees, and it's what sells the page in search and on cards. There are TWO presentation modes:
skills/wiki-video-captions/SKILL.mdadded+125@@ -0,0 +1,125 @@+---+name: wiki-video-captions+description: >-+ Publish a narrated video in an Adom Wiki README using ::adom-video, generate+ synchronized WebVTT captions and chapters, remove padded dead air, and verify+ the real widget. Read before adding or replacing any wiki video. Triggers:+ adom-video, ::adom-video, video in README, narrated demo, closed captions,+ subtitles, VTT, SRT, caption files, video chapters, no dead air, voiceover gaps,+ video widget, video first, process video, publish a demo video.+---++# Wiki video and caption delivery++Use the existing page and the registered **::adom-video** widget. Do not create a+separate video page or hand-written HTML player. Read **demo-video-publishing**+for production/editing and **adom-tts** for narration. This skill covers the+README delivery path, including existing videos with no caption sidecar.++## Find and embed the supported widget++Read `https://wiki.adom.inc/api/widgets` for the live `adom-video` attributes.+Put the tag on its own line outside a code fence. Use absolute wiki render paths.+`video=` takes media; `src=` takes a JSON manifest, never an MP4.++```markdown+::adom-video{video="/OWNER/SLUG/render/videos/demo.mp4" title="How we built it" poster="/OWNER/SLUG/render/videos/poster.jpg" captions="/OWNER/SLUG/render/videos/captions.vtt" chapters="/OWNER/SLUG/render/videos/chapters.json"}+```++When asked to lead with the film, put the widget immediately after the README+title, before the technical overview. Preserve a plain download link. Do not+change the page's visibility or autoplay sound. Do not use raw `<video>` merely+because it is familiar: that loses the standard player controls and delivery+contract. A raw tag is a fallback only for a verified unsupported surface.++Prefer the manifest form, especially for private pages:++```markdown+::adom-video{src="/OWNER/SLUG/render/videos/demo.video.json"}+```++```json+{+ "video": "/OWNER/SLUG/render/videos/demo.mp4",+ "title": "How we built it",+ "poster": "/OWNER/SLUG/render/videos/poster.jpg",+ "chapters": [{"t": 0, "title": "The design"}, {"t": 12.5, "title": "The test"}],+ "captions": "WEBVTT\n\n00:00:00.200 --> 00:00:03.100\nThe exact spoken sentence.\n"+}+```++The wiki inlines the JSON. Inlining chapter rows and WebVTT text avoids separate+unauthenticated fetches from its opaque widget sandbox. Do not expose a private+file or weaken CSP to fix caption fetches. Keep separate downloadable `.vtt` and+`.srt` files alongside the manifest for reuse.++## Generate real captions against the final edit++1. Identify the exact final media hash and duration. Caption the actual voice,+ not headings, visual labels, or an earlier draft script.+2. For TTS, reuse the source narration text and audio files. Prefer timestamped+ word/sentence metadata from the synthesis tool when available. **gang-takes**+ in `adom/adom-video-post` emits VTT, chapters, and widget embeds; inspect its+ output rather than assuming it reflects a later edit.+3. If timestamps are absent, align the known script to the final audio with a+ speech aligner or word-timestamp ASR. For unknown speech, transcribe first.+ Review technical names, units and numerals against the audio and source.+ Do not replace accurate written part names with recognition mistakes.+4. A single-sentence audio clip can use its measured placement and spoken end.+ A multi-sentence clip needs sentence/phrase boundaries. Do not assign every+ sentence the whole clip interval or stretch a paragraph across a scene.+ Even word-count timing is only an estimate; label it and inspect playback.+5. Write UTF-8 WebVTT with `WEBVTT`, a blank line, then `HH:MM:SS.mmm -->+ HH:MM:SS.mmm` and text. SRT uses numbered cues and comma milliseconds.+ Prefer one or two readable lines, roughly 42 characters per line, natural+ phrase breaks, and a few seconds per cue. Preserve all spoken words.+6. Verify finite, increasing timestamps, positive cue lengths, no unintended+ overlaps, and cue/chapter ends within the measured media duration. Chapters+ are JSON `[{"t": seconds, "title": "..."}]`, sorted and starting at zero.+7. Any trim, narration delay, time stretch, concatenation, or speed change+ invalidates old timing. Regenerate or map captions AND chapters through the+ edit decision list. Keep the original cut and record source/output hashes.++## Remove padded dead air without damaging speech++Measure before editing, for example:++```bash+ffmpeg -hide_banner -i final.mp4 -vn -af silencedetect=noise=-38dB:d=0.7 -f null -+```++These are starting thresholds, not universal speech detectors. Music may conceal+silent narration; analyze the isolated voice too when available. Review flagged+intervals. Preserve quiet consonants, breaths and natural sentence pauses. Trim+padding or shorten the corresponding picture; keep important action visible by+appropriate retiming. Do not fill time with invented narration, freeze frames,+or slow the voice solely to meet a target runtime. If tightening changes runtime,+say so. Recheck the FINAL encoded audio at scene joins and ending. A silent audio+track is not a narration pass; a loudness check is not a comprehension review.++## Publish and prove the real player++Push README, media, poster, VTT/SRT, chapters and manifest using `adom-wiki repo+push --files ...`. Reuse the intended Pup tab and inspect the rendered README.+Do not confuse a successful download with a working widget.++Target the iframe whose URL contains `/widget/adom-video`. Through Pup's frame+selector, evaluate:++```javascript+const player = document.querySelector('adom-video');+await player.adomDrive.ready();+player.adomDrive.state(); // duration, chapters > 0, captions > 0, playback state+```++The widget is sandboxed: direct parent DOM access can fail legitimately. Use the+browser's frame-targeted evaluation; never loosen the sandbox. Mute temporary+playback checks (`player.v.muted = true`), seek into beginning/middle/end cues,+turn captions on, inspect rendered caption text and time progression, then pause+and restore the prior mute preference. Screenshot the actual README widget.+Never claim the user heard a muted check. Do not leave playback running.++A package source push is not a release. Skillpack changes also need the explicit+package file list, install/uninstall entries, root routing, discovery triggers,+pack inspection and a tested version publication. Existing AI threads must read+updated skills; installing files does not replace their already-loaded context.
uninstall.sh+1−1@@ -6,7 +6,7 @@ else DESTINATIONS=("$HOME/.claude/skills" "${CODEX_HOME:-$HOME/.codex}/skills") fi for DEST in "${DESTINATIONS[@]}"; do- for name in adom-wiki-skillpack wiki-anatomy wiki-api wiki-publish-safely wiki-readme wiki-readme-html wiki-readme-slideshow wiki-visibility wiki-repo-styles wiki-component wiki-component-lod wiki-family wiki-skillpack wiki-hero wiki-breadcrumbs wiki-forking wiki-discovery wiki-scoring wiki-bloat wiki-sub-readme wiki-subreadme wiki-hero-studio wiki-workspaces wiki-brand wiki-hero-glb; do+ for name in adom-wiki-skillpack wiki-anatomy wiki-api wiki-publish-safely wiki-readme wiki-video-captions wiki-readme-html wiki-readme-slideshow wiki-visibility wiki-repo-styles wiki-component wiki-component-lod wiki-family wiki-skillpack wiki-hero wiki-breadcrumbs wiki-forking wiki-discovery wiki-scoring wiki-bloat wiki-sub-readme wiki-subreadme wiki-hero-studio wiki-workspaces wiki-brand wiki-hero-glb; do rm -rf -- "$DEST/$name" done done