Customize Tableau Studio Skills


On This Page

Skills give Tableau Agent the context that shapes its behavior. You can override Tableau Studio’s standard Skills, add Skills from Tableau Exchange, or create and share your own.

Note Tableau Studio Skills are formatted and optimized for Tableau Agent. Start any new Skill with /skill-creator. When you modify a Skill, keep its structure intact and change only the parts that affect the behavior you want.

Tableau Agent Skills overview

A Skill gives the agent context to do something reusable. To see your installed Skills, select the / icon at the bottom of the chat window.

Tableau Agent ships with standard Skills for common tasks. You can add your own Skills or Skills from Tableau Exchange, and you can customize overridable standard Skills.

Skills live in the ~/Documents/My Tableau Repository/Tableau Agent/skills/ folder. Your custom Skills and overrides go in that folder. Standard Skills live in .vendored/overridable/ and .vendored/protected/.

Note Don’t edit files in .vendored/. These folders are rebuilt at the start of each session, so changes are lost. To change an overridable Skill, create an override (see below). Protected Skills can’t be overridden.

~/Documents/My Tableau Repository (Beta)/
└── Tableau Agent/
    └── skills/
        ├── .vendored/                         # bundled standard skills — rebuilt each session; do not edit
        │   ├── overridable/                   # standard skills you may override
        │   │   ├── .markers/                  # one .sha256 per overridable skill
        │   │   ├── insights/
        │   │   │   └── SKILL.md
        │   │   └── tableau-desktop-authoring/
        │   │       └── SKILL.md
        │   └── protected/                     # core skills that cannot be overridden
        │       ├── author-extension/
        │       │   └── SKILL.md
        │       ├── skill-creator/
        │       │   └── SKILL.md
        │       ├── tableau-agent-debug/
        │       │   └── SKILL.md
        │       └── tableau-workbook-cli/
        │           └── SKILL.md
        ├── <my-skill-override-name>/           # your override skill — same name as the overridable skill
        │   └── SKILL.md
        └── <my-skill-name>/                    # your added custom skill
            └── SKILL.md

Each Skill is a folder containing a SKILL.md with a name and description. The folder name must match the name exactly.

Use /skill-creator and natural language

To create a Skill, type /skill-creator <description of your Skill> in the chat. To work out the details first, use plan mode (the checklist icon in the chat box). Describe the basics and ask the agent to flesh out the plan. When you’re ready, switch out of plan mode and tell the agent to create the Skill.

/skill-creator performs even better the more tightly scoped the Skill is. Describe one job, when the Skill should and shouldn’t be used, and the output you expect.

Then run the /reload-skills command, and your new Skill appears in the / list. Its files are in ~/Documents/My Tableau Repository/Tableau Agent/skills/.

Add a Skill from Tableau Exchange

  1. In the Tableau Agent chat, select More Actions in the top-right toolbar, then select Skills.
  2. Select + Add skill. The Skills Exchange opens in a new window.
  3. Search or browse by category.
  4. Select a Skill to see what it does and its example trigger phrases.
  5. Select Download.

The Skill downloads to Tableau Agent and appears at the bottom of the Skills list, ready to use. You can also find the standard Skills and their source at Tableau AI Utilities, or report issues on the tableau-ai-utilities repo.

Manually add a Skill

To install a Tableau Studio Skill someone shared with you, place its folder in ~/Documents/My Tableau Repository/Tableau Agent/skills/ and run /reload-skills. Only install Skills from sources you trust; some Skills run scripts on your machine.

Override a standard Skill

You can override an overridable standard Skill by asking Tableau Agent (plan mode recommended), or manually:

  1. Copy the Skill’s folder from .vendored/overridable/.
  2. Paste it into ~/Documents/My Tableau Repository/Tableau Agent/skills/, keeping the same folder name and name.
  3. Edit the copy.
  4. Run /reload-skills.

Your override replaces the standard Skill.