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.58
4 files changed
+30−5
SKILL.md+2−1@@ -95,7 +95,7 @@ important enough to state up front: | **wiki-anatomy** | The mental model: the six tools in one, and how the layers relate. | | **wiki-api** | The REST API + ``adom-wiki pkg`` CLI, the two storage layers, the publish workflow. | | **wiki-publish-safely** | The operational pitfalls as hard rules; the verify-in-pup gate. |-| **wiki-readme** | How to make a great README: `README.md` vs `readme.html`, sections, embeds (YouTube player via `::youtube{}`), images. |+| **wiki-readme** | How to make a great README: `README.md` vs `readme.html`, sections, embeds (YouTube player via `::youtube{}`, inline PDFs via `::adom-pdf{}`), images. | | **wiki-readme-html** | Build a custom `readme.html`: sandbox limits, how it shares the page with README.md (`readme_order`), self-containment, theming, verify loop; one project's interactive tool becomes its readme.html, never a registry widget. | | **wiki-sub-readme** | Make a sub-readme (`<folder>/README.md`) and ALWAYS its section card in the main README (header, AI-made thumbnail, three sentences). The repo-push / path / verify gotchas. | | **wiki-visibility** | Public vs private source, public releases, the private readme, open vs closed pages. |@@ -125,6 +125,7 @@ important enough to state up front: - "Show/open hero studio" / "generate a hero" / HERO_STUDIO_REQUIRED → wiki-hero-studio (RUN the app, do not browse the page) - "Write a README for this page" → wiki-readme - "Embed a YouTube video / demo video in the README" → wiki-readme (`::youtube{id="VIDEO_ID"}`)+- "Show a PDF on the page / embed a PDF in the README" → wiki-readme (`::adom-pdf{src="docs/file.pdf"}`) - "I want a custom HTML readme / tabs / designed layout" → wiki-readme-html - "Add an interactive explorer / simulator / calculator for this project" / "register it as a widget" → wiki-readme-html (make it the page's readme.html; the widget registry is for generic widgets only) - "Create me a sub-readme" / "make a sub-readme" / "my README is too long, split it" / "link a deep-dive doc" → wiki-sub-readme
package.json+1−1@@ -1,7 +1,7 @@ { "slug": "adom-wiki-skillpack", "title": "Adom Wiki Skill Pack",- "version": "0.8.57",+ "version": "0.8.58", "changelog": "0.8.55: wiki-publish-safely matches adom-wiki 1.8.2 (tested 2026-10-30, #5): publish writes both layers (commits the tarball files + a merged page.json to the repo), a first publish creates the page with no ghost row, and page.json is merged (manifest keys win, the hero and hand-added keys survive); the old rules are kept for older CLIs/servers. 0.8.54: publish checklist: page.json must carry the same discovery_triggers as package.json; a page.json push without them silently wipes the page's triggers (adom/wiki#240).", "type": "skill", "hero": {
page.json+1−1@@ -201,7 +201,7 @@ "prompt": "Before I create this wiki page, check whether the thing already has a home." } ],- "version": "0.8.57",+ "version": "0.8.58", "changelog": "0.8.55: wiki-publish-safely matches adom-wiki 1.8.2 (tested 2026-10-30, #5): publish writes both layers (commits the tarball files + a merged page.json to the repo), a first publish creates the page with no ghost row, and page.json is merged (manifest keys win, the hero and hand-added keys survive); the old rules are kept for older CLIs/servers. 0.8.54: publish checklist: page.json must carry the same discovery_triggers as package.json; a page.json push without them silently wipes the page's triggers (adom/wiki#240).", "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": {
skills/wiki-readme/SKILL.md+26−2@@ -1,8 +1,8 @@ --- name: wiki-readme description: >-- Write a wiki page README: required sections, images, videos, embeds; never repeat the hero. Part- of adom-wiki-skillpack.+ Write a wiki page README: required sections, images, videos, embeds (YouTube, inline PDFs);+ never repeat the hero. Part of adom-wiki-skillpack. --- Parent skill: **adom-wiki-skillpack**@@ -260,6 +260,30 @@ player inline (from youtube-nocookie.com, lazy-loaded, one click to play): readme.html cannot show it (see **wiki-readme-html**). A tag inside a code block stays code, so you can document the syntax. +PDF: put the built-in tag on its own line. The wiki shows the PDF in place in its+own reader (pages, zoom, fullscreen, download), with text a reader can select,+copy and find with Ctrl+F, and the PDF's own links working:++```markdown+::adom-pdf{src="docs/proposal.pdf"}+::adom-pdf{src="docs/proposal.pdf" title="Year 1 proposal" page="3" height="900"}+::adom-pdf{src="/<owner>/<other-slug>/render/spec.pdf"}+```++- `src` is a `.pdf` in this page's repo, from the repo root, or another page's+ file as `/<owner>/<slug>/render/<path>`. Readers see it only if they could+ download that file. `title` names it in the reader's toolbar (default: the file+ name), `page` opens at a page, `height` sets the frame in px (240 to 2000,+ default 760).+- Use this instead of rendering the PDF to page images: the text stays+ selectable and searchable, links work, and there is nothing to re-render when+ the PDF changes. `<iframe>`, `<embed>` and `<object>` are stripped in+ README.md.+- A `src` that is not a PDF in the page answers `PDF_TAG_INVALID` on push and+ renders nothing. A `.pdf` opened from the Files tab shows the same reader.+- `adom-wiki widgets` lists the built-in tags (`builtin: true`) beside the+ registered widgets.+ Video, local file from the repo (the blob endpoint supports Range, so seeking works):