Default hero compose is weak; agent falls back to the adom-wiki-hero-image skill every time

Overview Files Skills Discover Packages Releases Dependencies Issues4 Breadcrumbs Pull Requests Activity

Closed general

John Lauer · 22d ago ·closed by Colby Knox

The wiki's default hero behavior (the billboard it auto-composes from a manifest hero: {headline, subhead, screenshot}) produces a weak result, especially for pages with no real UI screenshot: headline/subhead on the left, and on the right a gradient card that just REPEATS the same headline and subhead. No product, no real screenshot, nothing to actually look at. It fails the one-second billboard test, so it is not something you want on a page header, the homepage trending slideshow, the installer, or the screensaver.

Two real examples live right now (found in the wild today):

adom/wiki-notes-via-discussions

bad default hero: wiki-notes-via-discussions

adom/agent-browser-isolation

bad default hero: agent-browser-isolation

In practice the agent ends up ignoring that default and running the adom/adom-wiki-hero-image skill by hand to get a real, on-brand hero: name-first hierarchy, one teal accent, a crisp real-UI shot in a floating Adom-webview window, and the brand themes (midnight / pcb / gradient). Same idea, done right:

good, adom-wiki-hero-image output

This came up 5 times today across different pages, the same fix every time.

Ask: have the default hero path either (a) run the adom-wiki-hero-image recipe automatically at publish time, or (b) refuse and point the author to the skill, instead of silently shipping a weak default that someone then has to redo by hand.

3 Replies

John Lauer · 22d ago

Good (same app, after running the adom/adom-wiki-hero-image skill): name-first hierarchy, teal accent on the value word, the real app UI in a floating Adom-webview window, PCB-traces theme. This is the result the default should aim for.

good-hero

John Lauer · 22d ago

Bad, full size: the wiki's default auto-composed billboard (generic template, screenshot shrunk to a thumbnail on the right, headline/subhead on the left, no accent or brand theme). This is what ships when the author does not run the adom-wiki-hero-image skill.

default-hero

Colby Knox · 22d ago

Done, and live on prod. Rebuilt the wiki's billboard composer to the canonical adom-wiki-hero-image look, so the auto-composed (no-pup) hero is itself on-brand rather than a weak default:

name-first hierarchy (the package name is the dominant tier),
one teal->blue->purple accent gradient on a word of the value-prop (the signature),
the screenshot in a floating, drop-shadowed "Adom webview" window with real chrome (leaf icon, title, min/max/close) that bleeds off the bottom,
brand themes: midnight (default) / pcb / gradient, set via hero.theme,
the ADOM wordmark, a type badge chip, and the page URL.

A screenshot is optional: with none, the window renders a themed empty body (a faint brand-mark watermark), so every page gets a styled, on-brand hero with zero manual work. Your two examples (wiki-notes-via-discussions, agent-browser-isolation) now render the new hero. Verified across all three themes, with and without a screenshot. Thanks for the detailed write-up and the good-hero reference, that is exactly what it is modeled on.