[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CXX9RXMRB1ZHTRETSDVB8B":3,"skill-same:01M7CXX9RXMRB1ZHTRETSDVB8B":50},{"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":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":31,"ownerHtmlUrl":32,"ownerBlogUrl":33,"ownerDescription":34,"updatedAt":35,"install":36,"resources":49},"01M7CXX9RXMRB1ZHTRETSDVB8B","visual-output",null,"Emit rich visual output in chat via \u003Cwidget> tags — styled HTML cards, charts, tables, interactive tools, and drawn SVG\u002Fcanvas diagrams, illustrations, and animations — theme-aware, centered, and responsive instead of clashing or cramped.","Sidiora-Labs\u002Fcentra-gideon-agent","Sidiora-Labs","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F315858149?v=4","01M7CXSE0SZN9PME7BZ77KK2N7","Sidiora Labs","01M7CXSE1TJT3GJDJC6A9B7YD2",212,"Apache-2.0","https:\u002F\u002Fgithub.com\u002FSidiora-Labs\u002Fcentra-gideon-agent\u002Fblob\u002Fmain\u002Fruntime\u002Fgideon\u002Fextensions\u002Fskills\u002Fbundled\u002Fvisual-output\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: visual-output\ndescription: Emit rich visual output in chat via \u003Cwidget> tags — styled HTML cards, charts, tables, interactive tools, and drawn SVG\u002Fcanvas diagrams, illustrations, and animations — theme-aware, centered, and responsive instead of clashing or cramped.\ntriggers: widget, widget iframe, chart, table, visual, dashboard, render widget, illustration, diagram, draw, svg, animation, animate, graph, schematic, visualize, visual explanation, figure\ncontext_tier: heavy\n---\n\n# Visual Output\n\nGideon renders rich HTML inline in chat via `\u003Cwidget>` tags. The HTML runs\nin a sandboxed iframe that inherits the dashboard's active theme through CSS\nvariables. Get the styling contract right and a widget looks native on every\ntheme — light, dark, or custom. Get it wrong (hardcoded colors, fixed pixel\nsizes) and it clashes or renders tiny in a corner.\n\nThis skill covers both halves of visual output:\n- **The widget container** — format, theme variables, CSP, interactivity, and the\n  card design system (layout, spacing, type, surface, motion).\n- **Drawn visuals** — SVG\u002Fcanvas diagrams, schematics, charts, and animations,\n  and the craft of making them centered, proportioned, labelled, and legible.\n\n## Format\n\n```html\n\u003Cwidget title=\"Sales by Region\">\n  \u003Cdiv class=\"p-4 rounded-lg\" style=\"background: var(--card); color: var(--card-fg);\">\n    …content…\n  \u003C\u002Fdiv>\n\u003C\u002Fwidget>\n```\n\n- One widget per payload, self-contained.\n- Tailwind CSS is available inside the iframe.\n- For large HTML (long dashboards, big tables), save it to a file or an\n  Artifact (see the `artifacts` skill) and reference it — don't inline hundreds\n  of lines into the chat.\n\n## Design system — make it look intentional\n\nThe difference between a widget that looks native and one that looks slapped\ntogether is **consistent layout, spacing, type, and alignment**. Follow these.\n\n### Layout & alignment\n\n- **Cap the width and center it.** Wrap content in `max-w-md`\u002F`max-w-xl`\u002F`max-w-2xl`\n  (pick by density) with `mx-auto`. A widget that sprawls full-width in a wide\n  chat reads as broken. Dashboards: `max-w-3xl`; a single stat\u002Fcard: `max-w-sm`.\n- **One alignment spine.** Left-align text content; center only standalone figures\n  (charts, single big numbers, illustrations). Don't mix center + left in one card.\n- **Use a grid for multi-item layouts** — `grid grid-cols-2 gap-3` (or `gap-4`),\n  not floats or ad-hoc margins. Equal gaps everywhere; let the grid do alignment.\n- **Group related, separate unrelated** with whitespace + hairline dividers\n  (`border-t border-[var(--border)]`), not boxes-within-boxes.\n\n### Spacing rhythm (4px scale)\n\nStick to a consistent scale so spacing feels deliberate: `gap-2`(8) `gap-3`(12)\n`gap-4`(16); padding `p-4`\u002F`p-5` for cards, `p-3` for compact rows. Pick ONE card\npadding and one gap size per widget and reuse them. Avoid arbitrary `mt-[7px]`.\n\n### Typography hierarchy\n\n- **Title** of the widget content: `text-base font-semibold` (or `text-lg` for a\n  hero), `var(--text-strong)`.\n- **Body**: `text-sm`, `var(--text)`. **Captions\u002Flabels**: `text-xs`,\n  `var(--muted)`. **Big stat numbers**: `text-2xl`\u002F`text-3xl font-semibold tabular-nums`.\n- Max ~2 type sizes per card beyond the title. Use weight + color for hierarchy,\n  not many sizes. `tabular-nums` for any aligned numbers\u002Ftables.\n\n### Surface & depth\n\n- Cards: `rounded-lg` (or `rounded-xl` for hero), `bg-[var(--card)]`,\n  `border border-[var(--border)]`. One elevation level — don't nest cards 3 deep.\n- Subtle, not heavy: prefer a hairline border + tint over big shadows.\n\n### Motion\n\n- Use CSS `transition`\u002F`@keyframes` (no JS needed for most). Easing\n  `cubic-bezier(0.2,0,0,1)` (or `ease-in-out`); **150–300ms** for UI transitions,\n  2–6s for ambient loops. Animate `opacity`\u002F`transform` only (cheap, smooth).\n- Reveal-on-load is fine once; avoid perpetual motion unless it's the point\n  (a live pulse\u002Forbit). Always honor reduced-motion:\n  ```css\n  @media (prefers-reduced-motion: reduce){*{animation:none!important;transition:none!important}}\n  ```\n\n## Theme variables — use these, never hardcoded colors\n\nThe iframe injects the active theme's palette as CSS custom properties. Style\n**everything** with them (directly via `style=\"…: var(--x)\"` or Tailwind\narbitrary values like `bg-[var(--card)]`) so the widget tracks the theme:\n\n| Variable | Use for |\n|---|---|\n| `var(--bg)` | page \u002F outermost background |\n| `var(--text)` | default body text |\n| `var(--card)` \u002F `var(--card-fg)` | panel surface \u002F text on it |\n| `var(--border)` | hairlines, dividers, input borders |\n| `var(--accent)` \u002F `var(--accent-hover)` | primary actions, links, highlights |\n| `var(--muted)` \u002F `var(--muted-strong)` | secondary \u002F tertiary text |\n| `var(--text-strong)` | emphasized headings |\n| `var(--bg-elevated)` \u002F `var(--bg-hover)` | raised surfaces \u002F hover states |\n| `var(--border-strong)` | stronger separators |\n| `var(--ok)` \u002F `var(--warn)` \u002F `var(--danger)` \u002F `var(--info)` | status colors |\n| `var(--accent-subtle)` \u002F `var(--ok-subtle)` \u002F `var(--warn-subtle)` \u002F `var(--danger-subtle)` | tinted fills\u002Fbadges |\n\n**Never** use `bg-gray-900`, `text-white`, `#fff`, or any hardcoded hex — they\nbreak on the opposite theme. Zero hardcoded colors.\n\n## Allowed scripts (CSP)\n\nThe iframe's Content-Security-Policy restricts `script-src` to inline scripts\nplus these CDNs only:\n\n- **Tailwind** — `https:\u002F\u002Fcdn.tailwindcss.com` (preloaded; classes work out of the box)\n- `https:\u002F\u002Fcdn.jsdelivr.net`\n- `https:\u002F\u002Fcdnjs.cloudflare.com`\n\nLoad charting\u002Fvisualization libs (e.g. Chart.js) from jsDelivr or cdnjs. Scripts\nfrom any other origin are blocked. `connect-src` is `'none'` — widgets can't make\nnetwork calls; render data you already have.\n\n## Interactive widgets\n\nWidgets send events back to the agent. Add `data-action` (and optional\n`data-payload`, a JSON string) to any clickable element:\n\n```html\n\u003Cbutton data-action=\"approve\" data-payload='{\"id\":\"123\"}'>Approve\u003C\u002Fbutton>\n```\n\nOn click, the dashboard auto-submits a user message: `[UI] approve: {\"id\":\"123\"}`.\nYou receive it as the next turn and can respond with text, a new widget, or both.\n\n**Forms:** inputs with a `name` attribute are auto-collected on click and merged\ninto the payload as `formData`. Use this for creation forms — render pre-filled\ninputs, the user adjusts values, clicks submit, and you receive every field:\n\n```html\n\u003Cinput name=\"title\" value=\"Untitled\" class=\"px-2.5 py-2 rounded-md\"\n       style=\"background: var(--bg-elevated); color: var(--text); border: 1px solid var(--border);\" \u002F>\n\u003Cbutton data-action=\"create_task\">Create\u003C\u002Fbutton>\n```\n\n**Living views (auto-refresh).** A widget can be a *living dashboard* that pulls fresh\ndata on demand instead of freezing a snapshot at creation. Give it a refresh button:\n\n```html\n\u003Cbutton data-action=\"refresh\">Refresh\u003C\u002Fbutton>\n```\n\nWhen the widget has been **saved as an artifact** (it has a stable slug), the dashboard\nappends `(refresh artifact \"\u003Cslug>\" in place)` to the `[UI] refresh` message it sends you.\nOn that turn: re-fetch the current data (call the tools\u002Fsearches that produced it), then\n`artifact_update(\"\u003Cslug>\", ...)` with the freshly-rendered HTML — the SAME artifact\nupdates in place (versioned), so the open view re-renders with live data rather than\nspawning a new artifact. This is how you build a \"my open items\" \u002F \"current status\"\ndashboard that stays current. (If the widget isn't a saved artifact yet, save it first so\nit has a slug to refresh.)\n\n## Tunable parameters (EDITMODE) — let the user restyle without asking you\n\nA widget can declare its own **tunables**. The dashboard turns them into typed\ncontrols beside the render, and dragging one restyles the widget instantly — no\nturn, no request, no cost to you. This is how a user gets \"a bit more rounded,\nslightly warmer accent\" without spending a message on it.\n\nDeclare them ONCE, as a marker-fenced JSON object inside the widget's own script:\n\n```html\n\u003Cwidget title=\"Sales\">\n  \u003Cstyle>\n    #card { background: var(--card); border-radius: var(--radius); border: 1px solid var(--accent) }\n  \u003C\u002Fstyle>\n  \u003Cdiv id=\"card\">…\u003C\u002Fdiv>\n  \u003Cscript>\n  \u002F*EDITMODE-BEGIN*\u002F{\n    \"radius\": {\"label\": \"Corners\", \"type\": \"range\", \"value\": \"12px\",\n               \"min\": 0, \"max\": 32, \"step\": 2, \"unit\": \"px\"},\n    \"accent\": {\"label\": \"Accent\",  \"type\": \"color\", \"value\": \"#3b82f6\"}\n  }\u002F*EDITMODE-END*\u002F\n  \u003C\u002Fscript>\n\u003C\u002Fwidget>\n```\n\n- **Each key is a `:root` CSS custom property, minus the `--`.** `\"radius\"` drives\n  `var(--radius)`. Reference every tunable through `var(--key)` in your CSS —\n  a value the stylesheet doesn't read is a control that appears to do nothing.\n- **The markers are exact**: `\u002F*EDITMODE-BEGIN*\u002F` … `\u002F*EDITMODE-END*\u002F`, one block per\n  widget, JSON object between them. Put it inside a `\u003Cscript>` so it never renders.\n- **≤ 8 parameters.** More than eight means the widget should be using theme\n  variables rather than inventing its own, and a rail nobody can scan. Extras are\n  dropped, visibly.\n- **Four types**, each with the fields it needs:\n\n  | `type` | fields | control |\n  |---|---|---|\n  | `color` | `value` (`#rrggbb`) | swatch + native picker |\n  | `range` | `value`, `min`, `max`, `step?`, `unit?` | slider |\n  | `select` | `value`, `options` (≥2 CSS strings) | dropdown |\n  | `toggle` | `value`, `on`, `off` (CSS strings) | switch |\n\n- **Values are CSS strings** and are validated: no semicolons, braces, quotes, or\n  `url()`. A descriptor that fails validation loses its control; the widget still\n  renders.\n- **You author the block; the dashboard owns it afterwards.** When the user saves\n  their tweaks, the dashboard rewrites the `value` fields in place and cuts a new\n  artifact version. Everything outside the markers is untouched, and your other\n  fields survive. So when you REGENERATE a widget that already had tunables, keep\n  the same keys and carry the current values across — otherwise you throw away\n  choices the user already made.\n\n## Marked-up corrections you will receive\n\nOn a rendered widget the user can switch on **Mark elements**, click the parts that\nare wrong, and write one short note per element. You receive ONE turn:\n\n````text\n[UI] correction: 2 elements marked — regenerate the artifact applying every change\nbelow, and change nothing else\n```corrections\n1. selector: [data-testid=\"cta\"]\n   within: section[id=\"hero\"]\n   element: \u003Cbutton data-testid=\"cta\">Buy\u003C\u002Fbutton>\n   change: make this green\n2. selector: p.price\n   within: section[id=\"hero\"]\n   element: \u003Cp class=\"price\">$9\u003C\u002Fp>\n   change: bigger\n```\n````\n\nTreat it literally: apply every listed change, change nothing else, and if the\nwidget is a saved artifact (the message ends with `refresh artifact \"\u003Cslug>\" in\nplace`) write the result back to THAT slug with `artifact_update`. Giving elements\na `data-testid` makes these anchors stable and unambiguous — worth doing on the\nhandful of elements a user is likely to want changed.\n\n## Sizing conventions\n\n- Buttons: `text-xs py-1.5 px-3.5 rounded-md`\n- Labels: `text-[11px]`\n- Inputs: `text-sm px-2.5 py-2 rounded-md`\n\n## Links\n\nRender bare URLs as anchors. Always open external links safely and style them\nwith the accent color:\n\n```html\n\u003Ca href=\"https:\u002F\u002Fexample.com\" target=\"_blank\" rel=\"noopener noreferrer\"\n   style=\"color: var(--accent);\">example.com\u003C\u002Fa>\n```\n\n## Drawn visuals — SVG, diagrams, illustrations, animations\n\nDrawn visuals are emitted **inside a `\u003Cwidget>`** (same container, theme vars, and\nCSP as above). The container is easy; the craft is making the drawing itself\n**centered, correctly proportioned, theme-aware, labelled, and legible** rather\nthan cramped, clipped, or off-canvas.\n\n> The #1 failure is a fixed-size `\u003Csvg width=\"350\" height=\"200\">` that renders\n> tiny in a corner. Always make the SVG responsive and centered (below).\n\n### The responsive-SVG contract (use every time)\n\n```html\n\u003Cwidget title=\"…\">\n  \u003Cdiv style=\"max-width: 640px; margin: 0 auto;\">\n    \u003Csvg viewBox=\"0 0 640 360\" width=\"100%\" height=\"auto\"\n         preserveAspectRatio=\"xMidYMid meet\" role=\"img\" aria-label=\"…describe it…\"\n         style=\"display:block\">\n      …\n    \u003C\u002Fsvg>\n  \u003C\u002Fdiv>\n\u003C\u002Fwidget>\n```\n\n- **`viewBox` defines the coordinate space; `width=\"100%\"` makes it scale.** Never\n  set a fixed pixel `width`\u002F`height` on the `\u003Csvg>` — it won't be responsive.\n- **`preserveAspectRatio=\"xMidYMid meet\"`** centers + fits without distortion.\n- **`display:block` + `margin:0 auto`** on a `max-width` wrapper centers it and\n  caps it so it doesn't sprawl edge-to-edge in a wide chat.\n- Pick a viewBox aspect that fits the content: 16:9 (`640 360`) for scenes, 1:1\n  (`400 400`) for cycles\u002Fradial, 3:1 (`720 240`) for timelines\u002Fflows.\n- Leave **internal padding** — keep real content within ~6–8% of each edge so\n  strokes and labels never touch the frame.\n\n### Theme-aware drawing — no hardcoded colors\n\nStyle strokes\u002Ffills with the theme vars (injected into the iframe, same as above):\n\n- structural lines \u002F axes \u002F grids → `var(--border)` (thin, 0.5–1px)\n- primary subject \u002F data → `var(--accent)`\n- secondary \u002F supporting → `var(--muted)`\n- emphasis \u002F alert → `var(--danger)`; positive → `var(--ok)`\n- text labels → `var(--text)`, secondary labels → `var(--muted)`\n- filled regions → `var(--accent-subtle)` \u002F tinted fills, never opaque black\u002Fwhite\n\nPut shared style in one `\u003Cstyle>` block with classes (`.axis{stroke:var(--border)}`)\nrather than repeating `stroke=` on every element — easier to keep consistent.\n\n### Alignment & composition\n\n- **Establish a grid mentally**: align elements to consistent x\u002Fy coordinates;\n  don't eyeball. Equal gaps read as intentional; ragged gaps read as broken.\n- **Center the focal point** in the viewBox; balance mass around it.\n- **Label directly** where possible (label next to the thing) over distant\n  legends; when a legend is needed, align it to a consistent edge with even rows.\n- **Text**: `font: 14px\u002F1.4 -apple-system, sans-serif;` for body labels, ~12px for\n  captions; use `text-anchor=\"middle\"` for centered labels under a node and\n  `dominant-baseline=\"middle\"` for vertical centering. Never rely on the default\n  baseline for centered text.\n- Round coordinates to whole\u002Fhalf pixels for crisp strokes.\n\n### Animating a drawing\n\n- Prefer **CSS animations \u002F transitions** (in the `\u003Cstyle>` block) or **SMIL**\n  (`\u003Canimate>`, `\u003CanimateTransform>`) — both run in the sandbox without extra libs.\n- **Easing + duration**: ease-in-out, 200–600ms for transitions, 2–6s loops for\n  ambient motion. Avoid linear unless it's a steady cycle (rotation, orbit).\n- **Loop with intent**: `animation-iteration-count: infinite` only for genuinely\n  ambient visuals (waves, pulses, orbits). One-shot reveals should play once.\n- **Layer rhythms**: when animating multiple elements, offset their delays\u002Fdurations\n  slightly so motion feels organic, not mechanically synchronized.\n- **Respect reduced-motion** (same media query as the card motion section above).\n- Keep it subtle — motion should clarify (show flow, change, cause→effect), not\n  distract. If the still image already communicates, don't animate.\n\n### Charts\n\n- For data charts prefer **Chart.js** (load from jsDelivr — see CSP above) over\n  hand-drawn SVG bars; pass theme-var colors into the dataset config so it tracks\n  the theme. Give the canvas a fixed-aspect wrapper (`position:relative; height:0;\n  padding-bottom:56.25%`) so it's responsive.\n- Always title the axes + the chart; never render a chart with unlabelled axes.\n\n## Cost discipline\n\nPrefer plain markdown by default. Promote to a widget only when styled HTML\ncommunicates clearly better — charts, color-coded tables, styled cards, visual\nsummaries, diagrams, or simple interactive tools. Don't wrap a paragraph in a widget.\n\nThe dashboard's `widget_density` setting (`more` \u002F `less`, default `more`)\nsignals how freely to reach for widgets; on `less`, use them only when markdown\nis plainly insufficient.\n\n## Quality checklist (before emitting)\n\n1. **Width capped + centered** (`max-w-* mx-auto`, or `max-width` wrapper for SVG)\n   — not sprawling full-width?\n2. **Consistent spacing** — one card padding + one gap size, on the 4px scale?\n3. **Type hierarchy** — clear title vs body vs caption via size\u002Fweight\u002Fcolor, ≤2\n   extra sizes? Numbers `tabular-nums`?\n4. **Aligned** — multi-item layouts on a grid with equal gaps, one alignment spine?\n5. **Zero hardcoded colors** — every color a theme var, looks right light + dark?\n6. **One elevation** — no cards nested 3 deep; hairline borders over heavy shadows?\n7. **Motion** (if any) — eased, 150–300ms (or 2–6s ambient), purposeful,\n   reduced-motion-safe?\n8. **Drawing a figure?** Responsive `viewBox` + `width=\"100%\"` (no fixed px),\n   centered, content inside the frame with breathing room, labels legible and\n   correctly centered? Reads clearly at half size on both themes?\n","# Visual Output\n\nGideon renders rich HTML inline in chat via `\u003Cwidget>` tags. The HTML runs\nin a sandboxed iframe that inherits the dashboard's active theme through CSS\nvariables. Get the styling contract right and a widget looks native on every\ntheme — light, dark, or custom. Get it wrong (hardcoded colors, fixed pixel\nsizes) and it clashes or renders tiny in a corner.\n\nThis skill covers both halves of visual output:\n- **The widget container** — format, theme variables, CSP, interactivity, and the\n  card design system (layout, spacing, type, surface, motion).\n- **Drawn visuals** — SVG\u002Fcanvas diagrams, schematics, charts, and animations,\n  and the craft of making them centered, proportioned, labelled, and legible.\n\n## Format\n\n```html\n\u003Cwidget title=\"Sales by Region\">\n  \u003Cdiv class=\"p-4 rounded-lg\" style=\"background: var(--card); color: var(--card-fg);\">\n    …content…\n  \u003C\u002Fdiv>\n\u003C\u002Fwidget>\n```\n\n- One widget per payload, self-contained.\n- Tailwind CSS is available inside the iframe.\n- For large HTML (long dashboards, big tables), save it to a file or an\n  Artifact (see the `artifacts` skill) and reference it — don't inline hundreds\n  of lines into the chat.\n\n## Design system — make it look intentional\n\nThe difference between a widget that looks native and one that looks slapped\ntogether is **consistent layout, spacing, type, and alignment**. Follow these.\n\n### Layout & alignment\n\n- **Cap the width and center it.** Wrap content in `max-w-md`\u002F`max-w-xl`\u002F`max-w-2xl`\n  (pick by density) with `mx-auto`. A widget that sprawls full-width in a wide\n  chat reads as broken. Dashboards: `max-w-3xl`; a single stat\u002Fcard: `max-w-sm`.\n- **One alignment spine.** Left-align text content; center only standalone figures\n  (charts, single big numbers, illustrations). Don't mix center + left in one card.\n- **Use a grid for multi-item layouts** — `grid grid-cols-2 gap-3` (or `gap-4`),\n  not floats or ad-hoc margins. Equal gaps everywhere; let the grid do alignment.\n- **Group related, separate unrelated** with whitespace + hairline dividers\n  (`border-t border-[var(--border)]`), not boxes-within-boxes.\n\n### Spacing rhythm (4px scale)\n\nStick to a consistent scale so spacing feels deliberate: `gap-2`(8) `gap-3`(12)\n`gap-4`(16); padding `p-4`\u002F`p-5` for cards, `p-3` for compact rows. Pick ONE card\npadding and one gap size per widget and reuse them. Avoid arbitrary `mt-[7px]`.\n\n### Typography hierarchy\n\n- **Title** of the widget content: `text-base font-semibold` (or `text-lg` for a\n  hero), `var(--text-strong)`.\n- **Body**: `text-sm`, `var(--text)`. **Captions\u002Flabels**: `text-xs`,\n  `var(--muted)`. **Big stat numbers**: `text-2xl`\u002F`text-3xl font-semibold tabular-nums`.\n- Max ~2 type sizes per card beyond the title. Use weight + color for hierarchy,\n  not many sizes. `tabular-nums` for any aligned numbers\u002Ftables.\n\n### Surface & depth\n\n- Cards: `rounded-lg` (or `rounded-xl` for hero), `bg-[var(--card)]`,\n  `border border-[var(--border)]`. One elevation level — don't nest cards 3 deep.\n- Subtle, not heavy: prefer a hairline border + tint over big shadows.\n\n### Motion\n\n- Use CSS `transition`\u002F`@keyframes` (no JS needed for most). Easing\n  `cubic-bezier(0.2,0,0,1)` (or `ease-in-out`); **150–300ms** for UI transitions,\n  2–6s for ambient loops. Animate `opacity`\u002F`transform` only (cheap, smooth).\n- Reveal-on-load is fine once; avoid perpetual motion unless it's the point\n  (a live pulse\u002Forbit). Always honor reduced-motion:\n  ```css\n  @media (prefers-reduced-motion: reduce){*{animation:none!important;transition:none!important}}\n  ```\n\n## Theme variables — use these, never hardcoded colors\n\nThe iframe injects the active theme's palette as CSS custom properties. Style\n**everything** with them (directly via `style=\"…: var(--x)\"` or Tailwind\narbitrary values like `bg-[var(--card)]`) so the widget tracks the theme:\n\n| Variable | Use for |\n|---|---|\n| `var(--bg)` | page \u002F outermost background |\n| `var(--text)` | default body text |\n| `var(--card)` \u002F `var(--card-fg)` | panel surface \u002F text on it |\n| `var(--border)` | hairlines, dividers, input borders |\n| `var(--accent)` \u002F `var(--accent-hover)` | primary actions, links, highlights |\n| `var(--muted)` \u002F `var(--muted-strong)` | secondary \u002F tertiary text |\n| `var(--text-strong)` | emphasized headings |\n| `var(--bg-elevated)` \u002F `var(--bg-hover)` | raised surfaces \u002F hover states |\n| `var(--border-strong)` | stronger separators |\n| `var(--ok)` \u002F `var(--warn)` \u002F `var(--danger)` \u002F `var(--info)` | status colors |\n| `var(--accent-subtle)` \u002F `var(--ok-subtle)` \u002F `var(--warn-subtle)` \u002F `var(--danger-subtle)` | tinted fills\u002Fbadges |\n\n**Never** use `bg-gray-900`, `text-white`, `#fff`, or any hardcoded hex — they\nbreak on the opposite theme. Zero hardcoded colors.\n\n## Allowed scripts (CSP)\n\nThe iframe's Content-Security-Policy restricts `script-src` to inline scripts\nplus these CDNs only:\n\n- **Tailwind** — `https:\u002F\u002Fcdn.tailwindcss.com` (preloaded; classes work out of the box)\n- `https:\u002F\u002Fcdn.jsdelivr.net`\n- `https:\u002F\u002Fcdnjs.cloudflare.com`\n\nLoad charting\u002Fvisualization libs (e.g. Chart.js) from jsDelivr or cdnjs. Scripts\nfrom any other origin are blocked. `connect-src` is `'none'` — widgets can't make\nnetwork calls; render data you already have.\n\n## Interactive widgets\n\nWidgets send events back to the agent. Add `data-action` (and optional\n`data-payload`, a JSON string) to any clickable element:\n\n```html\n\u003Cbutton data-action=\"approve\" data-payload='{\"id\":\"123\"}'>Approve\u003C\u002Fbutton>\n```\n\nOn click, the dashboard auto-submits a user message: `[UI] approve: {\"id\":\"123\"}`.\nYou receive it as the next turn and can respond with text, a new widget, or both.\n\n**Forms:** inputs with a `name` attribute are auto-collected on click and merged\ninto the payload as `formData`. Use this for creation forms — render pre-filled\ninputs, the user adjusts values, clicks submit, and you receive every field:\n\n```html\n\u003Cinput name=\"title\" value=\"Untitled\" class=\"px-2.5 py-2 rounded-md\"\n       style=\"background: var(--bg-elevated); color: var(--text); border: 1px solid var(--border);\" \u002F>\n\u003Cbutton data-action=\"create_task\">Create\u003C\u002Fbutton>\n```\n\n**Living views (auto-refresh).** A widget can be a *living dashboard* that pulls fresh\ndata on demand instead of freezing a snapshot at creation. Give it a refresh button:\n\n```html\n\u003Cbutton data-action=\"refresh\">Refresh\u003C\u002Fbutton>\n```\n\nWhen the widget has been **saved as an artifact** (it has a stable slug), the dashboard\nappends `(refresh artifact \"\u003Cslug>\" in place)` to the `[UI] refresh` message it sends you.\nOn that turn: re-fetch the current data (call the tools\u002Fsearches that produced it), then\n`artifact_update(\"\u003Cslug>\", ...)` with the freshly-rendered HTML — the SAME artifact\nupdates in place (versioned), so the open view re-renders with live data rather than\nspawning a new artifact. This is how you build a \"my open items\" \u002F \"current status\"\ndashboard that stays current. (If the widget isn't a saved artifact yet, save it first so\nit has a slug to refresh.)\n\n## Tunable parameters (EDITMODE) — let the user restyle without asking you\n\nA widget can declare its own **tunables**. The dashboard turns them into typed\ncontrols beside the render, and dragging one restyles the widget instantly — no\nturn, no request, no cost to you. This is how a user gets \"a bit more rounded,\nslightly warmer accent\" without spending a message on it.\n\nDeclare them ONCE, as a marker-fenced JSON object inside the widget's own script:\n\n```html\n\u003Cwidget title=\"Sales\">\n  \u003Cstyle>\n    #card { background: var(--card); border-radius: var(--radius); border: 1px solid var(--accent) }\n  \u003C\u002Fstyle>\n  \u003Cdiv id=\"card\">…\u003C\u002Fdiv>\n  \u003Cscript>\n  \u002F*EDITMODE-BEGIN*\u002F{\n    \"radius\": {\"label\": \"Corners\", \"type\": \"range\", \"value\": \"12px\",\n               \"min\": 0, \"max\": 32, \"step\": 2, \"unit\": \"px\"},\n    \"accent\": {\"label\": \"Accent\",  \"type\": \"color\", \"value\": \"#3b82f6\"}\n  }\u002F*EDITMODE-END*\u002F\n  \u003C\u002Fscript>\n\u003C\u002Fwidget>\n```\n\n- **Each key is a `:root` CSS custom property, minus the `--`.** `\"radius\"` drives\n  `var(--radius)`. Reference every tunable through `var(--key)` in your CSS —\n  a value the stylesheet doesn't read is a control that appears to do nothing.\n- **The markers are exact**: `\u002F*EDITMODE-BEGIN*\u002F` … `\u002F*EDITMODE-END*\u002F`, one block per\n  widget, JSON object between them. Put it inside a `\u003Cscript>` so it never renders.\n- **≤ 8 parameters.** More than eight means the widget should be using theme\n  variables rather than inventing its own, and a rail nobody can scan. Extras are\n  dropped, visibly.\n- **Four types**, each with the fields it needs:\n\n  | `type` | fields | control |\n  |---|---|---|\n  | `color` | `value` (`#rrggbb`) | swatch + native picker |\n  | `range` | `value`, `min`, `max`, `step?`, `unit?` | slider |\n  | `select` | `value`, `options` (≥2 CSS strings) | dropdown |\n  | `toggle` | `value`, `on`, `off` (CSS strings) | switch |\n\n- **Values are CSS strings** and are validated: no semicolons, braces, quotes, or\n  `url()`. A descriptor that fails validation loses its control; the widget still\n  renders.\n- **You author the block; the dashboard owns it afterwards.** When the user saves\n  their tweaks, the dashboard rewrites the `value` fields in place and cuts a new\n  artifact version. Everything outside the markers is untouched, and your other\n  fields survive. So when you REGENERATE a widget that already had tunables, keep\n  the same keys and carry the current values across — otherwise you throw away\n  choices the user already made.\n\n## Marked-up corrections you will receive\n\nOn a rendered widget the user can switch on **Mark elements**, click the parts that\nare wrong, and write one short note per element. You receive ONE turn:\n\n````text\n[UI] correction: 2 elements marked — regenerate the artifact applying every change\nbelow, and change nothing else\n```corrections\n1. selector: [data-testid=\"cta\"]\n   within: section[id=\"hero\"]\n   element: \u003Cbutton data-testid=\"cta\">Buy\u003C\u002Fbutton>\n   change: make this green\n2. selector: p.price\n   within: section[id=\"hero\"]\n   element: \u003Cp class=\"price\">$9\u003C\u002Fp>\n   change: bigger\n```\n````\n\nTreat it literally: apply every listed change, change nothing else, and if the\nwidget is a saved artifact (the message ends with `refresh artifact \"\u003Cslug>\" in\nplace`) write the result back to THAT slug with `artifact_update`. Giving elements\na `data-testid` makes these anchors stable and unambiguous — worth doing on the\nhandful of elements a user is likely to want changed.\n\n## Sizing conventions\n\n- Buttons: `text-xs py-1.5 px-3.5 rounded-md`\n- Labels: `text-[11px]`\n- Inputs: `text-sm px-2.5 py-2 rounded-md`\n\n## Links\n\nRender bare URLs as anchors. Always open external links safely and style them\nwith the accent color:\n\n```html\n\u003Ca href=\"https:\u002F\u002Fexample.com\" target=\"_blank\" rel=\"noopener noreferrer\"\n   style=\"color: var(--accent);\">example.com\u003C\u002Fa>\n```\n\n## Drawn visuals — SVG, diagrams, illustrations, animations\n\nDrawn visuals are emitted **inside a `\u003Cwidget>`** (same container, theme vars, and\nCSP as above). The container is easy; the craft is making the drawing itself\n**centered, correctly proportioned, theme-aware, labelled, and legible** rather\nthan cramped, clipped, or off-canvas.\n\n> The #1 failure is a fixed-size `\u003Csvg width=\"350\" height=\"200\">` that renders\n> tiny in a corner. Always make the SVG responsive and centered (below).\n\n### The responsive-SVG contract (use every time)\n\n```html\n\u003Cwidget title=\"…\">\n  \u003Cdiv style=\"max-width: 640px; margin: 0 auto;\">\n    \u003Csvg viewBox=\"0 0 640 360\" width=\"100%\" height=\"auto\"\n         preserveAspectRatio=\"xMidYMid meet\" role=\"img\" aria-label=\"…describe it…\"\n         style=\"display:block\">\n      …\n    \u003C\u002Fsvg>\n  \u003C\u002Fdiv>\n\u003C\u002Fwidget>\n```\n\n- **`viewBox` defines the coordinate space; `width=\"100%\"` makes it scale.** Never\n  set a fixed pixel `width`\u002F`height` on the `\u003Csvg>` — it won't be responsive.\n- **`preserveAspectRatio=\"xMidYMid meet\"`** centers + fits without distortion.\n- **`display:block` + `margin:0 auto`** on a `max-width` wrapper centers it and\n  caps it so it doesn't sprawl edge-to-edge in a wide chat.\n- Pick a viewBox aspect that fits the content: 16:9 (`640 360`) for scenes, 1:1\n  (`400 400`) for cycles\u002Fradial, 3:1 (`720 240`) for timelines\u002Fflows.\n- Leave **internal padding** — keep real content within ~6–8% of each edge so\n  strokes and labels never touch the frame.\n\n### Theme-aware drawing — no hardcoded colors\n\nStyle strokes\u002Ffills with the theme vars (injected into the iframe, same as above):\n\n- structural lines \u002F axes \u002F grids → `var(--border)` (thin, 0.5–1px)\n- primary subject \u002F data → `var(--accent)`\n- secondary \u002F supporting → `var(--muted)`\n- emphasis \u002F alert → `var(--danger)`; positive → `var(--ok)`\n- text labels → `var(--text)`, secondary labels → `var(--muted)`\n- filled regions → `var(--accent-subtle)` \u002F tinted fills, never opaque black\u002Fwhite\n\nPut shared style in one `\u003Cstyle>` block with classes (`.axis{stroke:var(--border)}`)\nrather than repeating `stroke=` on every element — easier to keep consistent.\n\n### Alignment & composition\n\n- **Establish a grid mentally**: align elements to consistent x\u002Fy coordinates;\n  don't eyeball. Equal gaps read as intentional; ragged gaps read as broken.\n- **Center the focal point** in the viewBox; balance mass around it.\n- **Label directly** where possible (label next to the thing) over distant\n  legends; when a legend is needed, align it to a consistent edge with even rows.\n- **Text**: `font: 14px\u002F1.4 -apple-system, sans-serif;` for body labels, ~12px for\n  captions; use `text-anchor=\"middle\"` for centered labels under a node and\n  `dominant-baseline=\"middle\"` for vertical centering. Never rely on the default\n  baseline for centered text.\n- Round coordinates to whole\u002Fhalf pixels for crisp strokes.\n\n### Animating a drawing\n\n- Prefer **CSS animations \u002F transitions** (in the `\u003Cstyle>` block) or **SMIL**\n  (`\u003Canimate>`, `\u003CanimateTransform>`) — both run in the sandbox without extra libs.\n- **Easing + duration**: ease-in-out, 200–600ms for transitions, 2–6s loops for\n  ambient motion. Avoid linear unless it's a steady cycle (rotation, orbit).\n- **Loop with intent**: `animation-iteration-count: infinite` only for genuinely\n  ambient visuals (waves, pulses, orbits). One-shot reveals should play once.\n- **Layer rhythms**: when animating multiple elements, offset their delays\u002Fdurations\n  slightly so motion feels organic, not mechanically synchronized.\n- **Respect reduced-motion** (same media query as the card motion section above).\n- Keep it subtle — motion should clarify (show flow, change, cause→effect), not\n  distract. If the still image already communicates, don't animate.\n\n### Charts\n\n- For data charts prefer **Chart.js** (load from jsDelivr — see CSP above) over\n  hand-drawn SVG bars; pass theme-var colors into the dataset config so it tracks\n  the theme. Give the canvas a fixed-aspect wrapper (`position:relative; height:0;\n  padding-bottom:56.25%`) so it's responsive.\n- Always title the axes + the chart; never render a chart with unlabelled axes.\n\n## Cost discipline\n\nPrefer plain markdown by default. Promote to a widget only when styled HTML\ncommunicates clearly better — charts, color-coded tables, styled cards, visual\nsummaries, diagrams, or simple interactive tools. Don't wrap a paragraph in a widget.\n\nThe dashboard's `widget_density` setting (`more` \u002F `less`, default `more`)\nsignals how freely to reach for widgets; on `less`, use them only when markdown\nis plainly insufficient.\n\n## Quality checklist (before emitting)\n\n1. **Width capped + centered** (`max-w-* mx-auto`, or `max-width` wrapper for SVG)\n   — not sprawling full-width?\n2. **Consistent spacing** — one card padding + one gap size, on the 4px scale?\n3. **Type hierarchy** — clear title vs body vs caption via size\u002Fweight\u002Fcolor, ≤2\n   extra sizes? Numbers `tabular-nums`?\n4. **Aligned** — multi-item layouts on a grid with equal gaps, one alignment spine?\n5. **Zero hardcoded colors** — every color a theme var, looks right light + dark?\n6. **One elevation** — no cards nested 3 deep; hairline borders over heavy shadows?\n7. **Motion** (if any) — eased, 150–300ms (or 2–6s ambient), purposeful,\n   reduced-motion-safe?\n8. **Drawing a figure?** Responsive `viewBox` + `width=\"100%\"` (no fixed px),\n   centered, content inside the frame with breathing room, labels legible and\n   correctly centered? Reads clearly at half size on both themes?\n",{"name":5,"triggers":24,"description":7,"context_tier":25},"widget, widget iframe, chart, table, visual, dashboard, render widget, illustration, diagram, draw, svg, animation, animate, graph, schematic, visualize, visual explanation, figure","heavy","main","d2af2361d07479c31299731cd2aab81a99a1b0ae","runtime\u002Fgideon\u002Fextensions\u002Fskills\u002Fbundled\u002Fvisual-output",33,"https:\u002F\u002Fgithub.com\u002FSidiora-Labs\u002Fcentra-gideon-agent","https:\u002F\u002Fcentra.ag","https:\u002F\u002Fgithub.com\u002FSidiora-Labs","sidioralabs.com","An Applied Lab for Systems That Connect Ideas to Action.","2026-11-05 23:31:58",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add Sidiora-Labs\u002Fcentra-gideon-agent --skill visual-output",{"tool":42,"command":43},"bunx","bunx skills add Sidiora-Labs\u002Fcentra-gideon-agent --skill visual-output",{"tool":45,"command":46},"pnpm","pnpm dlx skills add Sidiora-Labs\u002Fcentra-gideon-agent --skill visual-output","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FSidiora-Labs\u002Fcentra-gideon-agent\u002Fblob\u002Fmain\u002Fruntime\u002Fgideon\u002Fextensions\u002Fskills\u002Fbundled\u002Fvisual-output\u002FSKILL.md",true,[],[51,58,65,72,79,86],{"skillNo":52,"name":53,"nameZh":6,"description":54,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":19},"01M7CXXG9ZW9SRRET92XBGS5W3","web-verify","Verify a built web page or app actually renders and works — drive it in a real browser, check the console and network, confirm the thing you changed is the thing being served, and capture evidence. Use before claiming a frontend change works.","https:\u002F\u002Fgithub.com\u002FSidiora-Labs\u002Fcentra-gideon-agent\u002Fblob\u002Fmain\u002Fruntime\u002Fgideon\u002Fextensions\u002Fskills\u002Fbundled\u002Fweb-verify\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M7CXX48DZZ7JTV0RRS4406Y7","task-and-project","Track work as Tasks (the \u002Fapi\u002Ftasks CRUD + native task provider), and decompose larger projects into independent, verifiable units — fanning parallel investigation out to subagents while keeping one coherent plan; hand open-ended goal-driven work to a goal loop.","https:\u002F\u002Fgithub.com\u002FSidiora-Labs\u002Fcentra-gideon-agent\u002Fblob\u002Fmain\u002Fruntime\u002Fgideon\u002Fextensions\u002Fskills\u002Fbundled\u002Ftask-and-project\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M7CXWYSRFM4BX63CY3TD0PA6","research-campaign","Run a multi-cycle research campaign — grill the question, decompose it into answerable sub-questions, investigate each against sources, then synthesize with confidence and gaps stated. Use for open questions that need real investigation rather than one lookup.","https:\u002F\u002Fgithub.com\u002FSidiora-Labs\u002Fcentra-gideon-agent\u002Fblob\u002Fmain\u002Fruntime\u002Fgideon\u002Fextensions\u002Fskills\u002Fbundled\u002Fresearch-campaign\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M7CXWSF6REG8ST1X0M7HN563","memory-discipline","When and how to persist durable memory — save genuine user preferences, facts, and corrections; NEVER persist transient environment failures (a failed command, a flaky network call, a one-off tool error) as lessons; recall before re-asking.","https:\u002F\u002Fgithub.com\u002FSidiora-Labs\u002Fcentra-gideon-agent\u002Fblob\u002Fmain\u002Fruntime\u002Fgideon\u002Fextensions\u002Fskills\u002Fbundled\u002Fmemory-discipline\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M7CXWJDSGB37A4E74EFK748F","loop-worker","Per-cycle protocol for an autonomous goal loop worker — the unified autonomous goal engine that runs one self-directed cycle per turn until its goal is met, then self-retires. Drives one cycle against a loop's file interface (status.json gate, brief.md goal, guidance.txt nudges, findings\u002Fcycle_NNN.json, FINDINGS.md, the type-appropriate deliverable, STOP sentinel). The worker produces work and reports evidence; a deterministic check or a separate judge — never the worker — decides done-ness.","https:\u002F\u002Fgithub.com\u002FSidiora-Labs\u002Fcentra-gideon-agent\u002Fblob\u002Fmain\u002Fruntime\u002Fgideon\u002Fextensions\u002Fskills\u002Fbundled\u002Floop-worker\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M7CXWE033T8VRGJSC78E51C3","knowledge-grounding","Search the knowledge pool before answering, ground claims in retrieved sources and cite them, recognize ingest-worthy content and capture it with knowledge_create — don't fabricate when the answer is on record.","https:\u002F\u002Fgithub.com\u002FSidiora-Labs\u002Fcentra-gideon-agent\u002Fblob\u002Fmain\u002Fruntime\u002Fgideon\u002Fextensions\u002Fskills\u002Fbundled\u002Fknowledge-grounding\u002FSKILL.md",[],[]]