UiPath CLI - uip skills

uipath-cli

latest

false

UiPath CLI user guide

uip skills

Syntax and options for `uip skills`, which installs, updates, and removes UiPath coding-agent skill packs.

uip skills installs, updates, and removes UiPath skills for supported AI coding agents. Skills are curated prompt packs that teach an agent how to use UiPath's CLI tools to build automations, agents, flows, and orchestrations. See Skills for the concept, install model, and the agent-by-agent install locations.

This page documents the commands. For what skills are and why to install them, read the concept page first.

Synopsis

uip skills list      [--local] [--repo <url>] [--branch <name>]
uip skills search    <query> [--local] [--limit <n>] [--repo <url>] [--branch <name>]
uip skills show      <name> [--local] [--repo <url>] [--branch <name>]
uip skills install   [--agent <agent>] [--skip-if-no-agent] [--local] [--path <dir>] [--repo <url>] [--branch <name>] [--force]
uip skills update    [--agent <agent>] [--local]
uip skills uninstall [--agent <agent>] [--local]
uip skills list      [--local] [--repo <url>] [--branch <name>]
uip skills search    <query> [--local] [--limit <n>] [--repo <url>] [--branch <name>]
uip skills show      <name> [--local] [--repo <url>] [--branch <name>]
uip skills install   [--agent <agent>] [--skip-if-no-agent] [--local] [--path <dir>] [--repo <url>] [--branch <name>] [--force]
uip skills update    [--agent <agent>] [--local]
uip skills uninstall [--agent <agent>] [--local]

All uip skills subcommands honor the global options (--output, --output-filter, --log-level, --log-file). Exit codes follow the standard contract.

Supported agents: claude, cursor, copilot, codex, opencode, autopilot, kiro, windsurf, antigravity, devin. Some agents have only a global install path; others support both local (per-project) and global. Run uip skills install --help for the per-agent destination table generated from the live registry.

uip skills list

List the skills available from the configured catalog (the UiPath skills repository by default, or another one via --repo). Read-only — does not install anything or touch an agent's configuration.

Arguments

None.

Options

--local — Read the current project's local skills store instead of the global one.
--repo <url> — List skills from another repo instead: a GitHub owner/repo, an https/git URL, or a local directory such as ./skills. Defaults to the UiPath skills repository.
--branch <name> — Branch to fetch from --repo.

Example

uip skills list
uip skills list

Data shape (`--output json`)

{
  "Code": "SkillsList",
  "Data": {
    "RootDir": "~",
    "StorePath": "~/.uipath/.skills",
    "Count": 2,
    "Skills": [
      {
        "Name": "uipath-agents",
        "Description": "Build and deploy UiPath agents",
        "SkillPath": "uipath-agents/SKILL.md",
        "SkillFile": "~/.uipath/.skills/skills/uipath-agents/SKILL.md"
      },
      {
        "Name": "uipath-rpa",
        "Description": "Build UiPath automations",
        "SkillPath": "uipath-rpa/SKILL.md",
        "SkillFile": "~/.uipath/.skills/skills/uipath-rpa/SKILL.md"
      }
    ],
    "Shadowed": []
  }
}
{
  "Code": "SkillsList",
  "Data": {
    "RootDir": "~",
    "StorePath": "~/.uipath/.skills",
    "Count": 2,
    "Skills": [
      {
        "Name": "uipath-agents",
        "Description": "Build and deploy UiPath agents",
        "SkillPath": "uipath-agents/SKILL.md",
        "SkillFile": "~/.uipath/.skills/skills/uipath-agents/SKILL.md"
      },
      {
        "Name": "uipath-rpa",
        "Description": "Build UiPath automations",
        "SkillPath": "uipath-rpa/SKILL.md",
        "SkillFile": "~/.uipath/.skills/skills/uipath-rpa/SKILL.md"
      }
    ],
    "Shadowed": []
  }
}

Shadowed lists skills that were dropped during discovery because another skill in the same source used the same name — visible here instead of silently disappearing.

uip skills search

Search the skill catalog by goal or keyword and return the closest matches. Read-only.

Arguments

Name	Required	Purpose
`<query>`	yes	Free-text search query.

Options

--local — See list.
--limit <n> — Maximum number of results. Defaults to 10.
--repo <url> — See list.
--branch <name> — See list.

Example

uip skills search "create a queue and deploy a process"
uip skills search "create a queue and deploy a process"

Data shape (`--output json`)

{
  "Code": "SkillsSearch",
  "Data": {
    "RootDir": "~",
    "StorePath": "~/.uipath/.skills",
    "Query": "create a queue and deploy a process",
    "Count": 1,
    "Skills": [
      {
        "Name": "uipath-platform",
        "Description": "UiPath platform and Orchestrator ops",
        "SkillPath": "uipath-platform/SKILL.md",
        "SkillFile": "~/.uipath/.skills/skills/uipath-platform/SKILL.md"
      }
    ],
    "Shadowed": []
  }
}
{
  "Code": "SkillsSearch",
  "Data": {
    "RootDir": "~",
    "StorePath": "~/.uipath/.skills",
    "Query": "create a queue and deploy a process",
    "Count": 1,
    "Skills": [
      {
        "Name": "uipath-platform",
        "Description": "UiPath platform and Orchestrator ops",
        "SkillPath": "uipath-platform/SKILL.md",
        "SkillFile": "~/.uipath/.skills/skills/uipath-platform/SKILL.md"
      }
    ],
    "Shadowed": []
  }
}

uip skills show

Show one skill's catalog entry in full. Read-only.

Arguments

Name	Required	Purpose
`<name>`	yes	Skill name, from `list` or `search`. Matched case-insensitively.

Options

--local — See list.
--repo <url> — See list.
--branch <name> — See list.

An unknown name fails with ValidationError, pointing at list/search to find a valid one.

Example

uip skills show uipath-rpa
uip skills show uipath-rpa

Data shape (`--output json`)

{
  "Code": "SkillsShow",
  "Data": {
    "RootDir": "~",
    "StorePath": "~/.uipath/.skills",
    "Skill": {
      "Name": "uipath-rpa",
      "Description": "Build UiPath automations",
      "SkillPath": "uipath-rpa/SKILL.md",
      "SkillFile": "~/.uipath/.skills/skills/uipath-rpa/SKILL.md"
    }
  }
}
{
  "Code": "SkillsShow",
  "Data": {
    "RootDir": "~",
    "StorePath": "~/.uipath/.skills",
    "Skill": {
      "Name": "uipath-rpa",
      "Description": "Build UiPath automations",
      "SkillPath": "uipath-rpa/SKILL.md",
      "SkillFile": "~/.uipath/.skills/skills/uipath-rpa/SKILL.md"
    }
  }
}

uip skills install

Download skills from UiPath and install them into the selected agent's configuration. Writes to the user's home directory by default; pass --local to install under the current project instead. Pass --repo to install from another GitHub/git repository or a local directory instead of the UiPath skills repository.

Arguments

None.

Options

--agent <agent> — Target a single agent (claude, cursor, copilot, codex, opencode, autopilot, kiro, windsurf, antigravity, devin). Without it, the CLI prompts interactively with a checkbox picker. Agents not supported for the current scope are hidden from the picker.
--skip-if-no-agent — Exit successfully (no error, Installed: 0) instead of prompting or failing when no supported agent is detected on the machine.
--local — Install to the current project directory instead of the user home. Rejected for agents that only support a global path.
--path <dir> — Install into a specific project directory. Implies --local.
--repo <url> — Install from another skills repo: a GitHub owner/repo, an https/git URL, or a local directory such as ./skills. Defaults to the UiPath skills repository.
--branch <name> — Branch to fetch from --repo. Defaults to that repo's default branch.
--force — Reinstall from a clean state — resets the Claude Code marketplace registration and plugin cache before reinstalling.

Examples

# Install for Claude Code (global)
uip skills install --agent claude

# Install for Cursor, scoped to the current project
uip skills install --agent cursor --local

# Install from another repo for Cursor
uip skills install --repo my-org/my-skills --agent cursor

# Install into a specific project directory (implies --local)
uip skills install --agent autopilot --path ./my-project --repo mattpocock/skills

# Interactive picker
uip skills install
# Install for Claude Code (global)
uip skills install --agent claude

# Install for Cursor, scoped to the current project
uip skills install --agent cursor --local

# Install from another repo for Cursor
uip skills install --repo my-org/my-skills --agent cursor

# Install into a specific project directory (implies --local)
uip skills install --agent autopilot --path ./my-project --repo mattpocock/skills

# Interactive picker
uip skills install

Data shape (`--output json`)

{
  "Code": "SkillsInstall",
  "Data": {
    "RootDir": "/Users/alice",
    "Skills": ["uipath-agents", "uipath-rpa"],
    "Agents": ["claude"],
    "Installed": 2
  }
}
{
  "Code": "SkillsInstall",
  "Data": {
    "RootDir": "/Users/alice",
    "Skills": ["uipath-agents", "uipath-rpa"],
    "Agents": ["claude"],
    "Installed": 2
  }
}

RootDir — base directory the skills were written under (user home for global, project directory for --local/--path).
Skills — slugs of the skills fetched from the configured source.
Agents — agents targeted in this run.
Installed — number of (agent, skill) pairs successfully installed.
Shadowed (when non-empty) — same-named skills dropped during discovery, as {Name, IgnoredPath}.
Conflicts (when non-empty) — skills skipped per agent because another source already installed a skill of that name there, as {Agent, Name, OwnedBy}.

When --skip-if-no-agent triggers, the response instead reports Skipped: true with a Reason and Message, and Skills/Agents empty.

Note:

--agent autopilot installs more than skills. Autopilot mirrors Claude Code's on-disk layout, so its install also copies the catalog's hooks/ folder as a sibling of skills/ (e.g. ~/.autopilot/hooks/). Every other supported agent installs skills/ only. This isn't reflected in the Skills/Installed fields above — those count skills, not the extra folder.

Prerequisites

Network access plus git. On Windows, skill unpacking uses PowerShell; on macOS/Linux, it uses unzip. If these are missing, the command fails with a Failure result pointing at the offending prerequisite.

uip skills update

Re-fetch skills from UiPath and re-install them. After installing the fresh set, the CLI prunes any skills that are no longer in the registry — so update also cleans up deprecated skills on disk.

Arguments

None.

Options

--agent <agent> — See install.
--local — See install.

Example

uip skills update --agent claude
uip skills update --agent claude

Data shape (`--output json`)

{
  "Code": "SkillsUpdate",
  "Data": {
    "RootDir": "/Users/alice",
    "Skills": ["uipath-agents", "uipath-rpa"],
    "Agents": ["claude"],
    "Updated": 2
  }
}
{
  "Code": "SkillsUpdate",
  "Data": {
    "RootDir": "/Users/alice",
    "Skills": ["uipath-agents", "uipath-rpa"],
    "Agents": ["claude"],
    "Updated": 2
  }
}

Updated is the number of (agent, skill) pairs re-installed; stale entries are removed separately and silently.

uip skills uninstall

Remove previously installed skills from an agent's configuration and update the local manifest. uninstall does not perform any network calls — it relies on the manifest written by install / update to know which skills exist.

Arguments

None.

Options

--agent <agent> — See install. Without it, the CLI prompts interactively. Passing an unknown agent fails with ValidationError.
--local — Remove from the current project instead of the user home.

Example

uip skills uninstall --agent claude
uip skills uninstall --agent claude

Data shape (`--output json`)

{
  "Code": "SkillsUninstall",
  "Data": {
    "RootDir": "/Users/alice",
    "Skills": ["uipath-agents", "uipath-rpa"],
    "Agents": ["claude"],
    "Uninstalled": 2
  }
}
{
  "Code": "SkillsUninstall",
  "Data": {
    "RootDir": "/Users/alice",
    "Skills": ["uipath-agents", "uipath-rpa"],
    "Agents": ["claude"],
    "Uninstalled": 2
  }
}

Failure modes

No manifest found (nothing ever installed, or it was deleted manually): ConfigError with instructions to run uip skills install.
Write permissions on the agent's configuration directory: Failure with a file-permissions hint. The CLI exits with code 1.
User cancels the interactive agent picker: the CLI exits with code 130 (SIGINT), per the standard contract.

Skills — what skills are, agent support matrix, and how they differ from tools.
Authentication — not required for skills; the registry is public.
uip mcp — a secondary path for MCP-aware agents that do not support skills.

Was this page helpful?

PREVIOUSuip tools

NEXTuip mcp

Synopsis​

uip skills list​

Arguments​

Options​

Example​

Data shape (--output json)​

uip skills search​

Arguments​

Options​

Example​

Data shape (--output json)​

uip skills show​

Arguments​

Options​

Example​

Data shape (--output json)​

uip skills install​

Arguments​

Options​

Examples​

Data shape (--output json)​

Prerequisites​

uip skills update​

Arguments​

Options​

Example​

Data shape (--output json)​

uip skills uninstall​

Arguments​

Options​

Example​

Data shape (--output json)​

Failure modes​

Related​

Was this page helpful?

Synopsis

uip skills list

Arguments

Options

Example

Data shape (`--output json`)

uip skills search

Arguments

Options

Example

Data shape (`--output json`)

uip skills show

Arguments

Options

Example

Data shape (`--output json`)

uip skills install

Arguments

Options

Examples

Data shape (`--output json`)

Prerequisites

uip skills update

Arguments

Options

Example

Data shape (`--output json`)

uip skills uninstall

Arguments

Options

Example

Data shape (`--output json`)

Failure modes

Related