A structured artifact is plain HTML that opens from
and works on a
phone. Load
first — it decides what each page shows
and in what order; this skill builds it.
Start from one
. Its first viewport carries the answer, and depth
discloses in place —
, popovers, a collapsible detail panel. Grow
into a folder (
+ child pages +
) when readers need
whole pages per branch: the index becomes a map with links, and each child
page stands alone with its own lede.
resources/multi-page-site.md
has the
folder mechanics.
Everything ships static — plain
tags, zero build step — so the
artifact opens anywhere, years later, with nothing installed. CDN tags are
the default; vendor the scripts into the folder when the artifact must work
offline (
resources/layout-and-theme.md
). Resource snippets show the shape
of each library's use, pinned only to a major version — before building,
web-search the library's current version and syntax when anything looks
dated, rather than trusting the snippet as frozen truth. Design for a
narrow viewport and let wider layouts be enhancements; touch targets stay
≥ 44px and diagrams pan and pinch. Drive colors from CSS custom properties on
, default light, with a ☀/🌙 toggle that adds
to
—
readers get a readable page in daylight and a choice at night.
resources/layout-and-theme.md
has the concrete layout, theme, and mobile
patterns shared across everything below.
Open the artifact in a browser before calling it done — a snippet that
looked right in the editor still fails at runtime (a CDN URL 404s, a library
changed its API, a diagram overflows). Check what a reader meets: the first
viewport carries the answer, every page renders at ~375px width, the theme
toggle flips both text and embedded content, links between pages resolve,
and Mermaid diagrams render correctly.
Mix and match resources and patterns as needed, starting with the simplest
pattern and adding complexity only when information hierarchy calls for it.
For custom node rendering, drag, or live filtering on graphs beyond what
Mermaid offers, see
resources/experimental-react-flow.md
.