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 1 skill:

 alteryx-designer

Agents can select this skill 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.

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.

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 alteryx/skills

Use @Alteryx or $alteryx:alteryx-designer to invoke Alteryx Skills in Codex.

Antigravity

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

Use /alteryx:alteryx-designer to invoke the Designer skill.

Claude Code

 claude plugin marketplace add alteryx/skills claude plugin install alteryx

Start Claude Code with the claude command. Use /alteryx:alteryx-designer to invoke the Designer 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 in a chat.

Verify Installation

After installation, restart your AI assistant if needed. Confirm that the Alteryx plugin or alteryx-designer skill is 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.

 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.

Runtime Requirements

Workflow execution requires a local Designer installation.

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 alteryx-designer skill is 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 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.

Nesta secção: