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/build-dashboard.md

View on GitHub
# Task: Design / create a dashboard

Design a dashboard narrative, create a **new** dashboard, or add a global
filter. Entry points 18, 19, 21. (Entry point 20, "add/edit a widget on an
existing dashboard," now lives in `edit-dashboard.md`.)

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

Required: **G1, G8-full** · plus per-action:
- **Design narrative (18):** G1, G8-full · Conditional **G6** (◐, if you don't
  yet understand what the underlying data means).
- **Create dashboard (19):** G1, **G2/G7** (transitive), G3, G8-full.
- **Add global filter (21):** G1, G3 only — do NOT over-gate with G2/G7/G8.

- **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`).
- **G8-full (decision #1):** design the narrative FIRST — KPIs → trends →
  breakdowns → correlations, KPIs top/left on the F/Z path, chart-type diversity
  (`../dashboard-design-principles.md`, MANDATORY for a dashboard).
- **G2/G7 (transitive):** a dashboard is only as valid as its widgets — each
  viz/metric widget's underlying query must have returned real rows first.
- **G3:** read back the exact metric apiName / viz `id`+`name` before referencing
  them in a widget.
- **G6** (◐, narrative design): if you don't yet understand grain/additivity of
  the data the narrative is built around, profile first (`../data-understanding.md`).

## Hard constraint — viz-type widgets (decision #2)

A **viz-type widget requires the `id` + generated `name` returned by a prior
`create_visualization` call** (`upsert_visualization_widget`'s `source: {id,
name}` — `../edit-dashboard.md` §2). This dashboard shell can self-serve
**metric + text** widgets once built, but **not** a viz widget from nothing. So:

- **Metric / text widgets:** self-serve via `tasks/edit-dashboard.md` once the
  shell exists.
- **Viz widget:** either (a) **compose** the `create-viz.md` flow first to get the
  `id`+`name`, or (b) **accept** a pre-existing viz `id`+`name` the user supplies.
  If the user asks for a chart on the dashboard and no viz exists yet, route
  through **`create-viz.md`** first, then place its `id`+`name` as a viz widget
  via `tasks/edit-dashboard.md`.

## Steps

Dashboard creation and the 48-column grid spec are in
**`../dashboard-authoring.md`**; `../build-workflow.md` Step 11 is the spine.
Once the shell exists, all widget/page editing — metric, viz, text, or any
other widget kind — routes through **`edit-dashboard.md`** via
**`tasks/edit-dashboard.md`**; this guide covers create + design + global
filter only.

- **Create empty shell** — `create_dashboard` (`widgets:{}`; seed one layout
  with an empty `page_1` since widgets get placed next — `layouts:[]` only if
  they won't — and always pass `minorVersion: -1` explicitly —
  `../dashboard-authoring.md` §1).
- **Metric / viz / text / any other widget** — hand off to
  **`tasks/edit-dashboard.md`** (`edit_dashboard`'s `upsert_*_widget` +
  `place_widget_on_page`, staged as a draft, saved only on confirmation) — the
  only supported path for widget/page editing.
- **Global filter** — `add_global_filter_to_dashboard`; self-contained (no
  separate read/replace round trip), value-matching rule of thumb, and the
  contrast with a per-viz filter — `../dashboard-authoring.md` §5.
- **Metric-card insight payload (app renderer only)** — `../insight-bundle.md`.
  Do **not** call `generate_insight_bundle` on a user chat turn.
- **Show / open an existing dashboard** — `render_dashboard`, not
  `get_dashboard`. Flags and metadata-vs-render split:
  `../dashboard-authoring.md` §8.
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