Once the Datama skill is installed, ask your AI assistant in plain language. It reads your data, picks Compare or Explore, builds the configuration, and delivers a standalone HTML visualization.


1. How to invoke the skill

Mention datama in your prompt so the host routes to the skill. Depending on your assistant, this can be a slash command (for example /datama), an @mention, or simply describing a Compare or Explore question in natural language when auto-trigger is enabled.

Invoke the datama skill in an AI assistant (example)


2. Provide your data

The assistant needs a tabular dataset. You can provide it in any form the host supports:

  • an uploaded CSV or XLSX file,
  • data pasted in the conversation,
  • a connector the assistant can call (Google Sheets, BigQuery, …),
  • a dataset you ask the assistant to generate for testing.

If the raw data is very large (roughly more than 20 000 rows), the assistant should aggregate along the requested dimensions before building the visualization.


3. Example prompts

Compare — variance / waterfall

Use Compare when you want to understand why a KPI changed between two sides:

  • “Compare Q1 vs Q2 revenue and explain the change.”
  • “Decompose the drop in conversion rate between mobile and desktop.”
  • “What explains the delta in sessions week over week?”
  • “Why did revenue drop between these two periods?”

Explore — breakdown / slicing

Use Explore when you want to slice a metric without a mandatory A vs B comparison:

  • “Break down revenue by country.”
  • “Plot conversion by device and channel.”
  • “Explore sessions across campaign.”
  • “Show the distribution of orders by week.”


4. What the assistant delivers

The assistant follows the skill workflow:

  1. Reads your data and infers column types (dimensions vs metrics).
  2. Picks Compare or Explore using the routing rules.
  3. Builds the Datama configuration from the bundled reference specifications.
  4. Delivers a standalone .html file (or an in-chat preview).
  5. Validates the output before delivery.

Open the HTML in any browser. The visualization renders entirely in the browser — your rows never leave the page.

Compare waterfall generated by the Datama skill (example)


5. Compare vs Explore — quick reference

Question type Solution Example
Two periods, two segments, “vs”, “before/after” Compare “Compare Q1 vs Q2”
Breakdown by dimension, funnel step, distribution Explore “Revenue by country”
Both comparison and breakdown language Compare “Why did mobile revenue drop vs desktop?”
Unclear Compare —


6. License and output mode

The mode of each generated visualization depends on how you downloaded the skill:

Download option Result
With license Paid mode
Without license Demo mode


7. Going further