Skip to content

forcedotcom/sf-skills / skills/tableau-next-asset-create

tableau-next-asset-create

Verified

Build and edit Tableau Next semantic models (SDMs), vizzes, and dashboards via MCP. TRIGGER when: building a semantic model or dashboard from CSV/Excel files; ingesting a flat file/database into DLO/DMO; profiling a dataset (grain, measures, dimensions; large/wide files via `infer_object_schema`); adding a dimension, measure, AI-ready metric, join, or logical view; running a semantic query, interpreting a breakdown, analyzing account/customer engagement, or pulling counts/totals from existing Tableau Next data (even unnamed/read-only); creating/editing a viz (filter, forecast, sort, shelf, mark encoding, reference line), widget, or dashboard layout. Also: Data Cloud SQL transforms; show a dashboard; share/revoke access; reuse prod or promote Personal Org assets; provision users/licenses; data alerts ('alert me when'); list/classify verified questions or score agent SQL. DO NOT TRIGGER for: rewriting prose descriptions, layout-only dashboard review, debugging MCP, or writing app code.

FileKindSize
SKILL.mdskill md23.9 KB
references/admin-users.mdmarkdown5.9 KB
references/ai-readiness.mdmarkdown17.5 KB
references/alerts.mdmarkdown3.9 KB
references/build-workflow.mdmarkdown41.4 KB
references/dashboard-authoring.mdmarkdown15.5 KB
references/dashboard-design-principles.mdmarkdown18.6 KB
references/data-transform-gotchas.mdmarkdown9.5 KB
references/data-understanding.mdmarkdown26.8 KB
references/deep-reference-index.mdmarkdown4.8 KB
references/destructive-operations.mdmarkdown3.9 KB
references/edit-dashboard.mdmarkdown19.8 KB
references/edit-visualization.mdmarkdown41.5 KB
references/empty-source-handling.mdmarkdown4.9 KB
references/ingest-and-metric-gotchas.mdmarkdown35.4 KB
references/insight-bundle.mdmarkdown2.7 KB
references/large-flat-file-handling.mdmarkdown19.1 KB
references/schemas/edit-dashboard/_envelope.jsonconfig3.1 KB
references/schemas/edit-dashboard/_shared-widget-fields.jsonconfig7.0 KB
references/schemas/edit-dashboard/add_page.jsonconfig1.1 KB
references/schemas/edit-dashboard/delete_page.jsonconfig947 B
references/schemas/edit-dashboard/discard_dashboard.jsonconfig482 B
references/schemas/edit-dashboard/move_widget.jsonconfig1.4 KB
references/schemas/edit-dashboard/move_widget_to_page.jsonconfig1.4 KB
references/schemas/edit-dashboard/place_widget_on_page.jsonconfig1.4 KB
references/schemas/edit-dashboard/remove_widget_from_dashboard.jsonconfig864 B
references/schemas/edit-dashboard/remove_widget_from_page.jsonconfig1.1 KB
references/schemas/edit-dashboard/rename_page.jsonconfig1.0 KB
references/schemas/edit-dashboard/save_dashboard.jsonconfig775 B
references/schemas/edit-dashboard/undo.jsonconfig421 B
references/schemas/edit-dashboard/upsert_button_widget.jsonconfig3.3 KB
references/schemas/edit-dashboard/upsert_container_widget.jsonconfig4.2 KB
references/schemas/edit-dashboard/upsert_filter_widget.jsonconfig8.8 KB
references/schemas/edit-dashboard/upsert_metric_widget.jsonconfig3.8 KB
references/schemas/edit-dashboard/upsert_navigation_widget.jsonconfig4.4 KB
references/schemas/edit-dashboard/upsert_parameter_widget.jsonconfig9.9 KB
references/schemas/edit-dashboard/upsert_text_widget.jsonconfig5.5 KB
references/schemas/edit-dashboard/upsert_visualization_widget.jsonconfig3.4 KB
references/sdm-tool-reference.mdmarkdown33.1 KB
references/semantic-query-and-enrichment.mdmarkdown16.3 KB
references/shared-gates.mdmarkdown17.6 KB
references/sharing-and-promotion.mdmarkdown14.4 KB
references/tasks/ai-readiness-audit.mdmarkdown3.0 KB
references/tasks/analyze-data.mdmarkdown2.5 KB
references/tasks/build-dashboard.mdmarkdown3.7 KB
references/tasks/build-end-to-end.mdmarkdown4.4 KB
references/tasks/create-data-transform.mdmarkdown2.8 KB
references/tasks/create-viz.mdmarkdown3.6 KB
references/tasks/edit-dashboard.mdmarkdown5.0 KB
references/tasks/edit-sdm.mdmarkdown6.5 KB
references/tasks/edit-viz.mdmarkdown2.4 KB
references/tasks/enrich-model.mdmarkdown4.0 KB
references/tasks/ingest-flat-file.mdmarkdown3.9 KB
references/tasks/manage-alert.mdmarkdown1.6 KB
references/tasks/profile-dataset.mdmarkdown2.7 KB
references/tasks/promote-or-reuse.mdmarkdown2.3 KB
references/tasks/provision-user.mdmarkdown1.8 KB
references/tasks/query-model.mdmarkdown5.3 KB
references/tasks/review-verified-questions.mdmarkdown1.9 KB
references/tasks/share-asset.mdmarkdown1.8 KB
references/verified-questions.mdmarkdown4.6 KB
references/viz-authoring.mdmarkdown41.3 KB

