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.13
7 files changed
+52−8
README.md+1−1@@ -152,7 +152,7 @@ The pack encodes these; they're worth stating here too: | **wiki-repo-styles** | The archetype taxonomy and how to choose. | | **wiki-component** | Publish a component: chip / molecule / board; the tabbed chip CAD-hub README (symbol, footprint, 3D, pins, specs, sourcing, tape & reel). | | **wiki-component-lod** | High / medium / low / super-low component GLB detail caches and how board viewers stream them. |-| **wiki-family** | Build a Family: naming, family tag, anchor registry, breadcrumbs. |+| **wiki-family** | Build a Family: naming, family tag, anchor registry, breadcrumbs, built-from template provenance. | | **wiki-skillpack** | Build a Skillpack: layout, install.sh, files[], the `-skillpack` suffix. | | **wiki-hero** | Generate a hero, and never let it get unlinked. | | **wiki-hero-studio** | Generate the page hero in Hero Studio, the human-gated hero lab the wiki requires for new app/skill heroes. |
SKILL.md+1−1@@ -98,7 +98,7 @@ important enough to state up front: | **wiki-visibility** | Public vs private source, public releases, the private readme, open vs closed pages. | | **wiki-repo-styles** | The archetype taxonomy (Page / Skillpack / Family) and how to choose. | | **wiki-component** | Publish a component page: chip / molecule / board; the tabbed chip CAD-hub README. |-| **wiki-family** | Build a Family: naming convention, family tag, anchor registry, breadcrumbs. |+| **wiki-family** | Build a Family: naming convention, family tag, anchor registry, breadcrumbs, built-from template provenance. | | **wiki-skillpack** | Build a Skillpack: layout, install.sh, files[], skill map, the `-skillpack` suffix. | | **wiki-hero** | The hero image: generate it (adom-wiki-hero-image), and never let it get unlinked. | | **wiki-hero-studio** | Generate the page hero: RUN `hero-studio pose <owner/slug>` (human clicks Generate). Do NOT open its wiki page. |
install.shpackage.json+1−1@@ -1,7 +1,7 @@ { "slug": "adom-wiki-skillpack", "title": "Adom Wiki Skill Pack",- "version": "0.8.12",+ "version": "0.8.13", "type": "skill", "hero": { "path": "screenshots/hero.png"
page.json+11−4@@ -105,9 +105,16 @@ "coarse-first board viewer", "3D board GPU memory freeze", "reviewed chip artwork in assembled board",+ "hero GLB versus board LOD",+ "footprint or silkscreen baked into high LOD",+ "image-first component LOD previews", "shared workspace",+ "project workspace", "hydrogen/workspace.json",- "workspace apply"+ "workspace apply",+ "workspace export",+ "ship my hydrogen layout",+ "open in hydrogen" ], "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": [@@ -124,8 +131,8 @@ "prompt": "Before I create this wiki page, check whether the thing already has a home." } ],- "version": "0.8.12",- "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.",+ "version": "0.8.13",+ "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.", "dependencies": { "adom/adom-wiki-hero-image": "^0.2.2", "adom/component-widgets": "^1.1.12"@@ -187,4 +194,4 @@ "email": "[email protected]" }, "org": "adom"-}+}
skills/wiki-family/SKILL.md+38−1@@ -8,7 +8,8 @@ description: >- cadence, or when adding a child/plugin to an existing family. Trigger words: wiki family repo, parent child wiki page, add a plugin to the family, anchor page, family tag, name a child page, adom-usb plugin, adom-desktop bridge,- publish a child page, family naming convention, register a child.+ publish a child page, family naming convention, register a child,+ template revision, built_from, which template made this child, family provenance. --- Parent skill: **adom-wiki-skillpack**@@ -113,3 +114,39 @@ Children are found three ways, so set all three: the **family tag** (`<parent>-plugin`), the anchor's **registry table** in its README, and **breadcrumbs** from the child back to the anchor. The anchor can also query the registry for everything tagged `<parent>-plugin` to list the family live.++## 6. Native membership and built-from provenance++The naming convention is what a reader sees; the wiki also keeps the family as a+**relationship**, and that is what carries provenance:++```bash+adom-wiki family add-child <parent> --child <owner>/<child> # manage both pages+adom-wiki family anchor <parent> --child <owner>/<child> # the reference child+adom-wiki family show <parent> # children, anchor, provenance+```++When the anchor is a **template** that generates its children (a molecule family,+a board family), record which template revision produced each child so a+template change can name the children that need a look:++1. The anchor commits `family.json` with `templateRevision` and the files that+ make up the contract (`implementation`, `fixedLayout`, `sources[]`); the wiki+ hashes those into `source_digest`. README, title and hero edits never move it.+ An optional ledger says what a bump means for older children:+ `"revisions": [{ "revision": "1.1.0", "breaking": true, "note": "routed contract" }]`+ or `"compatible_with": ["1.0.0"]`.+2. Each child's `page.json` says what built it:+ `"built_from": { "template": "adom/<parent>", "revision": "1.0.0", "source": "sha256:..." }`.+ A push records it on the relationship (`FAMILY_BUILT_FROM_RECORDED`); a publish+ also stamps the release, so every published version keeps the revision it came+ from. `FAMILY_NOT_MEMBER` means link first (step above), then push again.+3. `family show` (and `GET /api/pages/<parent>/family`) reports each child as+ `current`, `behind` (with `impact`: incompatible, compatible, or unreviewed+ per the ledger), `drifted` (contract changed under the same revision) or+ `unrecorded`, plus a `review[]` list. Pushing a family.json that moves the+ revision answers `FAMILY_REVISION_CHANGED` naming every child behind.++The server never rebuilds a child or advances its recorded revision; a legacy+child with no `built_from` reads as unrecorded, not as current. Both overview+pages draw the record (a table on the anchor, a "Built from" line on the child).
uninstall.sh