Data Vizard logo Data Vizard

FAQ

Common questions about installing, using, and troubleshooting Data Vizard.

About

What is Data Vizard?

Data Vizard is an agent workflow plugin for Codex, Claude Code, and Gemini CLI. It provides seven specialist skills that guide you from a raw dataset to a polished, self-contained HTML visualization, with every decision made explicit and auditable.

What skills does the plugin include?

  • data-vizard Orchestrates the full workflow and keeps decision gates explicit.
  • data-curator Profiles, cleans, reshapes, joins, and documents datasets.
  • data-analyst Finds patterns, caveats, and evidence-backed story directions.
  • narrator Decides how much language the visualization actually needs.
  • critic Reviews briefs and artifacts for rigor, craft, and anti-default quality.
  • de-slop Cleans up bad or misleading charts without changing the evidence.
  • designer Designs and builds HTML visualization artifacts.

Which agent hosts are supported?

Codex app and CLISupported
Claude Code CLISupported
Gemini CLISupported
npmSupported

Does Data Vizard collect any data or phone home?

No. Data Vizard works entirely on files in your active workspace. It adds no server, background sync, analytics, or external connector. Your agent host's own settings control model access, file permissions, and network access.

For sensitive datasets: review source rights before importing, keep private raw files out of commits, and document caveats close to any public-facing claims.

Installing

How do I install Data Vizard?

You need Node.js 18 or newer.

npx data-vizard install

The installer detects Codex, Claude Code, and Gemini CLI automatically and registers the plugin with each one. Then open a new session in your agent so the skills load.

Equivalent: pnpm dlx data-vizard install or bunx data-vizard install.

How do I update to the latest version?

npx data-vizard install

Then start a new session. If your agent still shows an older version, confirm that the manifests under plugins/data-vizard/ have the new version number and reinstall.

Can I install from a local clone instead of npm?

Yes, for development only. From the repository root:

# Claude Code
claude plugin marketplace add "$(pwd)"
claude plugin install data-vizard@data-vizard

# Codex
codex plugin marketplace add "$(pwd)"
codex plugin add data-vizard@data-vizard

# Gemini CLI
gemini extensions install "$(pwd)/extensions/data-vizard" --consent --skip-settings

Using

How do I invoke Data Vizard in Claude Code?

/data-vizard:data-vizard Build a visualization from this CSV.

Call individual skills directly when you already know the stage:

/data-vizard:data-curator Profile and clean this dataset.
/data-vizard:critic Review this visualization brief.
/data-vizard:de-slop Clean up this chart without changing the evidence.

How do I invoke Data Vizard in Codex?

Use $data-vizard:data-vizard to build a visualization from this CSV.

How do I invoke Data Vizard in Gemini CLI?

/data-vizard Build a visualization from this CSV.

Troubleshooting

Codex says the plugin was not found in the marketplace.

Register the repository marketplace first, then add the plugin:

codex plugin marketplace add "$(pwd)"
codex plugin add data-vizard@data-vizard

Codex itself fails because it can't find a native vendor binary.

npm uninstall -g @openai/codex
npm install -g @openai/codex@latest
codex --version

Plugin validation fails with ModuleNotFoundError: No module named 'yaml'.

This only applies to development validation, not normal installation:

python3 -m venv .venv-validator
.venv-validator/bin/python -m pip install --upgrade pip PyYAML
.venv-validator/bin/python /path/to/plugin-creator/scripts/validate_plugin.py plugins/data-vizard