← Commit history

dev skill: the SOLVED pkg-publish recipe (skills-only files allowlist + billboard hero) + the MANDATORY revert-hero-after-publish step

John Lauer ·061d968e87 ·4mo ago ·parent 33c1c7a
1 file changed +41
skills/fusion-bridge-dev/SKILL.md+41
@@ -131,6 +131,47 @@ that's it (AD respawns the bridge server). Add-in change (addin/) = ALSO `fusion `install_addin.py` -> hash-verify (Get-FileHash, not findstr) -> `fusion_start`. Community: fork the page, release to your fork, `bridge_install` your manifest to test, then PR back. +## Publishing the SKILLS pkg (`adom-wiki pkg publish`) — the maze, SOLVED (2026-06-28)++The skills pkg (`adom-wiki pkg install adom/adom-desktop-fusion-bridge`) is SEPARATE from the Release.+Publishing it from this repo (which also holds `server.py`/`addin/`) was blocked by a maze; two fixes in+`page.json` unblock it:++1. **Make it skills-only with a `files` allowlist** — else the dep-checker scans `server.py` and flags its+   `import aps/describe/handlers/eagle_lbr/adsk/PIL` as ~20 "undeclared deps" (false positives the SERVER+   enforces, not just lint). Ship only what the pkg needs:+   ```json+   "files": ["SKILL.md","skills/**","screenshots/hero.png","README.md","VERBS.md","install.sh",+             "uninstall.sh","page.json","MAKING_LIBRARIES.md","LIBRARY_FINDINGS.md","PUBLISHING.md",+             "CREATING_BASIC_PARTS_LIBRARIES.md"]+   ```+   Use `skills/**` (a bare `skills/` matches nothing and errors).+2. **The publish DEMANDS a billboard hero** (`{type:billboard,headline,subhead,screenshot}`); it rejects+   the page's `{type:image,path}`. So set billboard ONLY to get past publish:+   ```json+   "hero": {"type":"billboard","headline":"Adom Desktop - Fusion 360 Bridge",+            "subhead":"Drive Fusion 360 from the cloud: electronics, exports, fast APS cloud search, and component libraries with real 3D",+            "screenshot":"screenshots/hero.png"}+   ```+   The image must be in the repo (curl `/files/screenshots/hero.png` if your working copy lacks it).+3. `adom-wiki pkg publish --skip-lint` (the "prompt-injection"/"no video" warnings are soft false+   positives). Bump `page.json` `version` each time; add `discovery_triggers` so AIs surface it.+4. **⛔ IMMEDIATELY REVERT THE HERO** (this is the bug John warned about). `pkg publish` overwrites the+   page's hero with the billboard form, which the PAGE renders as a generic template (your custom+   full-bleed `hero.png` shrinks to a thumbnail on the right). **Right after publishing, push the page+   hero back to the image form** — via `adom-wiki repo push` (NOT another `pkg publish`, which re-breaks it):+   ```bash+   # page.json: "hero": {"type":"image","path":"screenshots/hero.png"}+   adom-wiki repo push adom/adom-desktop-fusion-bridge --files page.json -m "restore full-bleed hero"+   ```+   The pkg stays published (registry snapshot is immutable); only the page display is restored.+5. **VERIFY**: `adom-wiki pkg install adom/adom-desktop-fusion-bridge` deploys skills to+   `~/.claude/skills/`, AND re-open the live page to confirm the **full-bleed custom hero renders** (not+   the thumbnail-in-template). Then `git commit` + `git push` `page.json` (image form) to GitHub for+   lockstep. NOTE: pkg version (`page.json`, 1.6.x) is a SEPARATE track from the Release/bridge version+   (`bridge.json`/`BRIDGE_VERSION`, 1.5.x). TODO: this publish↔hero conflict is a wiki bug — filed to+   `adom/wiki`.+ ## Bundle deep READMEs INTO each skill (so the installed AI actually reads them)  When a skill points at companion docs (a step-by-step guide, a findings log), **copy those READMEs INTO