Skip to main content

Get Started with Alteryx Skills

Alteryx Skills let supported AI coding assistants work with local Designer workflows. You can use them to build, inspect, run, and repair trusted workflows for repeatable business analysis.

Use Alteryx Skills for tasks such as data preparation, reconciliation, compliance reporting, operational analytics, governed calculations, and other reusable business logic.

The public Alteryx Skills repository is available here.

Supported AI Assistants

Alteryx Skills can be installed for:

  • Codex

  • Antigravity

  • Claude Code

  • Claude Desktop

What the Alteryx Plugin Includes

The plugin contains 3 skills:

  • alteryx-designer

  • alteryx-asset-discovery

  • alteryx-insights

Agents can select alteryx-designer automatically when your request clearly involves local Designer workflows, such as:

  • Building a workflow.

  • Editing a YXMD file.

  • Running a workflow with Designer Engine.

  • Repairing execution errors.

  • Validating workflow outputs.

Agents can select alteryx-asset-discovery automatically when your request depends on knowing what already exists, such as:

  • Locating workflows, macros, or data related to a business question.

  • Checking whether logic already exists elsewhere.

  • Grounding a new build in real, existing data.

  • Verifying a dataset's schema before you use it.

  • Finding example XML for a tool that isn't natively supported.

This skill is read-only. It doesn't modify workflows, macros, or data.

Agents can select alteryx-insights automatically when your request asks a business data question, such as:

  • Analyzing totals, trends, or changes between periods.

  • Evaluating goal variance, correlations, or outliers.

  • Looking up exact records or rankings.

  • Producing grouped summaries from governed datasets.

This skill is powered by Alteryx Auto Insights and works only with governed Alteryx One datasets.

Before You Begin

Make sure you have a supported AI assistant, a local Designer installation, and authorization to use the relevant Alteryx products, files, data, accounts, workspaces, services, and permissions.

Workflow inspection and XML editing can proceed without Designer, but workflow execution and run validation require local Designer Engine access.

Asset discovery and insights queries require authorization to the relevant Alteryx One workspaces and governed datasets.

These skills do not bypass Alteryx authentication, authorization, workspace controls, product terms, service terms, or entitlement checks.

Install Alteryx Skills

Choose the installation option for your AI assistant.

Codex

Use the Codex App option as the primary installation path.

  1. Open Codex App.

  2. Select Plugins from the left navigation.

  3. Select the dropdown arrow next to the + symbol.

  4. Select + Add marketplace.

  5. In the Source field, enter alteryx/skills.

  6. Select Add marketplace.

  7. Search Plugins for Alteryx.

  8. Select Install next to the Alteryx plugin.

Optional CLI command:

 codex plugin marketplace add https://github.com/alteryx/skills.git

Use @Alteryx or $alteryx:alteryx-designer, $alteryx:alteryx-asset-discovery, or $alteryx:alteryx-insights to invoke the corresponding Alteryx skill in Codex.

Antigravity

 agy plugin install https://github.com/alteryx/skills.git

Use /alteryx:alteryx-designer, /alteryx:alteryx-asset-discovery, or /alteryx:alteryx-insights to invoke the corresponding skill.

Claude Code

 claude plugin marketplace add https://github.com/alteryx/skills.git
 claude plugin install alteryx

Start Claude Code with the claude command. Use /alteryx:alteryx-designer, /alteryx:alteryx-asset-discovery, or /alteryx:alteryx-insights to invoke the corresponding skill.

Claude Desktop

  1. Open settings.

  2. Select Plugins.

  3. Select the Add dropdown menu.

  4. Select Add marketplace.

  5. Paste alteryx/skills into the text box and select Sync.

  6. Select the + symbol next to the Alteryx plugin.

Use /alteryx-designer, /alteryx-asset-discovery, or /alteryx-insights in a chat.

Verify Installation

After installation, restart your AI assistant if needed. Confirm that the Alteryx plugin and its skills (alteryx-designer, alteryx-asset-discovery, alteryx-insights) are available.

 Inspect this .yxmd and explain what the workflow does.

