skill
Adom UI Design System
Public Made by Adomby adom
How the AI builds and tests interfaces people love to use in Adom. Ships as one installable skill that bundles focused skills (tooltips, floating-windows, toasts, responsive-ui, app-shell, ai-driven-apps, clickable-paths).
← Commit history
Publish 1.3.7
4 files changed
+23−3
install.sh+1@@ -1,6 +1,7 @@ #!/usr/bin/env bash # Install the Adom UI Design System and every UI skill bundled in this repo. set -e+cd "$(dirname "$0")" # relative cp paths below; the update hook may invoke from another cwd DEST="$HOME/.claude/skills" install_skill() { mkdir -p "$DEST/$1"; cp "$2" "$DEST/$1/SKILL.md"; }
package.json+1−1@@ -1,6 +1,6 @@ { "slug": "adom-ui-design",- "version": "1.3.1",+ "version": "1.3.7", "type": "skill", "description": "The Adom UI Design System plus a bundle of focused UI skills (tooltips, floating-windows, toasts, responsive-ui, app-shell, ai-driven-apps). One adompkg install drops the whole set of skill files onto your container.", "dependencies": {},
page.json+3−2@@ -1,6 +1,6 @@ { "slug": "adom-ui-design",- "version": "1.3.6",+ "version": "1.3.7", "type": "skill", "description": "The Adom UI Design System plus a bundle of focused UI skills (tooltips, floating-windows, toasts, responsive-ui, app-shell, ai-driven-apps). One adompkg install drops the whole set of skill files onto your container.", "dependencies": {},@@ -17,7 +17,8 @@ "skills/toasts/SKILL.md", "skills/responsive-ui/SKILL.md", "skills/app-shell/SKILL.md",- "skills/ai-driven-apps/SKILL.md"+ "skills/ai-driven-apps/SKILL.md",+ "skills/skill-authoring/SKILL.md" ], "scripts": { "install": "./install.sh",
skills/ai-driven-apps/SKILL.md+18@@ -72,6 +72,24 @@ Pick the surface by what you need to test, and use more than one at once when it | **pup** | A clean, scriptable Chrome the AI fully owns | The **fresh, logged-out, first-time-user** experience, and automated screenshot loops that should not fight the user's own tabs. | | **Hydrogen webview** | An in-workspace browser tab | Showing a result inside the workbench, next to the code and the chat. | ++### VS Code's "Simple Browser" is NOT a surface++**NEVER show an Adom app in VS Code's built-in "Simple Browser".** It is none of the three+surfaces: no live channel, no console read-back, no AI drivability, wrong pane semantics.+If you are about to paste an app URL into Simple Browser, stop and load the `webview` skill+instead.++### Every app's SKILL.md must carry a display section (MANDATE)++When you write or update an app's SKILL.md, include a section titled+**"Displaying this app (REQUIRED)"** that (a) names the app's own show/open verb if it has+one, (b) instructs loading the `webview` skill for manual display (pup / native browser per+the table above), and (c) states the Simple Browser ban verbatim. Skill discovery from+trigger words alone is probabilistic; the app skill IS reliably loaded when the app is+named, so it must carry the display rules itself. (Decision John 2026-07-17, after a fresh+workspace showed adom-parts-search in Simple Browser.)+ The native-browser and pup split is the point: open the **logged-in path in the native browser** and the **logged-out path in pup** at the same time, and verify both. Tell the user which surface and why.