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/admin-users.md

View on GitHub
# Admin users and licenses — payloads and gotchas

Load this from `tasks/provision-user.md`. Not a first hop.

Tableau Next **role** provisioning is org-admin, not asset ACL. Sharing an
asset (`search_users_and_groups` / `add_asset_share`) stays on
`tasks/share-asset.md`.

The MCP tools are namespaced per server — names here are bare; use whichever
server prefix is connected.

## Contents

- `get_users` — list / search (ADMIN-ONLY)
- `get_license_availability` — seats before ADD or role upgrade
- `upsert_user` — ADD / UPDATE / REVOKE / DEACTIVATE (never on the request turn)

All three tools are **ADMIN-ONLY**. If any returns a permission / unauthorized
error, report it and **STOP**. Do not retry and do not fall back to analyst
tools (`search_users_and_groups`, share tools, ingest). Unauthorized here means
the current user is not a Tableau Next admin.

---

## `get_users`

Retrieve Tableau Next users for admin management. Only **Standard** users are
returned. Filters apply **server-side**, so `limit` / `offset` is the filtered
set, not the unfiltered org.

**Inputs (all optional):**

- `searchQuery` — case-insensitive substring on name, username, or email
- `role` — exact: `ADMIN`, `ANALYST`, `SELF_SERVICE_ANALYST`,
  `SELF_SERVICE_CONSUMER`, `CONSUMER`. Unrecognized values are rejected
- `license` — permission-set-license key; users whose role grants it
- `isActive` — `true` / `false`; omit for both
- `limit` — default 50, capped at 2000
- `offset` — **omit on the first page** (starts at 0)

**Returns:** `items[]` (`id`, `name`, `email`, `isActive`, plus derived `role`
and `license` when the user holds a Tableau Next role), `size`, `nextOffset`.

**Pagination.** Omit `offset` on the first call. Pass the returned
`nextOffset` back as `offset`. Continue until a page has fewer than `limit`
items (or is empty).

**Use when:** browse or find users before granting or revoking a role.

---

## `get_license_availability`

Call **before** `upsert_user` ADD or a role upgrade. When `available` is `0`
or `exhausted` is `true` for the target license class, **warn** and do not
attempt the change.

**Inputs (optional):** `licenseType` — same role enum as `get_users`. Omit to
return every Tableau Next license class.

**Returns:** `items[]` with `licenseKey`, `label`, `total`, `used`,
`available`, `exhausted`, plus `size`.

---

## `upsert_user`

Provision a Tableau Next user by role. **Never call on the turn the admin
makes the request.** Present a per-action preview (below) and wait for
explicit approval in a **separate** turn. This applies to every action,
including ones that look clear or urgent.

The caller must choose the action. This tool never infers ADD vs UPDATE vs
REVOKE vs DEACTIVATE.

### Required inputs

- `action` — `ADD` | `UPDATE` | `REVOKE` | `DEACTIVATE`
- `email` — also the login / username
- `firstName`, `lastName`
- `role` — `ADMIN` | `ANALYST` | `SELF_SERVICE_ANALYST` |
  `SELF_SERVICE_CONSUMER` | `CONSUMER`

Optional: `localeSidKey` (e.g. `en_US`), `timeZoneSidKey` (e.g.
`America/Los_Angeles`), `alias`.

`forceDeactivate` (boolean, DEACTIVATE only, default `false`) — set `true`
**only** after the admin consents to deactivate a Personal Org owner.

**Returns:** `created`, `userId`, and a human-readable `message`.

### What each action does

- **ADD** — creates a brand-new user and grants the role.
- **UPDATE** — sets an **existing** user to the role. Roles are mutually
  exclusive: switching Admin → Analyst leaves Analyst only. Permission set
  and permission-set license for the new role are granted; any other Tableau
  Next role permission set is removed.
- **REVOKE** — removes the role's permission set(s); the user remains active.
- **DEACTIVATE** — sets the user inactive (cannot log in). Role permission
  sets stay in place.

`firstName` / `lastName` apply **only on ADD**. They are ignored for UPDATE,
REVOKE, and DEACTIVATE. This tool **cannot rename** an existing user — tell
the admin that if they ask.

### ADD CONFLICT ≠ silent UPDATE

ADD fails with **CONFLICT** when a user already exists for the email. That is
intentional. **Do not** silently retry as UPDATE. Report the conflict and get
explicit confirmation before granting the role via UPDATE (UPDATE changes that
user's permissions).

### "Remove access" ≠ DEACTIVATE

Never infer DEACTIVATE from an ambiguous instruction. "Remove access" may mean
REVOKE (drop the Tableau Next role) or an **asset share** revoke
(`share-asset.md`). Ask. DEACTIVATE is the most destructive: the user loses
login and access to their Tableau Next content and assignments.

### Personal Org owner CONFLICT

The tool enforces the Personal Org owner check **server-side**. First
DEACTIVATE call: omit `forceDeactivate` (or pass `false`). If the user owns
one or more Personal Orgs, the tool does **not** deactivate them; it returns
CONFLICT stating they own a Personal Org and will be removed as owner.

Relay that to the admin. Only if they **explicitly consent** re-invoke
DEACTIVATE with `forceDeactivate=true`. Never set `forceDeactivate` true on
the first call.

### Preview formats (mandatory, all actions)

**(ADD)** Structured summary of the new user — name, email, role, permission
set(s), license type — then: "This user has not been created yet. Please
confirm to proceed."

**(UPDATE)** Side-by-side Current vs Proposed for every field that will
change (role, permission set(s), permission-set license(s)) — then: "These
changes have not been saved yet. Would you like to proceed?"

**(REVOKE)** Summarize the role and permission set(s) that will be removed.
Confirm before calling.

**(DEACTIVATE)** After describing access/content impact, show:
"⚠️ This will deactivate [name] ([email]) and revoke their access." then
"Please confirm to proceed." If the first call returns the Personal Org
owner CONFLICT, add "They will be removed as personal org owner." and
re-confirm before `forceDeactivate=true`.
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