Skip to main content
skill CX Codex

vue-data-ui-skilld — Claude Code skill: what it does, how to install

The vue-data-ui-skilld skill guides agents working with the vue-data-ui Vue 3 chart library, from component selection and theming to SSR and debugging.

MIT 118 installs ★ 186 updated 2026-10-10

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add skilld-dev/vue-ecosystem-skills --skill vue-data-ui-skilld -a claude-code
Open on GitHub

What vue-data-ui-skilld does

vue-data-ui-skilld gives an agent focused guidance for the vue-data-ui visualization library. It covers component choice, config objects, themes, slots, tooltips, data-label formatters, exports, composables, utilities, and server-side SVG rendering. Its references include the component catalog, API surface, customization notes, and migration details.

The skill also points out library-specific traps: use VueUiXyCanvas for very large datasets, keep fixed container dimensions with responsive: true, import vue-data-ui/style.css, and avoid mixing bar series with continuous { x, y } data in VueUiXy. The package requires vue >= 3.3.0; PDF export needs the optional jspdf >= 3.0.1 peer dependency. Without vue >= 3.3.0, the setup will fail.

What it helps with

  • choose a vue-data-ui component for a chart
  • build a typed config from library defaults
  • customize tooltips, slots, and data labels
  • render a chart as static SVG with SSR
  • diagnose mixed-series or responsive-layout issues

Example prompts for the agent

  • Choose a vue-data-ui component for a chart with two series and explain its configuration.
  • Customize the VueUiXy tooltip with a slot and add image export.
  • Review this createStaticVueUiXy SSR code and find the configuration error.

How to install vue-data-ui-skilld

1Skills CLI (Vercel)

npx skills add skilld-dev/vue-ecosystem-skills --skill vue-data-ui-skilld -a claude-code

2Manually: put the files in place

~/.claude/skills/vue-data-ui-skilld/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/vue-data-ui-skilld/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about vue-data-ui-skilld

How do I install vue-data-ui-skilld in Claude Code?

Run npx skills add skilld-dev/vue-ecosystem-skills --skill vue-data-ui-skilld -a claude-code, then check ~/.claude/skills/vue-data-ui-skilld/SKILL.md.

What does vue-data-ui-skilld do?

It gives the agent focused guidance for vue-data-ui, including component selection, configuration, themes, slots, tooltips, exports, SSR, and debugging.

What does vue-data-ui require?

The library requires vue >= 3.3.0. PDF export additionally needs the optional jspdf >= 3.0.1 peer dependency, and the app must import vue-data-ui/style.css.

Source text

SKILL.md · MIT
---
name: vue-data-ui-skilld
description: "A user-empowering data visualization Vue 3 components library (69 components) for eloquent data storytelling. ALWAYS use when writing code importing \"vue-data-ui\". Consult for component choice, config, theming, slots, tooltips, exports, SSR, debugging, or modifying vue-data-ui, vue data ui."
license: MIT
---

# graphieros/vue-data-ui `[email protected]`

- Docs: https://vue-data-ui.graphieros.com/ (per-component pages: `https://vue-data-ui.graphieros.com/docs#vue-ui-<name>`)
- Repo: https://github.com/graphieros/vue-data-ui
- Requires `vue >= 3.3.0`; `jspdf >= 3.0.1` is an optional peer dep, install it only for the PDF export feature (package.json:112-119).
- Types ship with the package; main entry types resolve to `dist/types/vue-data-ui.d.ts` (package.json:66-90).

## References

- [API surface](./references/api-surface.md): entry points, import styles, utils, composables, SSR.
- [Components](./references/components.md): catalog, common props/emits/exposed methods/slots.
- [Customization](./references/customization.md): config patterns, themes, user options, slots, a11y, responsive, big data.
- [Migration v3.19.2 to v3.25.9](./references/migration-v3.19-v3.25.md): API deltas incl. the v3.25.0 breaking change.

## Setup

```bash
npm i vue-data-ui
```

```vue
<script setup>
import { ref } from "vue";
import { VueUiDonut } from "vue-data-ui";
import "vue-data-ui/style.css"; // required css

const dataset = ref([
  { name: "A", value: 12 },
  { name: "B", value: 88 },
]);
const config = ref({ theme: "zen" });
</script>

<template>
  <VueUiDonut :dataset="dataset" :config="config" />
</template>
```

Every component takes a `dataset` prop and a `config` object prop. Pass a partial `config`; the component merges it over defaults. Prefer `computed` configs so mutations stay reactive.

## Common tasks

Build a typed config from defaults and override safely:

```ts
import { getVueDataUiConfig, mergeConfigs, type VueUiXyConfig } from "vue-data-ui";

const config = computed<VueUiXyConfig>(() => mergeConfigs({
  defaultConfig: getVueDataUiConfig("vue_ui_xy"), // snake_case component key
  userConfig: { chart: { title: { text: "Sales" } } },
}));
```

Call exposed methods through a template ref (available per component, see components reference):

```ts
const chart = useTemplateRef("chart");
const data = await chart.value.getData();
const img = await chart.value.getImage({ scale: 2 }); // { imgUri, base64, title, width, height, aspectRatio }
chart.value.showSeries("Series 1"); // or hideSeries("Series 1")
```

