[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7B3RAXTCHVNGQ9729PRSGFY":3,"skill-same:01M7B3RAXTCHVNGQ9729PRSGFY":63},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M7B3RAXTCHVNGQ9729PRSGFY","visualize",null,"Charts, maps, plots, simulators, UI mockups in chat.","merllinsbeard\u002Fmerlin-CTO","merllinsbeard","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F144795773?v=4","01M7B3C01C1PCBWFGB5T7YXSF8","merlin","01M7B3C023BBYDEPAPWBAGW9A7",1,"MIT","https:\u002F\u002Fgithub.com\u002Fmerllinsbeard\u002Fmerlin-CTO\u002Fblob\u002Fmain\u002Fskills\u002Fvisualization\u002Fvisualize\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: visualize\ndescription: \"Charts, maps, plots, simulators, UI mockups in chat.\"\n---\n\n# Visualize\n\nInteractive HTML visuals delivered in chat as a standalone `.html` attachment\nplus a screenshot preview. Use when the user wants to see how something works,\nmake simulators or labs, maps, plots, charts or graphs, comparisons, UI\nmockups, scenarios, adjustable inputs, and exploration beyond regular text.\nWorks on every Hermes surface (Telegram, Desktop) because the deliverable is\na file, not an inline widget.\n\n## When to use it\n\n- A request for a new standalone file, website, app page, component, or other\n  project change is not a visualization request, even when the deliverable\n  contains charts or interactive content.\n- A request to preview, explain, or explore a proposed interface inside the\n  conversation is a visualization request.\n- Create a visual only when the user needs to see or explore it and it\n  materially improves the explanation. Do not create one merely because the\n  request involves data, charts, or an interactive page.\n- Use a normal Markdown table when the user asks for a table; return it\n  directly and do not create a visualization file.\n- Use Mermaid when labeled nodes and edges fully explain a static structure;\n  return a normal fenced Mermaid block and no visualization file. Use HTML for\n  dynamics, spatial motion, adjustable inputs, and other visuals.\n- Work silently unless blocked or the user explicitly asks for progress. The\n  final response must be your first user-facing message.\n- In user-facing prose, describe only what the visual helps the user see or\n  decide. Keep it concise; never announce this skill, HTML, scripts, CDN\n  sources, or other implementation details.\n\n## Context compaction\n\nCopy into every compaction summary:\n`Reload the full visualize skill before creating or updating a visualization.`\n\n## Locations\n\n- Resolve the active profile root from `$HERMES_HOME`.\n- Skill directory (scripts + assets live here):\n  `$HERMES_HOME\u002Fskills\u002Fvisualization\u002Fvisualize\u002F`\n- Default visualization directory (durable, outside any repo):\n  `$HERMES_HOME\u002Fvisualizations\u002F\u003Ctitle>\u002F`\n  Inside a Kanban task use `$HERMES_KANBAN_WORKSPACE\u002Fvisualizations\u002F\u003Ctitle>\u002F`\n  instead, and put the final `.html` into `kanban_complete(artifacts=[...])`.\n- `\u003Ctitle>` is a concise ASCII lowercase-hyphenated name derived from the\n  request. Each visualization gets its own folder with `fragment.html` (the\n  editable source) and `\u003Ctitle>.html` (the rendered standalone document).\n\n## Fragment contract\n\n- Write only an HTML fragment: no `\u003C!doctype>`, `\u003Chtml>`, `\u003Chead>`, or\n  `\u003Cbody>`. The render script wraps it with the design-system CSS, the\n  tooltip\u002Ficon kit, and a strict CSP.\n- Write literal markup: use `\u003Cdiv class=\"card\">Hi\u003C\u002Fdiv>` plus a real newline,\n  never `\u003Cdiv class=\\\"card\\\">Hi\u003C\u002Fdiv>\\n`. Never embed the fragment in an\n  inline Python, JavaScript, or shell string. Read it back; rewrite literal\n  `\\\"` or `\\n`.\n- Keep CSS and JavaScript in the fragment only when base classes are\n  insufficient. Load static resources only from the CDN allowlist. Never use\n  `fetch`, XHR, WebSocket, or other API calls inside the fragment — download\n  any data (e.g. GeoJSON) with your own tools and inline it.\n- Give the fragment root a unique ID and select it with\n  `document.getElementById(...)`. Never derive the root from\n  `document.currentScript`; scripts may sit outside the root.\n- Keep visualizations under 1 MB. Aggregate, bin, downsample, reduce\n  precision, or drop unused fields from large inline datasets.\n- Check that JavaScript has no undefined identifiers, every queried element\n  exists, and the primary interaction updates the visual.\n\n## Render, verify, deliver\n\n1. Render the fragment to a standalone document:\n\n   ```bash\n   python3 \"$HERMES_HOME\u002Fskills\u002Fvisualization\u002Fvisualize\u002Fscripts\u002Frender.py\" \\\n     \u003Cabs>\u002Ffragment.html \u003Cabs>\u002F\u003Ctitle>.html\n   ```\n\n   The same script with `--serve` temporarily serves it on 127.0.0.1 for\n   browser inspection when a live look helps.\n\n2. Verify with headless screenshots at the design widths (736px always;\n   360px for anything responsive; 1024px when a wide layout is used):\n\n   ```bash\n   google-chrome --headless=new --disable-gpu --no-sandbox \\\n     --window-size=736,900 --hide-scrollbars \\\n     --screenshot=\u003Cabs>\u002F\u003Ctitle>-736.png file:\u002F\u002F\u003Cabs>\u002F\u003Ctitle>.html\n   ```\n\n   Inspect each screenshot with `vision_analyze` and fix blank basemaps,\n   clipped or overlapping labels, failed imports, and broken layout before\n   replying. If headless Chrome is unavailable, re-read the code carefully\n   and say the visual was not screenshot-verified.\n\n3. Deliver in the final message:\n   - `MEDIA:\u003Cabs>\u002F\u003Ctitle>.html` — the visualization itself. It arrives as a\n     document; opened in any browser it is fully interactive.\n   - `MEDIA:\u003Cabs>\u002F\u003Ctitle>-736.png` — a static preview so the result is\n     visible at a glance without opening the file.\n   - One short sentence about what the visual shows or lets you explore. If\n     interactivity is the point, say the file opens in a browser.\n   - Whenever you create or update a visualization, attach the rendered file\n     again in that same turn's response, even when reusing an earlier path.\n\n## External resources\n\n- The render script's CSP allows only `cdnjs.cloudflare.com`, `esm.sh`,\n  `cdn.jsdelivr.net`, `unpkg.com`, `fonts.googleapis.com`,\n  `fonts.gstatic.com`, and `fonts.bunny.net`. Other origins are blocked and\n  fail silently.\n\n## Exporting and publishing\n\n- The rendered `\u003Ctitle>.html` is already a self-contained standalone\n  document; handing over the file is the default \"export\".\n- Only when the user explicitly asks to publish or host an existing\n  visualization, use the `isolated-web-preview` skill to put it online. Do\n  not claim it was published until the live URL is verified.\n- A general website request is not an export: build it as a normal project,\n  outside this skill.\n\n## Composition\n\nChoose the smallest composition that fits.\n\n- Prefer interaction detail over permanent panels, toolbars, repeated legends,\n  or long stacks. Add only requested controls, use one mechanism per state,\n  and never invent search, filter, or reset controls.\n- Keep filters, selections, and other presentation-only interactions local to\n  the fragment. There is no callback channel from the file back to the agent:\n  for drill-down that would need agent investigation, highlight the selection\n  in the visual and prompt the user to ask in chat with the selected values.\n- Show only metrics that explain the requested behavior. Put live values in\n  control headers or on the visual before cards. Treat maxima as ceilings,\n  not targets. Never invent qualitative scores, status cards, or secondary\n  fact grids to fill space.\n\n### UI mockups\n\n- Use product and platform context already available in the conversation;\n  don't search the project to render a mockup. Match the product's chrome,\n  navigation, typography, colors, and content. If its design is unavailable,\n  infer one from the platform and request.\n- NEVER use visualization CSS variables or utility classes inside a mockup\n  (for example, `--card`, `--font-size-base`, `.card`, or `.btn`). Define\n  root-scoped, product-specific colors, typography, surfaces, and controls\n  instead. This rule overrides all general visualization guidance.\n- Keep only the surrounding surface transparent. Give product windows, cards,\n  menus, and popovers opaque backgrounds, and stack overlays above the\n  product content.\n- Follow the host's active appearance with product-specific\n  `light-dark(\u003Clight>, \u003Cdark>)` colors unless a fixed theme is requested.\n- **Contained mockup:** frame a component, dialog, small feature, or mobile\n  screen as a compact product surface.\n- **Full-page mockup:** render a desktop window, application shell, or page at\n  full width without an additional visualization card.\n- Put app-wide navigation and pickers in the app chrome, and local controls\n  in their component. Omit single-option pickers. Show realistic states, not\n  invented dashboards, filler cards, or oversized icons.\n\n### Interactive explainer or simulation\n\n- Use compact controls or status, one compact dominant visual, and at most\n  one single-line selected-state detail. Default to no summary cards; allow\n  up to three only when changing metrics are central.\n- Crop empty space and fit the available width. For step-throughs, add only\n  requested step controls and update one current visual; never add parameter\n  controls, formulas, metric cards, or side-by-side steps unless asked.\n\n### Graphs and plots\n\n- Use D3 for data-rich Cartesian or statistical plots and handwritten SVG for\n  simple, directly labeled values. Load the version-pinned approved-CDN\n  script `https:\u002F\u002Fcdn.jsdelivr.net\u002Fnpm\u002Fd3@7.9.0\u002Fdist\u002Fd3.min.js`.\n- Render the figure, legend, and subplots directly on the transparent host\n  surface. Frame only the SVG plot area; never wrap charts in `.card`,\n  rounded panels, filled backgrounds, or shadowed containers.\n- Give the figure a concise visible title. Render each Cartesian subplot in\n  its own responsive SVG with a matching `viewBox`, a thin frame, and visible\n  `text.axis-title[data-axis=\"x\"]` and `text.axis-title[data-axis=\"y\"]`\n  showing quantities and units.\n- Set each SVG `viewBox` from its own container's measured width, redraw with\n  `ResizeObserver`, and reserve at least 64px for the y axis. Never scale\n  down a fixed-width `viewBox`.\n- Derive padded domains with `d3.extent(...)` over all observations,\n  uncertainty, and references. Inset scale ranges for marker radii and keep\n  every path inside `rect[data-chart-frame]`; never draw endpoint connectors\n  outside the frame or guess or hard-code the domain.\n- After every draw, measure tick, axis, and value-label bounds together.\n  Leave 4px between labels, anchor edge labels inward, and remove optional\n  annotations first. At 360px, show at most four x ticks and stack panels.\n- Prefer `--viz-series-1` through `--viz-series-6` for chart series; use\n  `--foreground` and `--border` for neutrals, cycle the six series tokens\n  when more are needed, and never use literal or fallback colors. Give every\n  SVG label `fill: var(--foreground)` and `font-size: 12px`; never shrink\n  labels below 11 screen pixels. Stack subplots when their labels no longer\n  fit.\n- Keep observations, trends, and important values visible. Use bands for\n  dense uncertainty, whiskers for isolated estimates, and one compact,\n  wrapping legend. Render one real\n  `\u003Cbutton type=\"button\" aria-pressed=\"true\">` per series with a small\n  swatch and neutral text; toggle its line, markers, and tooltip row\n  together. Keep buttons transparent, borderless, and indistinguishable from\n  inline text; never use `.btn`, pills, badges, rounded borders, or filled\n  and selected backgrounds.\n- Share one root-relative, pointer-transparent\n  `\u003Cdiv class=\"tooltip\" role=\"tooltip\">` using `--popover` and\n  `--popover-foreground`. In each multi-series SVG, give the full-plot overlay\n  both `data-chart-hit` and `data-chart-hover-overlay=\"cross-series\"`. Keep\n  the `data-chart-hover-guide` at the exact cursor x, interpolate every\n  visible series there, and show one aligned `data-chart-hover-marker` and\n  tooltip row per visible series; never snap the guide to a nearby sample.\n- Find ordered observations with\n  `d3.bisector(d => d.x).center(values, x)`; never pass an accessor to\n  `d3.bisectCenter`.\n- Give isolated marks transparent `data-chart-hit` targets at least 32 screen\n  pixels across; use one nearest-point overlay for dense scatter.\n- For named numeric data and one-off analyses, start with the plot. Put\n  values and takeaways on its marks, axes, or annotations. Never add a KPI\n  row, controls, cards, or panels unless those UI elements are explicitly\n  requested.\n- For sequences or parallel work, use aligned lanes on one time axis. Encode\n  phase and resource in the marks; annotate totals, waits, and bottlenecks on\n  the axis or lanes, not above the plot.\n- For distributions or multi-metric comparisons, use shared-scale facets or\n  small multiples. Render every requested dimension simultaneously; never\n  hide one behind a toggle.\n\n### Maps\n\n- Let the map dominate the composition. Use at most one compact\n  selection\u002Fdetail area and only requested controls.\n- Always project published GeoJSON\u002FTopoJSON and sourced longitude\u002Flatitude\n  with `d3-geo`; never hard-code or hand-draw geographic outlines. Use\n  schematic maps only when asked.\n- For world countries, import\n  `https:\u002F\u002Fesm.sh\u002F@d3-maps\u002Fatlas@1.0.0\u002Fworld\u002Fcountries\u002Fcountries-110m` and\n  convert it with `topojson-client@3.1.0` using\n  `feature(world, world.objects.features).features`. Join input ISO3 directly\n  to `feature.properties.id`, which is already ISO3; do not convert it to\n  numbers.\n- For US states or counties, use\n  `https:\u002F\u002Fcdn.jsdelivr.net\u002Fnpm\u002Fus-atlas@3\u002Fcounties-10m.json\u002F+esm`. For\n  ZIP\u002FZCTA or city boundaries, download official Census or local open-data\n  GeoJSON with your own tools and inline it; do not guess sibling atlas paths\n  or import raw JSON as JavaScript.\n- Keep maps geographically legible: for local points, fetch published\n  neighborhood, street, or comparable geometry; a blank field or lone\n  administrative outline is not a basemap. Show the full city or region\n  behind points or partial choropleths, and frame the locations with modest\n  padding.\n- Include the verified geometry in the final HTML. Screenshot it before\n  replying and fix blank basemaps, failed imports, missing labels, or\n  unprojected points.\n\n### Dense categorical grid\n\n- Use one compact horizontal selected-item summary, then a grid with exactly\n  one readable identifier per cell, then one small legend. Render only that\n  identifier as visible cell text; put all other metadata in an accessible\n  label or one summary line, not badges or fact grids. Allow only selection\n  unless asked.\n\n### Part-to-whole or time allocation\n\n- Use compact metrics and one stacked chart of category allocation per\n  period. Never substitute totals-only bars or duplicate it as a heatmap and\n  totals chart.\n\n## Layout and accessibility\n\n- Use semantic HTML, keyboard-accessible controls, and concise labels.\n- Use `aria-live=\"polite\"` for dynamic results, selections, and simulator\n  updates. Use `role=\"alert\"` for validation errors. Do not announce every\n  hover or animation frame.\n- Keep the top-level surface transparent and unframed, and fill the available\n  width. Design for 736px (1024px when several compact panels must stay side\n  by side for direct comparison), and support widths down to 320px. Stack\n  side-by-side content when it no longer fits.\n- At every supported width, text, controls, cards, toolbars, and dynamic\n  content must fit without overlap or clipping. Reflow by stacking or\n  wrapping; use `.table-responsive` only when table columns cannot fit. Avoid\n  fixed outer widths, horizontal overflow, internal scrolling,\n  `position: fixed`, and viewport-height layouts — the file may be opened on\n  a phone.\n- Size every SVG from its actual container. At narrow widths, reduce ticks,\n  declutter annotations, and keep visible text at least 11 screen pixels;\n  never shrink a fixed-width `viewBox`.\n- Keep native tab order; never add `tabindex`.\n- Use native `button`, `input`, `select`, and `textarea` elements with\n  matching utilities; never recreate controls.\n- Keep browser or utility focus styles; never override them.\n\n## Typography\n\n- Scale type with `--font-size-base`. Use normal text by default and\n  `.text-small` only for secondary annotations (never below 11px).\n- `h1`, `h2`, and `h3` are available; use one concise visible heading for a\n  self-contained chart or graph, with short panel headings only when needed.\n  Do not restate the prompt or add a redundant title to other visualizations.\n- Use only weights `400` and `500`. Never set custom font sizes or line\n  heights.\n\n## Color\n\n- Make every fill, stroke, text, border, shadow, chart, and canvas color\n  theme-aware. Never hardcode light or dark palettes such as white panels,\n  off-white backgrounds, black text, slate strokes, or Tailwind color\n  literals.\n- Keep text readable against its actual background. Muted or secondary colors\n  must retain clear contrast; never use `.text-muted` inside `.card` or\n  another filled container unless its background preserves that contrast.\n- Available theme variables include `--background`, `--foreground`, `--card`,\n  `--card-foreground`, `--popover`, `--popover-foreground`, `--primary`,\n  `--primary-foreground`, `--secondary`, `--secondary-foreground`, `--muted`,\n  `--muted-foreground`, `--accent`, `--accent-foreground`, `--destructive`,\n  `--border`, `--input`, `--ring`, `--blue`, `--orange`, `--green`, `--red`,\n  `--purple`, and `--yellow`. Use `currentColor` inside SVG.\n- Never add decorative borders, outlines, or strokes to progress tracks,\n  meters, bars, stacked segments, or other filled quantitative marks. Use a\n  subtle neutral or translucent track and distinguish marks with fill,\n  contrast, spacing, or opacity.\n- Use `--viz-series-1` for one measure or active state. Use `--viz-series-2`\n  through `--viz-series-6` only for important persistent category, series, or\n  status identity; never give every peer a different color by default.\n  - For categorical tiles or nodes, prefer a soft low-opacity series fill\n    with a neutral or transparent border; never color every outline.\n  - Keep mappings stable and pair color with labels, shapes, or line styles.\n  - Secondary series colors are theme-derived; never assume hues or use them\n    decoratively.\n- When color encodes a category or series, apply it consistently to the\n  corresponding visual marks—not just the legend—and keep large-area fills\n  subtle.\n- Use series colors only for chart lines, marks, and legend swatches. Keep\n  values, axis text, and direct labels in `--foreground` or\n  `--muted-foreground`.\n- Keep chart grids and inactive structure thin and neutral. Use 1-2px neutral\n  structural paths; never thicken, dash, or double-stroke the whole\n  structure.\n- In each color pair, the base token is a surface and its `-foreground` token\n  is the content on that surface. Use `.btn-primary` for high-emphasis\n  actions; its neutral fill is supplied by the utility. Use `--primary` and\n  `--primary-foreground` for filled selected, active, or pressed controls.\n  Reserve `--accent` and `--accent-foreground` for subtle interactive\n  surfaces and soft highlights. Buttons with `aria-pressed=\"true\"`,\n  `aria-selected=\"true\"`, or `.is-selected` already use the primary pairing.\n\n## Design system\n\n- Let utilities own geometry, appearance, and interaction. Use the matching\n  utility for every button and form control. Never restyle utilities,\n  descendants, or pseudo-elements: no custom sizes, spacing, borders, radii,\n  shadows, colors, or interaction states.\n\n### Surfaces and layout\n\n- `.card`: The only card-like HTML surface. Use its base class unchanged for\n  a necessary numeric summary, selected-item summary, or bounded interactive\n  field. Before adding a fill, border, radius, or shadow to any layout\n  container, either use `.card` or leave it transparent and unframed; never\n  recreate card chrome on rows, panels, tiles, sections, or wrappers. Keep\n  charts, maps, diagrams, tables, controls, and the whole visualization\n  unframed. Never nest cards; show 2-4 summaries near the top only when\n  useful. Structural groupings and repeated content are not bounded\n  interactive fields. Organize them with layout or visual marks, not\n  container chrome.\n- `.viz-stat`: Use a summary `.card` with one muted label, one\n  `.viz-stat-value`, and at most one short context or delta line.\n- `.viz-grid`: Use for peer metrics or choices instead of a custom grid. It\n  creates as many equal-width columns as fit and stacks when narrow. Never\n  use it for the whole visual or a horizontally scrolling card row. Keep\n  groups to 2-3 columns at 736px and controls in a separate row.\n- `.viz-row`: Use as a wrapping horizontal group with centered related values\n  or inline actions that may wrap when narrow.\n- `.progress` + `.progress-bar`:\n  `\u003Cdiv class=\"progress\" role=\"progressbar\" aria-label=\"Progress\" aria-valuenow=\"25\" aria-valuemin=\"0\" aria-valuemax=\"100\">\u003Cdiv class=\"progress-bar\" style=\"width:25%\">\u003C\u002Fdiv>\u003C\u002Fdiv>`\n- `.viz-tile`: Add to a selectable dense-grid `.btn`; it stretches to fill\n  its grid cell, preserves category fill, and uses an accent ring instead of\n  solid selection. Never add another selected, pressed, border, outline, or\n  shadow rule.\n- `.viz-badge`: Use as a compact display-only accent pill for a short status,\n  category, or value; never as a button.\n- `.viz-controls`: Use as a wrapping row for controls affecting the same\n  visualization. Keep button groups compact. Put labeled fields directly\n  inside as `.form-label`; fields form at most two columns and stack when\n  narrow.\n\n### Controls\n\n- `.btn`: Use for a content-sized secondary action. Add `.btn-primary` for\n  one main action per control group or `.btn-ghost` for low emphasis.\n- `.btn-block`: Add to a `.btn` only when the action should intentionally\n  fill the available inline space. Never use it for ordinary row actions.\n- `\u003Ca>`: Use for links. Add `.btn` to style a link as a button.\n- `[data-tooltip]`: Use for concise supplementary plain text on static or\n  dynamic triggers; the render kit creates `.tooltip` elements. Keep\n  essential content visible and triggers labeled. Never use `title`, custom\n  markup, or initialization. Example:\n  `\u003Cbutton type=\"button\" data-tooltip=\"Reset view\">Reset\u003C\u002Fbutton>`.\n- `[data-tooltip-placement]`: Optionally prefer `top` (default), `right`,\n  `bottom`, or `left`; collision handling may flip it.\n- `.form-check`: Wrap a native checkbox or radio; pair `.form-check-input`\n  and `.form-check-label` with matching `id` and `for`.\n- `.form-switch`: Add to `.form-check` around a native checkbox.\n- `.form-control`: Pair a native text, file, or color input—or a\n  textarea—with `.form-label`.\n- `.form-control-color`: Add to `.form-control` for a compact native color\n  input.\n- `.form-select`: Pair a native select with `.form-label`.\n- `.form-range`: Pair a native range with a visible label; put its current\n  value and units immediately before it.\n\n### Tables\n\n- `.table`: Use on a semantic table for a quiet, unframed data view. It\n  provides wrapping cells and subtle horizontal dividers without vertical\n  gridlines. Use sentence case for headers.\n- `.table-responsive`: Wrap a table when its columns cannot fit at narrow\n  widths. It contains horizontal overflow without clipping the visualization.\n- `.table-sm`: Add to `.table` when more rows need to fit; it reduces cell\n  padding without shrinking text.\n- `.text-end`, `.text-center`, and `.text-nowrap`: Use inside `.table` for\n  numeric\u002Fend alignment, centered values, or values that must stay on one\n  line. Numeric cells use tabular figures when end-aligned.\n\n### Text\n\n- `.text-small`: Use for the smallest host-scaled secondary chart labels and\n  annotations, never below 11px or for essential content.\n- `.text-muted`: Use for secondary units, captions, timestamps, and context,\n  never essential values or labels.\n- `.text-destructive`: Use only for error or validation text the user needs\n  to notice or act on.\n- `\u003Ccode>`: Use for inline commands, file names, symbols, or short\n  references; put multiline code in `\u003Cpre>\u003Ccode>`.\n- `.sr-only`: Use for visually hidden accessible text.\n\n## Charts\n\n- Prefer inline SVG for simple charts and version-pinned approved-CDN\n  libraries when native interaction, scales, legends, or layout materially\n  improve the result.\n- Resolve theme colors before passing them to canvas or chart APIs that\n  cannot parse CSS variables or `light-dark(...)`; redraw when the theme\n  changes.\n- Use a tooltip unless it would distract from a simple, directly labeled\n  chart. Keep chart-library tooltips and grouped legend interactions native;\n  never replace them with a custom one-point tooltip. For SVG, attach\n  `data-tooltip` directly to the real pointer-accessible mark and include its\n  label, value, and units; the render kit handles themed positioning and\n  keyboard focus.\n- Animate transitions between chart states so lines and marks move to their\n  new values, resampling paths when point counts differ. Do not animate\n  initial appearance or use fade-only effects; never loop motion, and honor\n  `prefers-reduced-motion`.\n- Scope SVG styles to the chart class. Never target every `svg` in a\n  container that also contains Lucide icons.\n- Include labeled axes, units, and directly labeled important values. Give\n  every chart, SVG, canvas, and widget a concise screen-reader summary using\n  a role and accessible name or description, SVG `\u003Ctitle>`\u002F`\u003Cdesc>`, fallback\n  text, or an `.sr-only` heading or description.\n- Reserve space for the longest formatted label at every supported width.\n  Axis ticks are secondary and may use `.text-small` when space is tight.\n  Never overlap or clip text against marks, axes, legends, labels, or edges;\n  move or reduce labels rather than squeeze them.\n- Add a legend only when multiple series cannot be labeled directly.\n- Pair color with shape or text so meaning never depends on color alone.\n\n## Icons and mockups\n\n- Use the render-kit global `lucide`. Add an icon name with `data-lucide`:\n\n  ```html\n  \u003Ci data-lucide=\"search\" aria-hidden=\"true\">\u003C\u002Fi>\n  ```\n\n- Lucide replaces the placeholder in place with an inline SVG. Icons are 16px\n  and inherit `currentColor`.\n- Mark decorative icons `aria-hidden=\"true\"`. Put action icons inside labeled\n  controls; use a visible label or `aria-label` for icon-only actions.\n- Let the kit initialize static icons after the fragment without blocking\n  first render. After adding icons dynamically, use\n  `lucide.createIcons({ attrs: { width: 16, height: 16 } })`.\n- Never load Lucide or another icon library from the network yourself; the\n  kit already loads it from the CDN allowlist.\n- Use visibly labeled buttons and inputs for small interactions. Keep all\n  presentation-only interaction local to the fragment and make the first\n  render useful before input changes.\n- Use semantic controls, realistic spacing, and restrained chrome for\n  mockups. Never fake product screenshots when inspectable UI is needed.\n","# Visualize\n\nInteractive HTML visuals delivered in chat as a standalone `.html` attachment\nplus a screenshot preview. Use when the user wants to see how something works,\nmake simulators or labs, maps, plots, charts or graphs, comparisons, UI\nmockups, scenarios, adjustable inputs, and exploration beyond regular text.\nWorks on every Hermes surface (Telegram, Desktop) because the deliverable is\na file, not an inline widget.\n\n## When to use it\n\n- A request for a new standalone file, website, app page, component, or other\n  project change is not a visualization request, even when the deliverable\n  contains charts or interactive content.\n- A request to preview, explain, or explore a proposed interface inside the\n  conversation is a visualization request.\n- Create a visual only when the user needs to see or explore it and it\n  materially improves the explanation. Do not create one merely because the\n  request involves data, charts, or an interactive page.\n- Use a normal Markdown table when the user asks for a table; return it\n  directly and do not create a visualization file.\n- Use Mermaid when labeled nodes and edges fully explain a static structure;\n  return a normal fenced Mermaid block and no visualization file. Use HTML for\n  dynamics, spatial motion, adjustable inputs, and other visuals.\n- Work silently unless blocked or the user explicitly asks for progress. The\n  final response must be your first user-facing message.\n- In user-facing prose, describe only what the visual helps the user see or\n  decide. Keep it concise; never announce this skill, HTML, scripts, CDN\n  sources, or other implementation details.\n\n## Context compaction\n\nCopy into every compaction summary:\n`Reload the full visualize skill before creating or updating a visualization.`\n\n## Locations\n\n- Resolve the active profile root from `$HERMES_HOME`.\n- Skill directory (scripts + assets live here):\n  `$HERMES_HOME\u002Fskills\u002Fvisualization\u002Fvisualize\u002F`\n- Default visualization directory (durable, outside any repo):\n  `$HERMES_HOME\u002Fvisualizations\u002F\u003Ctitle>\u002F`\n  Inside a Kanban task use `$HERMES_KANBAN_WORKSPACE\u002Fvisualizations\u002F\u003Ctitle>\u002F`\n  instead, and put the final `.html` into `kanban_complete(artifacts=[...])`.\n- `\u003Ctitle>` is a concise ASCII lowercase-hyphenated name derived from the\n  request. Each visualization gets its own folder with `fragment.html` (the\n  editable source) and `\u003Ctitle>.html` (the rendered standalone document).\n\n## Fragment contract\n\n- Write only an HTML fragment: no `\u003C!doctype>`, `\u003Chtml>`, `\u003Chead>`, or\n  `\u003Cbody>`. The render script wraps it with the design-system CSS, the\n  tooltip\u002Ficon kit, and a strict CSP.\n- Write literal markup: use `\u003Cdiv class=\"card\">Hi\u003C\u002Fdiv>` plus a real newline,\n  never `\u003Cdiv class=\\\"card\\\">Hi\u003C\u002Fdiv>\\n`. Never embed the fragment in an\n  inline Python, JavaScript, or shell string. Read it back; rewrite literal\n  `\\\"` or `\\n`.\n- Keep CSS and JavaScript in the fragment only when base classes are\n  insufficient. Load static resources only from the CDN allowlist. Never use\n  `fetch`, XHR, WebSocket, or other API calls inside the fragment — download\n  any data (e.g. GeoJSON) with your own tools and inline it.\n- Give the fragment root a unique ID and select it with\n  `document.getElementById(...)`. Never derive the root from\n  `document.currentScript`; scripts may sit outside the root.\n- Keep visualizations under 1 MB. Aggregate, bin, downsample, reduce\n  precision, or drop unused fields from large inline datasets.\n- Check that JavaScript has no undefined identifiers, every queried element\n  exists, and the primary interaction updates the visual.\n\n## Render, verify, deliver\n\n1. Render the fragment to a standalone document:\n\n   ```bash\n   python3 \"$HERMES_HOME\u002Fskills\u002Fvisualization\u002Fvisualize\u002Fscripts\u002Frender.py\" \\\n     \u003Cabs>\u002Ffragment.html \u003Cabs>\u002F\u003Ctitle>.html\n   ```\n\n   The same script with `--serve` temporarily serves it on 127.0.0.1 for\n   browser inspection when a live look helps.\n\n2. Verify with headless screenshots at the design widths (736px always;\n   360px for anything responsive; 1024px when a wide layout is used):\n\n   ```bash\n   google-chrome --headless=new --disable-gpu --no-sandbox \\\n     --window-size=736,900 --hide-scrollbars \\\n     --screenshot=\u003Cabs>\u002F\u003Ctitle>-736.png file:\u002F\u002F\u003Cabs>\u002F\u003Ctitle>.html\n   ```\n\n   Inspect each screenshot with `vision_analyze` and fix blank basemaps,\n   clipped or overlapping labels, failed imports, and broken layout before\n   replying. If headless Chrome is unavailable, re-read the code carefully\n   and say the visual was not screenshot-verified.\n\n3. Deliver in the final message:\n   - `MEDIA:\u003Cabs>\u002F\u003Ctitle>.html` — the visualization itself. It arrives as a\n     document; opened in any browser it is fully interactive.\n   - `MEDIA:\u003Cabs>\u002F\u003Ctitle>-736.png` — a static preview so the result is\n     visible at a glance without opening the file.\n   - One short sentence about what the visual shows or lets you explore. If\n     interactivity is the point, say the file opens in a browser.\n   - Whenever you create or update a visualization, attach the rendered file\n     again in that same turn's response, even when reusing an earlier path.\n\n## External resources\n\n- The render script's CSP allows only `cdnjs.cloudflare.com`, `esm.sh`,\n  `cdn.jsdelivr.net`, `unpkg.com`, `fonts.googleapis.com`,\n  `fonts.gstatic.com`, and `fonts.bunny.net`. Other origins are blocked and\n  fail silently.\n\n## Exporting and publishing\n\n- The rendered `\u003Ctitle>.html` is already a self-contained standalone\n  document; handing over the file is the default \"export\".\n- Only when the user explicitly asks to publish or host an existing\n  visualization, use the `isolated-web-preview` skill to put it online. Do\n  not claim it was published until the live URL is verified.\n- A general website request is not an export: build it as a normal project,\n  outside this skill.\n\n## Composition\n\nChoose the smallest composition that fits.\n\n- Prefer interaction detail over permanent panels, toolbars, repeated legends,\n  or long stacks. Add only requested controls, use one mechanism per state,\n  and never invent search, filter, or reset controls.\n- Keep filters, selections, and other presentation-only interactions local to\n  the fragment. There is no callback channel from the file back to the agent:\n  for drill-down that would need agent investigation, highlight the selection\n  in the visual and prompt the user to ask in chat with the selected values.\n- Show only metrics that explain the requested behavior. Put live values in\n  control headers or on the visual before cards. Treat maxima as ceilings,\n  not targets. Never invent qualitative scores, status cards, or secondary\n  fact grids to fill space.\n\n### UI mockups\n\n- Use product and platform context already available in the conversation;\n  don't search the project to render a mockup. Match the product's chrome,\n  navigation, typography, colors, and content. If its design is unavailable,\n  infer one from the platform and request.\n- NEVER use visualization CSS variables or utility classes inside a mockup\n  (for example, `--card`, `--font-size-base`, `.card`, or `.btn`). Define\n  root-scoped, product-specific colors, typography, surfaces, and controls\n  instead. This rule overrides all general visualization guidance.\n- Keep only the surrounding surface transparent. Give product windows, cards,\n  menus, and popovers opaque backgrounds, and stack overlays above the\n  product content.\n- Follow the host's active appearance with product-specific\n  `light-dark(\u003Clight>, \u003Cdark>)` colors unless a fixed theme is requested.\n- **Contained mockup:** frame a component, dialog, small feature, or mobile\n  screen as a compact product surface.\n- **Full-page mockup:** render a desktop window, application shell, or page at\n  full width without an additional visualization card.\n- Put app-wide navigation and pickers in the app chrome, and local controls\n  in their component. Omit single-option pickers. Show realistic states, not\n  invented dashboards, filler cards, or oversized icons.\n\n### Interactive explainer or simulation\n\n- Use compact controls or status, one compact dominant visual, and at most\n  one single-line selected-state detail. Default to no summary cards; allow\n  up to three only when changing metrics are central.\n- Crop empty space and fit the available width. For step-throughs, add only\n  requested step controls and update one current visual; never add parameter\n  controls, formulas, metric cards, or side-by-side steps unless asked.\n\n### Graphs and plots\n\n- Use D3 for data-rich Cartesian or statistical plots and handwritten SVG for\n  simple, directly labeled values. Load the version-pinned approved-CDN\n  script `https:\u002F\u002Fcdn.jsdelivr.net\u002Fnpm\u002Fd3@7.9.0\u002Fdist\u002Fd3.min.js`.\n- Render the figure, legend, and subplots directly on the transparent host\n  surface. Frame only the SVG plot area; never wrap charts in `.card`,\n  rounded panels, filled backgrounds, or shadowed containers.\n- Give the figure a concise visible title. Render each Cartesian subplot in\n  its own responsive SVG with a matching `viewBox`, a thin frame, and visible\n  `text.axis-title[data-axis=\"x\"]` and `text.axis-title[data-axis=\"y\"]`\n  showing quantities and units.\n- Set each SVG `viewBox` from its own container's measured width, redraw with\n  `ResizeObserver`, and reserve at least 64px for the y axis. Never scale\n  down a fixed-width `viewBox`.\n- Derive padded domains with `d3.extent(...)` over all observations,\n  uncertainty, and references. Inset scale ranges for marker radii and keep\n  every path inside `rect[data-chart-frame]`; never draw endpoint connectors\n  outside the frame or guess or hard-code the domain.\n- After every draw, measure tick, axis, and value-label bounds together.\n  Leave 4px between labels, anchor edge labels inward, and remove optional\n  annotations first. At 360px, show at most four x ticks and stack panels.\n- Prefer `--viz-series-1` through `--viz-series-6` for chart series; use\n  `--foreground` and `--border` for neutrals, cycle the six series tokens\n  when more are needed, and never use literal or fallback colors. Give every\n  SVG label `fill: var(--foreground)` and `font-size: 12px`; never shrink\n  labels below 11 screen pixels. Stack subplots when their labels no longer\n  fit.\n- Keep observations, trends, and important values visible. Use bands for\n  dense uncertainty, whiskers for isolated estimates, and one compact,\n  wrapping legend. Render one real\n  `\u003Cbutton type=\"button\" aria-pressed=\"true\">` per series with a small\n  swatch and neutral text; toggle its line, markers, and tooltip row\n  together. Keep buttons transparent, borderless, and indistinguishable from\n  inline text; never use `.btn`, pills, badges, rounded borders, or filled\n  and selected backgrounds.\n- Share one root-relative, pointer-transparent\n  `\u003Cdiv class=\"tooltip\" role=\"tooltip\">` using `--popover` and\n  `--popover-foreground`. In each multi-series SVG, give the full-plot overlay\n  both `data-chart-hit` and `data-chart-hover-overlay=\"cross-series\"`. Keep\n  the `data-chart-hover-guide` at the exact cursor x, interpolate every\n  visible series there, and show one aligned `data-chart-hover-marker` and\n  tooltip row per visible series; never snap the guide to a nearby sample.\n- Find ordered observations with\n  `d3.bisector(d => d.x).center(values, x)`; never pass an accessor to\n  `d3.bisectCenter`.\n- Give isolated marks transparent `data-chart-hit` targets at least 32 screen\n  pixels across; use one nearest-point overlay for dense scatter.\n- For named numeric data and one-off analyses, start with the plot. Put\n  values and takeaways on its marks, axes, or annotations. Never add a KPI\n  row, controls, cards, or panels unless those UI elements are explicitly\n  requested.\n- For sequences or parallel work, use aligned lanes on one time axis. Encode\n  phase and resource in the marks; annotate totals, waits, and bottlenecks on\n  the axis or lanes, not above the plot.\n- For distributions or multi-metric comparisons, use shared-scale facets or\n  small multiples. Render every requested dimension simultaneously; never\n  hide one behind a toggle.\n\n### Maps\n\n- Let the map dominate the composition. Use at most one compact\n  selection\u002Fdetail area and only requested controls.\n- Always project published GeoJSON\u002FTopoJSON and sourced longitude\u002Flatitude\n  with `d3-geo`; never hard-code or hand-draw geographic outlines. Use\n  schematic maps only when asked.\n- For world countries, import\n  `https:\u002F\u002Fesm.sh\u002F@d3-maps\u002Fatlas@1.0.0\u002Fworld\u002Fcountries\u002Fcountries-110m` and\n  convert it with `topojson-client@3.1.0` using\n  `feature(world, world.objects.features).features`. Join input ISO3 directly\n  to `feature.properties.id`, which is already ISO3; do not convert it to\n  numbers.\n- For US states or counties, use\n  `https:\u002F\u002Fcdn.jsdelivr.net\u002Fnpm\u002Fus-atlas@3\u002Fcounties-10m.json\u002F+esm`. For\n  ZIP\u002FZCTA or city boundaries, download official Census or local open-data\n  GeoJSON with your own tools and inline it; do not guess sibling atlas paths\n  or import raw JSON as JavaScript.\n- Keep maps geographically legible: for local points, fetch published\n  neighborhood, street, or comparable geometry; a blank field or lone\n  administrative outline is not a basemap. Show the full city or region\n  behind points or partial choropleths, and frame the locations with modest\n  padding.\n- Include the verified geometry in the final HTML. Screenshot it before\n  replying and fix blank basemaps, failed imports, missing labels, or\n  unprojected points.\n\n### Dense categorical grid\n\n- Use one compact horizontal selected-item summary, then a grid with exactly\n  one readable identifier per cell, then one small legend. Render only that\n  identifier as visible cell text; put all other metadata in an accessible\n  label or one summary line, not badges or fact grids. Allow only selection\n  unless asked.\n\n### Part-to-whole or time allocation\n\n- Use compact metrics and one stacked chart of category allocation per\n  period. Never substitute totals-only bars or duplicate it as a heatmap and\n  totals chart.\n\n## Layout and accessibility\n\n- Use semantic HTML, keyboard-accessible controls, and concise labels.\n- Use `aria-live=\"polite\"` for dynamic results, selections, and simulator\n  updates. Use `role=\"alert\"` for validation errors. Do not announce every\n  hover or animation frame.\n- Keep the top-level surface transparent and unframed, and fill the available\n  width. Design for 736px (1024px when several compact panels must stay side\n  by side for direct comparison), and support widths down to 320px. Stack\n  side-by-side content when it no longer fits.\n- At every supported width, text, controls, cards, toolbars, and dynamic\n  content must fit without overlap or clipping. Reflow by stacking or\n  wrapping; use `.table-responsive` only when table columns cannot fit. Avoid\n  fixed outer widths, horizontal overflow, internal scrolling,\n  `position: fixed`, and viewport-height layouts — the file may be opened on\n  a phone.\n- Size every SVG from its actual container. At narrow widths, reduce ticks,\n  declutter annotations, and keep visible text at least 11 screen pixels;\n  never shrink a fixed-width `viewBox`.\n- Keep native tab order; never add `tabindex`.\n- Use native `button`, `input`, `select`, and `textarea` elements with\n  matching utilities; never recreate controls.\n- Keep browser or utility focus styles; never override them.\n\n## Typography\n\n- Scale type with `--font-size-base`. Use normal text by default and\n  `.text-small` only for secondary annotations (never below 11px).\n- `h1`, `h2`, and `h3` are available; use one concise visible heading for a\n  self-contained chart or graph, with short panel headings only when needed.\n  Do not restate the prompt or add a redundant title to other visualizations.\n- Use only weights `400` and `500`. Never set custom font sizes or line\n  heights.\n\n## Color\n\n- Make every fill, stroke, text, border, shadow, chart, and canvas color\n  theme-aware. Never hardcode light or dark palettes such as white panels,\n  off-white backgrounds, black text, slate strokes, or Tailwind color\n  literals.\n- Keep text readable against its actual background. Muted or secondary colors\n  must retain clear contrast; never use `.text-muted` inside `.card` or\n  another filled container unless its background preserves that contrast.\n- Available theme variables include `--background`, `--foreground`, `--card`,\n  `--card-foreground`, `--popover`, `--popover-foreground`, `--primary`,\n  `--primary-foreground`, `--secondary`, `--secondary-foreground`, `--muted`,\n  `--muted-foreground`, `--accent`, `--accent-foreground`, `--destructive`,\n  `--border`, `--input`, `--ring`, `--blue`, `--orange`, `--green`, `--red`,\n  `--purple`, and `--yellow`. Use `currentColor` inside SVG.\n- Never add decorative borders, outlines, or strokes to progress tracks,\n  meters, bars, stacked segments, or other filled quantitative marks. Use a\n  subtle neutral or translucent track and distinguish marks with fill,\n  contrast, spacing, or opacity.\n- Use `--viz-series-1` for one measure or active state. Use `--viz-series-2`\n  through `--viz-series-6` only for important persistent category, series, or\n  status identity; never give every peer a different color by default.\n  - For categorical tiles or nodes, prefer a soft low-opacity series fill\n    with a neutral or transparent border; never color every outline.\n  - Keep mappings stable and pair color with labels, shapes, or line styles.\n  - Secondary series colors are theme-derived; never assume hues or use them\n    decoratively.\n- When color encodes a category or series, apply it consistently to the\n  corresponding visual marks—not just the legend—and keep large-area fills\n  subtle.\n- Use series colors only for chart lines, marks, and legend swatches. Keep\n  values, axis text, and direct labels in `--foreground` or\n  `--muted-foreground`.\n- Keep chart grids and inactive structure thin and neutral. Use 1-2px neutral\n  structural paths; never thicken, dash, or double-stroke the whole\n  structure.\n- In each color pair, the base token is a surface and its `-foreground` token\n  is the content on that surface. Use `.btn-primary` for high-emphasis\n  actions; its neutral fill is supplied by the utility. Use `--primary` and\n  `--primary-foreground` for filled selected, active, or pressed controls.\n  Reserve `--accent` and `--accent-foreground` for subtle interactive\n  surfaces and soft highlights. Buttons with `aria-pressed=\"true\"`,\n  `aria-selected=\"true\"`, or `.is-selected` already use the primary pairing.\n\n## Design system\n\n- Let utilities own geometry, appearance, and interaction. Use the matching\n  utility for every button and form control. Never restyle utilities,\n  descendants, or pseudo-elements: no custom sizes, spacing, borders, radii,\n  shadows, colors, or interaction states.\n\n### Surfaces and layout\n\n- `.card`: The only card-like HTML surface. Use its base class unchanged for\n  a necessary numeric summary, selected-item summary, or bounded interactive\n  field. Before adding a fill, border, radius, or shadow to any layout\n  container, either use `.card` or leave it transparent and unframed; never\n  recreate card chrome on rows, panels, tiles, sections, or wrappers. Keep\n  charts, maps, diagrams, tables, controls, and the whole visualization\n  unframed. Never nest cards; show 2-4 summaries near the top only when\n  useful. Structural groupings and repeated content are not bounded\n  interactive fields. Organize them with layout or visual marks, not\n  container chrome.\n- `.viz-stat`: Use a summary `.card` with one muted label, one\n  `.viz-stat-value`, and at most one short context or delta line.\n- `.viz-grid`: Use for peer metrics or choices instead of a custom grid. It\n  creates as many equal-width columns as fit and stacks when narrow. Never\n  use it for the whole visual or a horizontally scrolling card row. Keep\n  groups to 2-3 columns at 736px and controls in a separate row.\n- `.viz-row`: Use as a wrapping horizontal group with centered related values\n  or inline actions that may wrap when narrow.\n- `.progress` + `.progress-bar`:\n  `\u003Cdiv class=\"progress\" role=\"progressbar\" aria-label=\"Progress\" aria-valuenow=\"25\" aria-valuemin=\"0\" aria-valuemax=\"100\">\u003Cdiv class=\"progress-bar\" style=\"width:25%\">\u003C\u002Fdiv>\u003C\u002Fdiv>`\n- `.viz-tile`: Add to a selectable dense-grid `.btn`; it stretches to fill\n  its grid cell, preserves category fill, and uses an accent ring instead of\n  solid selection. Never add another selected, pressed, border, outline, or\n  shadow rule.\n- `.viz-badge`: Use as a compact display-only accent pill for a short status,\n  category, or value; never as a button.\n- `.viz-controls`: Use as a wrapping row for controls affecting the same\n  visualization. Keep button groups compact. Put labeled fields directly\n  inside as `.form-label`; fields form at most two columns and stack when\n  narrow.\n\n### Controls\n\n- `.btn`: Use for a content-sized secondary action. Add `.btn-primary` for\n  one main action per control group or `.btn-ghost` for low emphasis.\n- `.btn-block`: Add to a `.btn` only when the action should intentionally\n  fill the available inline space. Never use it for ordinary row actions.\n- `\u003Ca>`: Use for links. Add `.btn` to style a link as a button.\n- `[data-tooltip]`: Use for concise supplementary plain text on static or\n  dynamic triggers; the render kit creates `.tooltip` elements. Keep\n  essential content visible and triggers labeled. Never use `title`, custom\n  markup, or initialization. Example:\n  `\u003Cbutton type=\"button\" data-tooltip=\"Reset view\">Reset\u003C\u002Fbutton>`.\n- `[data-tooltip-placement]`: Optionally prefer `top` (default), `right`,\n  `bottom`, or `left`; collision handling may flip it.\n- `.form-check`: Wrap a native checkbox or radio; pair `.form-check-input`\n  and `.form-check-label` with matching `id` and `for`.\n- `.form-switch`: Add to `.form-check` around a native checkbox.\n- `.form-control`: Pair a native text, file, or color input—or a\n  textarea—with `.form-label`.\n- `.form-control-color`: Add to `.form-control` for a compact native color\n  input.\n- `.form-select`: Pair a native select with `.form-label`.\n- `.form-range`: Pair a native range with a visible label; put its current\n  value and units immediately before it.\n\n### Tables\n\n- `.table`: Use on a semantic table for a quiet, unframed data view. It\n  provides wrapping cells and subtle horizontal dividers without vertical\n  gridlines. Use sentence case for headers.\n- `.table-responsive`: Wrap a table when its columns cannot fit at narrow\n  widths. It contains horizontal overflow without clipping the visualization.\n- `.table-sm`: Add to `.table` when more rows need to fit; it reduces cell\n  padding without shrinking text.\n- `.text-end`, `.text-center`, and `.text-nowrap`: Use inside `.table` for\n  numeric\u002Fend alignment, centered values, or values that must stay on one\n  line. Numeric cells use tabular figures when end-aligned.\n\n### Text\n\n- `.text-small`: Use for the smallest host-scaled secondary chart labels and\n  annotations, never below 11px or for essential content.\n- `.text-muted`: Use for secondary units, captions, timestamps, and context,\n  never essential values or labels.\n- `.text-destructive`: Use only for error or validation text the user needs\n  to notice or act on.\n- `\u003Ccode>`: Use for inline commands, file names, symbols, or short\n  references; put multiline code in `\u003Cpre>\u003Ccode>`.\n- `.sr-only`: Use for visually hidden accessible text.\n\n## Charts\n\n- Prefer inline SVG for simple charts and version-pinned approved-CDN\n  libraries when native interaction, scales, legends, or layout materially\n  improve the result.\n- Resolve theme colors before passing them to canvas or chart APIs that\n  cannot parse CSS variables or `light-dark(...)`; redraw when the theme\n  changes.\n- Use a tooltip unless it would distract from a simple, directly labeled\n  chart. Keep chart-library tooltips and grouped legend interactions native;\n  never replace them with a custom one-point tooltip. For SVG, attach\n  `data-tooltip` directly to the real pointer-accessible mark and include its\n  label, value, and units; the render kit handles themed positioning and\n  keyboard focus.\n- Animate transitions between chart states so lines and marks move to their\n  new values, resampling paths when point counts differ. Do not animate\n  initial appearance or use fade-only effects; never loop motion, and honor\n  `prefers-reduced-motion`.\n- Scope SVG styles to the chart class. Never target every `svg` in a\n  container that also contains Lucide icons.\n- Include labeled axes, units, and directly labeled important values. Give\n  every chart, SVG, canvas, and widget a concise screen-reader summary using\n  a role and accessible name or description, SVG `\u003Ctitle>`\u002F`\u003Cdesc>`, fallback\n  text, or an `.sr-only` heading or description.\n- Reserve space for the longest formatted label at every supported width.\n  Axis ticks are secondary and may use `.text-small` when space is tight.\n  Never overlap or clip text against marks, axes, legends, labels, or edges;\n  move or reduce labels rather than squeeze them.\n- Add a legend only when multiple series cannot be labeled directly.\n- Pair color with shape or text so meaning never depends on color alone.\n\n## Icons and mockups\n\n- Use the render-kit global `lucide`. Add an icon name with `data-lucide`:\n\n  ```html\n  \u003Ci data-lucide=\"search\" aria-hidden=\"true\">\u003C\u002Fi>\n  ```\n\n- Lucide replaces the placeholder in place with an inline SVG. Icons are 16px\n  and inherit `currentColor`.\n- Mark decorative icons `aria-hidden=\"true\"`. Put action icons inside labeled\n  controls; use a visible label or `aria-label` for icon-only actions.\n- Let the kit initialize static icons after the fragment without blocking\n  first render. After adding icons dynamically, use\n  `lucide.createIcons({ attrs: { width: 16, height: 16 } })`.\n- Never load Lucide or another icon library from the network yourself; the\n  kit already loads it from the CDN allowlist.\n- Use visibly labeled buttons and inputs for small interactions. Keep all\n  presentation-only interaction local to the fragment and make the first\n  render useful before input changes.\n- Use semantic controls, realistic spacing, and restrained chrome for\n  mockups. Never fake product screenshots when inspectable UI is needed.\n",{"name":5,"description":7},"main","116bb09f1369e85cd8a54fec4135e218dca4a061","skills\u002Fvisualization\u002Fvisualize",0,"https:\u002F\u002Fgithub.com\u002Fmerllinsbeard\u002Fmerlin-CTO","https:\u002F\u002Fgithub.com\u002Fmerllinsbeard\u002Fmerlin-CTO\u002Freleases\u002Flatest","https:\u002F\u002Fgithub.com\u002Fmerllinsbeard","ai","2026-08-25 21:36:43",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add merllinsbeard\u002Fmerlin-CTO --skill visualize",{"tool":39,"command":40},"bunx","bunx skills add merllinsbeard\u002Fmerlin-CTO --skill visualize",{"tool":42,"command":43},"pnpm","pnpm dlx skills add merllinsbeard\u002Fmerlin-CTO --skill visualize","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmerllinsbeard\u002Fmerlin-CTO\u002Fblob\u002Fmain\u002Fskills\u002Fvisualization\u002Fvisualize\u002FSKILL.md",true,[47,53,57],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"assets\u002Fvisualize.css","ASSET","资产文件",20462,"https:\u002F\u002Fgithub.com\u002Fmerllinsbeard\u002Fmerlin-CTO\u002Fblob\u002Fmain\u002Fskills\u002Fvisualization\u002Fvisualize\u002Fassets\u002Fvisualize.css",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"assets\u002Fvisualize.html",7503,"https:\u002F\u002Fgithub.com\u002Fmerllinsbeard\u002Fmerlin-CTO\u002Fblob\u002Fmain\u002Fskills\u002Fvisualization\u002Fvisualize\u002Fassets\u002Fvisualize.html",{"path":58,"resourceType":59,"resourceTypeDesc":60,"sizeBytes":61,"sourceHtmlUrl":62},"scripts\u002Frender.py","SCRIPT","脚本",5097,"https:\u002F\u002Fgithub.com\u002Fmerllinsbeard\u002Fmerlin-CTO\u002Fblob\u002Fmain\u002Fskills\u002Fvisualization\u002Fvisualize\u002Fscripts\u002Frender.py",[64,71,78,85,92,99],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M7B3SK15WA8JW4G6RBKZR3ME","writing-for-agents","Use for delegate_task, Kanban, and all agent-facing text.","https:\u002F\u002Fgithub.com\u002Fmerllinsbeard\u002Fmerlin-CTO\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M7B3SD78DTTXFVXGDPRK7249","why","Use for 'why does X work this way', 'why we picked Y', design rationale, regressions, postmortems, or data-backed thresholds. Discovers available MCPs and queries each evidence category (source control, issue tracker, long-form docs, real-time chat, infrastructure observability, error tracking, product analytics warehouse) in parallel, then returns a cited read on decisions and tradeoffs. Use how for runtime behavior.","https:\u002F\u002Fgithub.com\u002Fmerllinsbeard\u002Fmerlin-CTO\u002Fblob\u002Fmain\u002Fskills\u002Fwhy\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M7B3S8ENS1XQ7YV3N5GV1PCF","vue-best-practices","Use for Vue 3, .vue files, Vue Router, or Pinia. Skip when the repo has no Vue.","https:\u002F\u002Fgithub.com\u002Fmerllinsbeard\u002Fmerlin-CTO\u002Fblob\u002Fmain\u002Fskills\u002Fweb-development\u002Fvue-best-practices\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M7B3S2DPXMQN0EFFE8FTF03R","vercel-react-best-practices","React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React\u002FNext.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.","https:\u002F\u002Fgithub.com\u002Fmerllinsbeard\u002Fmerlin-CTO\u002Fblob\u002Fmain\u002Fskills\u002Fweb-development\u002Fvercel-react-best-practices\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M7B3S06K4AGG5X59TCX900R6","tailwind-v4","Use when writing or reviewing Tailwind CSS v4 classes or migrating v3 syntax.","https:\u002F\u002Fgithub.com\u002Fmerllinsbeard\u002Fmerlin-CTO\u002Fblob\u002Fmain\u002Fskills\u002Fweb-development\u002Ftailwind-v4\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":19},"01M7B3RXNDDCPJ7K5303BXXDTV","react-best-practices","Mastra React subset only. Generic React or Next uses vercel-react-best-practices.","https:\u002F\u002Fgithub.com\u002Fmerllinsbeard\u002Fmerlin-CTO\u002Fblob\u002Fmain\u002Fskills\u002Fweb-development\u002Freact-best-practices\u002FSKILL.md",[],[]]