ThoughtSpot Agent Skills

# ThoughtSpot Agent Skills

AI agent skills for working with ThoughtSpot — platform conversion, semantic
model authoring, multi-tenancy governance, and data querying. Packaged for
**Claude Code**, **Cortex Code CLI**, **Snowsight**, and **Databricks**.

---

## Skills

32 skills across six categories. Each ✓ in the runtime columns links to the
SKILL.md for that runtime. For why an individual skill exists, who tends to need it,
and when to reach for it, see [skill personas](docs/skill-personas.md).

| Category | Problem it solves | Skills |
|---|---|:-:|
| [Setup](#setup) | Nothing else runs until credentials and data exist | 8 |
| [Conversion](#conversion) | The semantics already exist elsewhere, and rebuilding them by hand is what stalls a migration | 10 |
| [Semantic Authoring](#semantic-authoring) | A Model that imports cleanly can still answer badly or run slowly | 6 |
| [Platform & Governance](#platform--governance) | Many audiences, one definition, without a copy per tenant | 5 |
| [Query](#query) | Getting data out programmatically, and seeing the SQL behind a disputed number | 1 |
| [Recipes](#recipes) | The same analytical need recurs account after account | 2 |

<a id="setup"></a>
<details open>
<summary><strong>Setup</strong> — Credentials, infrastructure, data loading, and tenancy configuration</summary>

&nbsp;

| Skill | What it does | Category | CLI | Snowsight | DBX |
|---|---|---|:-:|:-:|:-:|
| [`ts-profile-thoughtspot`](agents/cli/ts-profile-thoughtspot/SKILL.md) | Add, update, test, or delete ThoughtSpot profiles | Credentials | [✓](agents/cli/ts-profile-thoughtspot/SKILL.md) | [✓](agents/coco-snowsight/ts-profile-thoughtspot/SKILL.md) | — |
| [`ts-profile-snowflake`](agents/claude/ts-profile-snowflake/SKILL.md) | Add, update, test, or delete Snowflake profiles (Claude Code only — Cortex Code manages connections natively) | Credentials | [✓](agents/claude/ts-profile-snowflake/SKILL.md) | — | — |
| [`ts-profile-databricks`](agents/cli/ts-profile-databricks/SKILL.md) | Add, update, test, or delete Databricks profiles — Service Principal (OAuth M2M), PAT, or existing CLI profile | Credentials | [✓](agents/cli/ts-profile-databricks/SKILL.md) | — | — |
| [`ts-profile-tableau`](agents/cli/ts-profile-tableau/SKILL.md) | Add, update, test, or delete Tableau Server/Cloud profiles — password or PAT auth | Credentials | [✓](agents/cli/ts-profile-tableau/SKILL.md) | — | — |
| [`ts-load-source-data`](agents/cli/ts-load-source-data/SKILL.md) | Load CSV data into Snowflake (or generate synthetic data from schema definitions) for ThoughtSpot to connect to | Data | [✓](agents/cli/ts-load-source-data/SKILL.md) | — | — |
| [`ts-setup-sv`](agents/coco-snowsight/ts-setup-sv/SKILL.md) | Install or upgrade stored procedures required by Snowsight skills | Infrastructure | — | [✓](agents/coco-snowsight/ts-setup-sv/SKILL.md) | — |
| [`ts-setup-tenancy`](agents/cli/ts-setup-tenancy/SKILL.md) | Stand up a reproducible multi-tenancy **test environment** — Orgs, per-Org groups and users, warehouse tables, and optionally a published Model with per-tenant aliases and column security. Four scenarios (`topology` / `per-org` / `published` / `mixed`) covering the pre-migration state, the post-migration target, and the transition between them | Tenancy | [✓](agents/cli/ts-setup-tenancy/SKILL.md) | — | — |
| [`ts-migrate-orgs`](agents/cli/ts-migrate-orgs/SKILL.md) | Move a tenant Org's bespoke content off its own Table/Model copies onto a **governed published Model**, then retire the old Org. The counterpart to `ts-publish-orgs`: sizes Sets blockers, audits the column mapping, then runs a resumable backup → lift → rename → repoint → cleanup with the untouched source Org as the rollback | Tenancy | [✓](agents/cli/ts-migrate-orgs/SKILL.md) | — | — |

</details>

<a id="conversion"></a>
<details>
<summary><strong>Conversion</strong> — Move semantic models between ThoughtSpot and external platforms</summary>

&nbsp;

| Skill | What it does | Platform | Coverage | CLI | Snowsight | DBX |
|---|---|---|---|:-:|:-:|:-:|
| [`ts-convert-to-databricks-mv`](agents/cli/ts-convert-to-databricks-mv/SKILL.md) | Convert a ThoughtSpot model to a Databricks Metric View (v0.1 single-source or v1.1 multi-source) | Databricks | [coverage](agents/cli/ts-convert-to-databricks-mv/references/coverage-matrix.md) | [✓](agents/cli/ts-convert-to-databricks-mv/SKILL.md) | — | [✓](agents/databricks/skills/ts-convert-to-databricks-mv/SKILL.md) |
| [`ts-convert-from-databricks-mv`](agents/cli/ts-convert-from-databricks-mv/SKILL.md) | Convert a Databricks Metric View into a ThoughtSpot Model (dimensions → attributes, measures → measures/formulas) | Databricks | [coverage](agents/cli/ts-convert-from-databricks-mv/references/coverage-matrix.md) | [✓](agents/cli/ts-convert-from-databricks-mv/SKILL.md) | — | [✓](agents/databricks/skills/ts-convert-from-databricks-mv/SKILL.md) |
| [`ts-convert-to-dbt`](agents/cli/ts-convert-to-dbt/SKILL.md) | Generate a dbt project

... (truncated)