Customize tooltips with `tooltip.customFormat: ({ seriesIndex, datapoint, series, config }) => string`, or richer content via `#tooltip-before` / `#tooltip-after` slots. Customize data labels with `formatter: ({ value, config }) => string`.

Drag tooltips out of the pointer's way with the `useTooltipPosition` composable (since v3.22.0):

```ts
import { useTooltipPosition } from "vue-data-ui/composables";
const chartRef = useTemplateRef("chartRef");
const tooltipPosition = useTooltipPosition(chartRef); // ComputedRef<"left" | "right" | "center">
const config = computed(() => ({ chart: { tooltip: { position: tooltipPosition.value } } }));
```

Render static SVG server-side (no browser needed):

```ts
import { createStaticVueUiXy } from "vue-data-ui/ssr"; // or 'vue-data-ui/ssr/vue-ui-xy' (treeshaken)
const svg = await createStaticVueUiXy({ dataset, config });
```

## Best practices

- Use `VueUiXyCanvas` instead of `VueUiXy` for very large datasets; tune `config.downsample.threshold` (LTTB downsampling). Defaults: Xy 1095, XyCanvas 10000, Quadrant/Scatter/Sparkline/SparkTrend 1095 (README.md:979-1002).
- With `config.responsive: true`, place charts in a container with fixed dimensions; a 100% height container makes the chart grow infinitely (README.md:968-977).
- Opt in to pointer cursors with `config.useCursorPointer: true`; disabled by default for a11y (README.md:1521-1529).
- Enable the a11y alt-text button with `userOptions.buttons.altCopy: true` plus a `userOptions.callbacks.altCopy` callback (README.md:1488-1519).
- Reverse an axis with the dedicated `reverse` config flags (since v3.20.7), do not hack negative values. X axis: `chart.grid.labels.xAxis.reverse`; y axis: `chart.grid.labels.yAxis.reverse` (VueUiXy).
- Gate `config.debug` and `config.devHints.enable` behind a dev environment variable; some critical warnings still print (v3.23.0, v3.23.2 release notes).
- Use `legend.selectAllToggle.show: true` to offer a select-all checkbox (more than 2 series); `@selectLegend` also fires when it is toggled (since v3.19.9).
- Import from `vue-data-ui/utils` for utilities the main entry does not re-export, e.g. `adaptColorToBackground` (dist/utils.js export list).
- Do not pass `bar` type series mixed with continuous `{ x, y }` series in `VueUiXy`; bars are hidden and a warning is logged (v3.20.7 release notes).
- `#tooltip` slots replace default content; `#tooltip-before`/`#tooltip-after` prepend/append instead.

## Version limits and breaking changes

- v3.25.0 (breaking): `showOnlyAtModulo` now applies a real modulo and the `modulo` default changed from 12 to 2; use the new `showFirstAndLast: true` to force edge labels. Affects VueUiXy (+SSR), VueUiStackbar, VueUiStackline, VueUiCandlestick. See [migration](./references/migration-v3.19-v3.25.md).
- v3 is not breaking vs v2, but some padding configs changed (README.md:185-200).
- Since v3.14.3 locale files are removed; time labels rely on `Intl` (v3.14.3 release notes).

© skilld-dev · MIT · skilld-dev/vue-ecosystem-skills

Similar skills

All skills for Frontend and UI →

From the same set32

The whole set →
tanstack-vue-virtual-skilld The tanstack-vue-virtual-skilld skill guides Vue work with @tanstack/vue-virtual, from implementing virtual lists to debugging adapter usage. It also covers window scrolling and chat feeds anchored at the end. CX Codex +1 129installs tanstack-vue-form-skilld tanstack-vue-form-skilld guides agents through writing, reviewing, and debugging Vue forms built with @tanstack/vue-form and its current API. CX Codex +1 125installs vueuse-math-skilld vueuse-math-skilld — a skill for @vueuse/math composables in Vue 3: clamp, project, round, and aggregate reactive numbers. CX Codex +1 119installs floating-ui-vue-skilld floating-ui-vue-skilld guides AI coding agents on anchoring tooltips, popovers, and menus using @floating-ui/vue 2.0.1 in Vue 3.3+. CX Codex +1 119installs unovis-vue-skilld unovis-vue-skilld is a Claude Code skill for building and debugging Vue 3 code with @unovis/vue, including chart work and migration to API 1.7.0. CX Codex +1 112installs vitepress-skilld vitepress-skilld supplies API specs, config references, and CLI instructions for VitePress 1.6.4. CX Codex +1 110installs tanstack-ai-vue-skilld The tanstack-ai-vue-skilld skill guides Vue 3 work with @tanstack/ai-vue, covering streaming chat, media generation, reactive state, and typed client tools. CX Codex +1 110installs formkit-core-skilld formkit-core-skilld is a Claude Code skill for writing, debugging, and checking code that uses FormKit core nodes, values, events, and hooks. CX Codex +1 105installs

Project sponsors

Companies that keep this analytics open