references/tasks/query-model.md

View on GitHub
# Task: Query an existing model

Pull figures from an already-built SDM via `run_semantic_query`: a plain count,
total, or scalar ("how many / how much / what is total…"), a "give / run me the
numbers" retrieval, or a structured table. The model does **not** have to be
named up front — discover it with `list_semantic_models` when it isn't given.
Prefer this over `analyze_data` whenever the user wants the figures themselves
rather than an interpreted breakdown, ranking, trend, or comparison.

Raw SQL against a DLO/DMO (`run_query`) also enters here when no SDM covers
the data or the user asked for SQL — still prefer `run_semantic_query` when
an SDM exists.

Interpreted breakdowns, rankings, trends, and comparisons go to
`analyze-data.md` / `analyze_data`. Scoring candidate SQL against expected
SQL is `review-verified-questions.md` (`run_regression_evaluator`) — it
does not query data.

## Gates (assert before any tool call) → `../shared-gates.md`

Required: **G1, G2, G3** · Conditional: **G4** (◐, if querying across objects),
**G6** (◐, if you don't yet understand what the returned numbers mean)

- **G1** (router-asserted): a `mcp__tableau-next-*__` tool must be connected.
- **Tool names are written bare** — invoke each under your client's name for that `tableau-next-*` server tool (`shared-gates.md`).
- **G2:** the target object has rows (a query over an empty object returns empty).
- **G3:** reference fields by their exact stored apiName — read back via `list_*`
  if unsure; never invent a suffixed name.
- **G4** (◐): only query across objects that are actually joined; do not set
  `queryUnrelatedDataObjects:"Exception"` and query across unjoined objects.
- **G6** (◐): if the additivity/grain of the returned numbers isn't understood,
  profile first (`../data-understanding.md`).

## Steps

If the user did not name an SDM, call `list_semantic_models` and pick the
matching populated model before querying.

The proto-shaped `run_semantic_query` body, field-shape matrix, recovery strings,
aggregation enum, detail-row, and `filter` XOR `flatten_filter` payloads are in
**`../semantic-query-and-enrichment.md`**.

- **Prefer `run_semantic_query` when an SDM exists** for the data. Fall back
  to `run_query` (Data Cloud / Hyper SQL against a DLO `__dll` or DMO `__dlm`)
  when the user asks for raw SQL, no SDM covers the tables, or you are
  checking ingest materialization (`ingest-and-metric-gotchas.md` §A).
  Discover SQL table names from `list_semantic_model_data_objects`
  `dataObjectName` when an SDM is in play — that value already includes the
  suffix and is ground truth. Otherwise use the suffixed DLO/DMO developer
  name (`__dll` DLO, `__dlm` DMO). A bare DMO name (no `__dlm`) fails with
  `42P01` / "table does not exist". Double-quote reserved words and names
  with spaces.
  `run_query` is Hyper SQL (full SELECT / WHERE / GROUP BY / JOIN /
  aggregates / windows). That is a **different** engine from the SparkInternal
  DCSQL subset on `create_data_transform` / `update_data_transform` — do not
  copy those unsupported-op restrictions onto `run_query`, or vice versa.
  `run_query` returns the **first chunk only** — if `returnedRows` looks short
  or `status.completionStatus` is not `Finished`, say so and narrow with WHERE
  / a lower `rowLimit`. Pagination tools (`query_data_status`, `query_data_rows`)
  are not available. Response `data` is an array of **row arrays** (values in
  `metadata` order), not row objects — join column names/types from the
  separate `metadata` array.
  Bind user input with `:name` placeholders and `sqlParameters` (the `name`
  field is `"p1"` for `:p1`, no colon). `name` and `value` are required on every
  parameter; `value` is always a serialized **string**. `type` defaults to
  Varchar — set Integer / BigInt / Double / Boolean / Date / DateTime for
  non-string columns (`type` tells the server how to interpret the string).
  `dataspace` is optional; omitting it targets **default**. In a
  multi-dataspace org that is easy to get wrong — pass the dataspace that
  actually holds the `__dll` / `__dlm` (same name used on create/mapping)
  rather than assuming default.

- Pass **ONE** of `structuredSemanticQuery` (recommended) **OR**
  `structuredMetricQuery` — mutually exclusive. Prefer an existing metric
  (`structuredMetricQuery`) / calc measure over reconstructing a `SUM(...)`
  aggregation inline.
- Write the semantic-query body in **snake_case proto** shape (`table_field`,
  `grouping`, `semantic_aggregation_method`) — REST-gateway camelCase examples
  fail here.
- Group by the correct date grain (e.g. month), not by a raw timestamp.
- Query is org-level / SDM-level — it does **NOT** take a `workspaceId`. Any SDM
  visible via `list_semantic_models` is queryable regardless of workspace.
- Provisioning is gated on `orgHasDataCloudReportingEnabled` /
  `orgHasSemanticQuery`. A permission error is a **provisioning gap**, not a
  caller payload bug.
- **Display:** render rows as a markdown table for ≤20 rows, else row count +
  first 10 + "… and N more". Order by `placeInOrder`. Do **NOT** echo the raw
  `queryResults` JSON. Surface `errorMessage` verbatim on failure.

This is a read/query entry point — it does not model, enrich, or visualize. If the
answer needs a chart, continue to `create-viz.md` (which re-asserts G7 before
charting).
deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall