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/edit-sdm.md

View on GitHub
# Task: Edit the semantic model — add a raw object / field / join / logical view

Create a model, or add a **raw** data object, dimension, measure, relationship,
logical view, or parameter to one. (For **calculated** dimensions/measures/metrics, use
`enrich-model.md`.) Entry points 7, 8, 9, 10.

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

This guide serves five mutating intents; required gates differ per intent:

- **Create new model (entry 7):** Required **G1, G2, G5** · Conditional **G6**
  (◐). Nested explicit fields mean you control apiNames at create; still
  light-confirm with `list_*` before relationships (G3).
- **Add data object (entry 8):** Required **G1, G2, G3, G5** · Conditional **G4**
  (◐, once ≥2 objects — no islands), **G6** (◐).
- **Add dimension / measure (entry 9):** Required **G1, G2, G3, G5** ·
  Conditional **G6** (◐). Use this only to add a *single extra field* to an
  already-bound object — not for the initial bind.
- **Add relationship / join (entry 10):** Required **G1, G2, G3, G4, G7**. A raw
  join creates no metadata, so G5 does not apply.
- **Add logical view (HardJoin / Union / CustomSQL):** Required **G1, G2, G3, G5**.
  Field apiNames are assigned at first save — read them back with
  `get_semantic_model_logical_view` before joining. `Hierarchy` is **not
  currently supported via MCP**.

- **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:** COUNT(*) the source object before adding it — never add a 0-row object.
- **G3:** read apiNames back with `list_*` before writing any relationship criteria
  or field reference (semantic apiName + `leftFieldType: "TableField"`). For a
  logical view, read assigned names from `get_semantic_model_logical_view`.
- **G4:** once ≥2 objects exist, no islands — ◐ when adding an object (entry 8),
  **required** when adding a relationship (entry 10).
- **G5** (create model / add object / add field / add logical view — not raw
  joins): set the required metadata at creation and prefer **nested explicit
  fields** on `create_semantic_model` / `add_semantic_model_data_object`
  (`shouldIncludeAllFields: false`) — full metadata list in `shared-gates.md`
  G5. CustomSQL **requires** explicit fields (`shouldIncludeAllFields` does
  not satisfy validation).
- **G7** (add-relationship): after adding, confirm the join key matches real rows
  with a JOIN row-count — ~0 rows = broken.
- **G6** (◐): if a column's role/type isn't understood, profile first
  (`../data-understanding.md`) — but do NOT re-run Step 0 ingest on a pre-existing
  model.

## Steps

Tool-by-tool input shapes, suffix rules, the apiName-mutation gotcha, and
logical-view shapes are in **`../sdm-tool-reference.md`**; the numbered spine
(create model with nested fields, add objects, add relationships) is
`../build-workflow.md` Steps 4–6.

- **Create model** — `create_semantic_model` + `update_semantic_model` (Step 4).
  Nested `semanticDataObjects[].label` is REQUIRED. Bind fields **in this
  call**: `shouldIncludeAllFields: false` plus explicit
  `semanticDimensions[]` / `semanticMeasurements[]` (fetch fields first;
  include join keys). Relationships, metrics, calcs, parameters, and logical
  views are still post-create `add_semantic_model_*`. **Extend a Model** uses
  the same tool with `baseModels[]` of `{ "apiName": "<existing SDM>" }` in
  the same `dataspace` (typical label `"<Base Label> (Extended)"`; payload in
  **`../sdm-tool-reference.md`**). Prefer **anchor-plus-nested-fields create**,
  then incremental `add_semantic_model_data_object` with the same nested
  arrays. If a table has no FK to the anchor, add the intermediate first,
  then bridge through it. Bulk-create timeout (`postSemanticModelCollection`)
  may still persist the SDM — wait ~30s and `list_semantic_models` before
  retrying (naive retry → Unique constraint violated). Optional sanity check:
  `get_semantic_model` with `includeModelContent=true`.
- **Add data object** — `add_semantic_model_data_object` (`dataObjectType:"Dmo"`,
  name `*__dlm`) with nested `semanticDimensions[]` /
  `semanticMeasurements[]` (`shouldIncludeAllFields: false`). Omit
  `primaryNameField` at create (G5 known gap).
- **Add dimension / measure** — `add_semantic_model_dimension` / `_measure`
  only for a *single extra field* on an already-bound object. Do **not** use
  these for the initial bind (that is the nested create / add-data-object
  path above).
- **Add relationship / join** — `add_semantic_model_relationship`
  (`leftFieldType:"TableField"`, `joinType:"Auto"`, `label` required even though
  schema marks it optional). Validate the join with a real JOIN row-count (G7).
- **Add / update a parameter** — post-create only (`add_semantic_model_parameter`;
  cannot be created inline on `create_semantic_model`). Updates are PUT, not
  PATCH — re-send `label`/`type`/`dataType`/`defaultValue` even for a
  description-only change. `List` needs `values` and a matching `defaultValue`.
  Shapes: **`../sdm-tool-reference.md`** (Parameters).
- **Add logical view** — `add_semantic_model_logical_view`. Enumerate existing
  views via `get_semantic_model` (`semanticLogicalViews[]`) first. `label` is
  required. Rules and reference payloads: **`../sdm-tool-reference.md`**
  (Logical views).
  - **HardJoin 3-step:** objects only → GET assigned apiNames → relationship
    with LV `joinType` `Left`/`Right`/`Inner`/`Full` (**not** `Auto`). Prefix
    LV object apiNames `LV_`.
  - **Union:** exactly one `semanticUnions[]` entry. **Do NOT pass
    `"semanticViewTypeEnum": "Union"`**. Mapped-field apiNames are
    **locally-scoped** on that ULV object.
  - **CustomSQL:** `customSQLV2`; exactly one `CustomSQL` data object with
    **explicit** dims/measures.
  - **Update (PATCH):** `update_semantic_model_logical_view` only persists
    `description`, `filterLogic`, and `filters`. Empty body `{}` is rejected.
    GET via `get_semantic_model_logical_view` first before replacing filters.
    **Label is silently ignored** (API accepts it, never persists). SQL or
    view-type changes require delete-and-recreate — do not treat a 2xx PATCH
    as a successful rename or SQL edit.
  To remove a logical view, see **`../sdm-tool-reference.md`** (Deleting) —
  a blocked LV delete is HTTP 500 `DEPENDENCY_EXISTS` (do not retry).

Do NOT re-profile from scratch or re-ingest on an already-built model — assume the
model exists and touch only what the request names.
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