Use Alteryx Skills

Your AI assistant might automatically select the Alteryx skill when your request clearly involves Designer workflows, existing assets, or a business data question.

 Build an Alteryx workflow that joins these customer and order files, filters inactive accounts, and writes a reconciled output.
 Inspect this .yxmd and explain why the final output is missing the expected revenue column.
 Run this Designer workflow and fix any configuration errors that prevent it from completing.
 Find any existing workflows or macros that already reconcile customer and order data before I build a new one.
 What's the schema for the accounts dataset, and has anyone already validated it?
 Why did revenue drop 12% quarter-over-quarter for the West region, and which accounts drove the change?
 Give me the exact ranking of the top 10 accounts by ARR this quarter from the governed sales dataset.

Runtime Requirements

Workflow execution requires a local Designer installation.

Asset discovery and insights queries require access to the relevant Alteryx One workspaces and governed datasets.

Updating Alteryx Skills Plugin

Claude and Codex (ChatGPT) desktop apps let you update the plugin from the settings menu.

Update in Claude App

  1. Open settings (Ctrl , or select your profile name, then Settings).

  2. Select Plugins.

  3. Select Browse.

  4. Select the Personal tab.

  5. Select the three-dot menu next to skills, above the Alteryx plugin.

  6. Select Check for Updates.

  7. A confirmation message appears in the lower-right corner of the screen when the update finishes.

Update in OpenAI App (Codex/ChatGPT)

  1. Open settings (Ctrl , or select your profile name, then Settings).

  2. Select Plugins.

  3. Select the Marketplace tab.

  4. Select Upgrade next to the plugin name.

  5. A confirmation message appears at the top of the screen when the update finishes.

Update in Antigravity

Updating the Antigravity plugin requires CLI commands. Open PowerShell and run the following commands 1 at a time.

  1. Run agy plugin list to view your installed plugins. Note the importedAt date for the alteryx plugin (this is the last time you installed it).

  2. Run agy plugin uninstall alteryx to remove the plugin and purge its package directory.

  3. Run agy plugin install https://github.com/alteryx/skills.git to reinstall the plugin. This is the same command you used for the initial install, and it pulls the most recent version from GitHub.

  4. Run agy plugin list again to confirm that you installed the most recent version of the plugin.

Troubleshooting

The Plugin Is Not Available

Restart your AI assistant after installation. Then check whether the Alteryx plugin or its skills (alteryx-designer, alteryx-asset-discovery, alteryx-insights) are listed.

The Assistant Can Inspect a Workflow but Can't Run It

Confirm that Designer is installed locally.

The Assistant Can't Access a File

Confirm that the file exists locally and that your AI assistant has access to the folder where the file is stored.

The Assistant Can't Find an Expected Asset or Dataset

Confirm that you're authorized to the relevant Alteryx One workspace and that the asset or dataset is governed and accessible from it.

The Command Is Not Found

Confirm that the required AI assistant or CLI is installed. Then review the installation procedures for the app you use.

Releases

Public releases use semantic version tags and are documented in the repository changelog at https://github.com/alteryx/skills/releases.

License and Notices

Repository materials are licensed under the Apache License, Version 2.0. Go to the repository license and notice files for details.

Repository materials are provided on an "AS IS" basis, without warranties or conditions of any kind, express or implied.

The repository license applies only to the materials in the repository. It does not grant rights to Alteryx products, hosted services, APIs, customer data, non-public documentation, trademarks, logos, or branding.

This GitHub repository is a read-only public mirror. Pull requests opened in the public mirror are not accepted.

Product and Service Access

Alteryx Skills do not bypass Alteryx authentication, authorization, workspace controls, product terms, service terms, or entitlement checks.

You are responsible for using authorized Alteryx accounts, workspaces, products, services, data, and permissions.

Feedback and Support

If you are participating in a guided preview, contact your Alteryx representative or Solutions Engineer for setup help and feedback collection.

En esta sección: