Skip to content
Back to search

visualize

Generate beautiful, on-brand HTML artifacts with AI coding agents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/display-dev--visualize/badge.svg)](/listings/display-dev--visualize)

HTML

<a href="/listings/display-dev--visualize"><img src="/api/listings/display-dev--visualize/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx skills add display-dev/visualize --skill visualize

Works across Claude Code, Cursor, Codex, OpenCode, Hermes, and Pi.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 157 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p><img src="assets/cover.png" alt="visualize — generate beautiful, on-brand HTML artifacts with your AI assistant" width="1280"></p>
  2. # visualize
  3. **Generate beautiful, on-brand HTML — without the AI-default slop.**
  4. Agents already generate HTML when you ask. Reports, diagrams, dashboards, slide decks, plans, recaps. The output works, but it looks the same everywhere: Inter font, purple gradients, cards in cards, generic shadcn defaults that read as "this was generated by an agent." visualize closes that gap.
  5. ## Install
  6. ```sh
  7. npx skills add display-dev/visualize --skill visualize
  8. ```
  9. Use the same skill directory across Claude Code, Cursor, Codex, Copilot, OpenCode, Hermes, Pi, OpenClaw, and Gemini CLI. See [installation routes and verification limits](HARNESSES.md).
  10. Installations bundle the selection index, Clean fallback, templates, and runtime helpers. The full catalog and preview sources stay in this repository. Selected reference packages load on demand from a pinned public commit; Node.js 18+ and internet access are needed for the first load of a non-bundled package. Cached packages can be reused offline.
  11. For a cloned repository, the installable skill is `skills/visualize/`. Update local symlinks from the former mount paths to this directory.
  12. From the installed skill directory:
  13. ```sh
  14. node scripts/catalog.mjs editorial
  15. node scripts/catalog.mjs editorial --previews
  16. ```
  17. The JSON result gives local file paths and the pinned source URL. Previews load only with `--previews`. Set `VISUALIZE_CATALOG_CACHE_DIR` to relocate the default `~/.cache/visualize-skill/catalog` cache. A failed fetch reports the unavailable reference; it never silently substitutes Clean. For a damaged cache, remove only the directory named in the error and retry.
  18. ## Why visualize?
  19. Four problems with how agents publish HTML today:
  20. **1. Every artifact looks the same.** Every coding agent was trained on the same SaaS templates: Inter for everything, purple-to-blue gradients, rounded-square icon tile above every heading, six metric cards in a row, "Get started for free" CTA. Skip the brand guidance and every Report reads as the same Report. A Report from your company should look like your company's Report; today it looks like a generic shadcn demo regardless of who shipped it.
  21. **2. No brand context.** Pasting brand colors into every prompt isn't sustainable, and the agent forgets between sessions. visualize captures voice + visual identity once via `teach`, then every render reads the brand profile and produces a Report that visibly belongs to your company.
  22. **3. Compare real directions before choosing.** `explore artifact` compares structure, visual treatment, or both in one self-contained HTML review. Content, facts, assets, actions, and non-overridden project choices stay fixed. Switch between wide and 390 px states, scroll each full document normally, and choose before the target changes. Apply a named reference theme directly when the direction is already chosen.
  23. **4. Iteration verbs with real contracts.** visualize has five Refine verbs (`simplify`, `bolder`, `quieter`, `animate`, `polish`) plus one Evaluate verb (`review`). Each does one specific thing — `bolder` amplifies visual punch, `simplify` strips decoration, `quieter` tones intensity, `animate` covers motion, `polish` is the terminal quality pass the other Refine verbs hand off to. `review` reports findings without modifying the file.
  24. ## What's inside
  25. <p><img src="assets/showcase.png" alt="A 4×4 grid showing 16 visualize design systems rendered in light and dark mode" width="1280"></p>
  26. ### Templates — 35 across 7 categories
  27. <p><img src="assets/templates-showcase.png" alt="A 4×4 grid showing 16 visualize templates across marketing, operations, technical, decision, long-form, and data surfaces" width="1280"></p>
  28. | Category | Templates |
  29. |---|---|
  30. | Explanation / reference | explainer · diagram · architecture-overview · implementation-plan · diff-review · plan-review · project-recap · fact-check-report · comparison · faq |
  31. | Status / tracking | dashboard · roadmap-timeline · changelog · status-page · release-announcement |
  32. | Decision / narrative | adr · rfc · postmortem · proposal |
  33. | Long-form | report · whitepaper · case-study · research-brief |
  34. | Instructional | runbook · onboarding-module · meeting-notes · tutorial · api-reference |
  35. | Data-shaped | data-explorer · survey-results |
  36. | Presentation / marketing | slide-deck · pitch-deck · one-pager · org-chart · resume-bio |
  37. ### System Explore
  38. `explore system` compares a new project identity or an explicitly requested replacement. Start with broad visual directions or a focused palette/type question; no existing layout is required. A coherent identity already in code should be captured with `teach`, even without `DESIGN.md`.
  39. Keep settled choices while comparing the next question: “Keep Coral and this layout; compare quieter secondary accents,” then “Keep the palette; compare typography.” Review each candidate at wide and phone widths in light and dark. A selected trait does not approve the complete system. Adopting a complete system leads to a full `DESIGN.md`, `PRODUCT.md`, and `tokens.css` draft, with separate confirmation before writing. Replacement preserves private backups and stops for manual repair if an edit or verification fails.
  40. Available in v0.6.0. See [System Explore](skills/visualize/reference/explore-system.md) for the procedure.
  41. ### Design systems and artifact themes
  42. Reference packages with visual guidance, tokens, and previews. Use them when deriving a project identity with `teach`, apply one as an artifact theme, or compare treatments with `explore artifact`. Two layers:
  43. - **40 native register-family references** — Clean (default), Editorial, Console, IDE, Terminal, Blueprint, Brutalist, Deck, Paper-ink, Whitepaper, plus broader artifact registers like Bento, Neon, Riso, Terracotta, Glassmorphism, Dithered, Luxury, Sketch, Monograph, News-print, Swiss, Win98, and more.
  44. - **63 brand-style entries** — `airbnb-style`, `apple-style`, `cohere-style`, `mistral-ai-style`, etc. All brand-style entries are self-authored from live brand verification and carry `source: live-verified` in their `DESIGN.md` frontmatter.
  45. Each design system has `DESIGN.md` for visual guidance and `tokens.css` for concrete values. A package README, when present, links its references and previews; see [Editorial](catalog/design-systems/editorial/README.md).
  46. For example: “Apply Editorial to this report. Replace the project's visual styling for this artifact only; keep its logo, content, section order, and behavior.”
  47. Project styling remains the default. Explicit artifact overrides stay local and do not change project design files. A named treatment can be applied directly; `explore artifact` compares structure, visual treatment, or both before selection. A new artifact does not need an existing layout or captured project profile.
  48. ### Iteration verbs — 6 commands that operate on existing artifacts
  49. | Verb | What it does |
  50. |---|---|
  51. | `polish` | Alignment, spacing, consistency, edge data shapes |
  52. | `review` | Deterministic detector findings + LLM judgment |
  53. | `simplify` | Strip decoration that isn't earning its pixel |
  54. | `bolder` | Amplify visual punch |
  55. | `quieter` | Tone down over-decoration |
  56. | `animate` | Purposeful motion, `prefers-reduced-motion` compliant |
  57. ### Brand profile — `teach` captures once, every artifact reads
  58. `/visualize teach` bootstraps once per project. The flow walks the codebase, captures the live site, reads existing artifacts, and asks for the missing pieces. It writes two files at the project root:
  59. - **`DESIGN.md`** — Google Stitch's canonical format. YAML frontmatter carrying machine-readable design tokens (colors / typography / radius / components in shadcn-semantic shape) + a six-section markdown body (Overview / Colors / Typography / Elevation / Components / Do's and Don'ts) that carries the affordance vocabulary.
  60. - **`PRODUCT.md`** — voice, audience, tone, register.
  61. A sibling `tokens.css` at the project root carries the CSS-form tokens templates read at render time.
  62. ### Deterministic artifact checks
  63. Color choices follow the brief and approved identity, not blanket hue bans: neutral gray, red primaries, multiple accents, and restrained or immersive color are valid. The shared [color guidance](skills/visualize/reference/color.md) explains character, roles, and focused comparisons; contrast and non-color cues remain requirements.
  64. `scripts/detect.mjs` runs rules across six categories: **fossil** (lorem ipsum, citation tokens, "Generated by AI" disclaimers), **slop** (gradient text, crushed tracking, nested cards, section scaffolding, provider-specific tells), **diagram** (semantic topology, groups, accessibility, and delivered SVG), **a11y** (contrast, headings, alt text), **meta** (title, social previews, external scripts), **perf** (image size, animation cost). Used by `/visualize review`; usable standalone:
  65. ```sh
  66. node scripts/detect.mjs --strict artifact.html
  67. node scripts/detect.mjs --json --brand DESIGN.md artifact.html
  68. node scripts/detect.mjs --provider codex artifact.html
  69. node scripts/detect.mjs --list-rules
  70. ```
  71. Relationship diagrams route by reader question into flow, system, sequence, state/lifecycle, hierarchy, or simple spatial grammar. Delivered figures are self-contained semantic inline SVG: Mermaid may calculate an initial layout locally, but no Mermaid runtime or network dependency ships.
  72. Use the pinned authoring helper to turn Mermaid source into a draft SVG, then inline and semantically normalize that SVG before delivery:
  73. ```sh
  74. node scripts/render-mermaid.mjs source.mmd draft.svg
  75. ```
  76. `scripts/browser-diagram.mjs` checks marked diagrams at desktop and 390 px widths in explicit light and dark themes. It blocks and reports non-allowlisted external network requests, then reports clipping, peer and label overlap, paths through unrelated nodes, edge intersections or stacking, distant endpoints, computed contrast, and extreme aspect ratios using the same structured severities as the static detector:
  77. ```sh
  78. node scripts/browser-diagram.mjs --strict artifact.html
  79. node scripts/browser-diagram.mjs --self-test
  80. ```
  81. ### Portable image generation
  82. The portable contract can create one local PNG or JPEG through an explicitly selected released route. It preserves provider bytes, reports ordinary route/output diagnostics, and requires the active agent to open and visually inspect the image before using it. Ambiguous attempts stop without retry or fallback.
  83. See [`skills/visualize/reference/image-generation.md`](skills/visualize/reference/image-generation.md) for the canonical route, limits, billing, validation, and recovery contract. [`HARNESSES.md`](HARNESSES.md) records only current observed host and route evidence; routes without that evidence remain maintainer candidates.
  84. ## Commands
  85. `/visualize` invokes the skill. The argument tells the agent what to do.
  86. | Form | Effect |
  87. |---|---|
  88. | `/visualize <topic-or-path>` | Pick template from intent; compose against brand tokens; write self-contained HTML |
  89. | `/visualize teach` | Bootstrap (or refresh) the brand profile |
  90. | `/visualize explore artifact <topic-or-path>` | Compare structure, visual treatment, or both for one artifact |
  91. | `/visualize explore system <topic-or-path>` | Compare new or replacement project systems before confirmed adoption |
  92. | `/visualize polish <path>` | Iteration: alignment, spacing, consistency |
  93. | `/visualize review <path>` | Iteration: detector findings + LLM judgment |
  94. | `/visualize simplify <path>` | Iteration: strip decoration |
  95. | `/visualize bolder <path>` | Iteration: amplify visual punch |
  96. | `/visualize quieter <path>` | Iteration: tone down |
  97. | `/visualize animate <path>` | Iteration: purposeful motion |
  98. | `/visualize publish <path>` | Publish the artifact to a hosting destination via MCP, CLI, or HTTP |
  99. On Claude Code the form is space-separated: `/visualize teach`. Other hosts (Cursor, Codex, Copilot, OpenCode, Gemini, Claude.ai) load on intent-match from natural language. Phrasings like "create a plan," "make me a diagram," "polish this report," or "use my brand" trigger the skill without an explicit slash.
  100. ## License
  101. MIT — see [LICENSE](./LICENSE). Bundles [jq 1.7.1](https://github.com/jqlang/jq) (MIT, © 2012 Stephen Dolan); full text in [`skills/visualize/bin/jq.LICENSE`](skills/visualize/bin/jq.LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.