Habilidades da UIP

Sintaxe e opções para "habilidades uip", que instala, atualiza e remove pacotes de habilidades de agente de codificação da UiPath.

uip skills instala, atualiza e remove habilidades da UiPath para agentes de codificação de IA compatíveis. As habilidades são pacotes de prompts selecionados que ensinam um agente a usar as ferramentas de CLI da UiPath para criar automações, agentes, fluxos e orquestrações. Consulte Habilidades para obter o conceito, o modelo de instalação e os locais de instalação de agente por agente.

Esta página documenta os comandos. Para saber o que são habilidades e por que instalá-las, leia primeiro a página do conceito.

Resumo

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]

Todos os subcomandos uip skills respeitam as opções globais (--output, --output-filter, --log-level, --log-file). Os códigos de saída seguem o contrato padrão.

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.

Argumentos

Nenhum.

Opções

• --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.

Exemplo

uip skills list

Formato dos dados (--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": []
  }
}

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.

Argumentos

Name	Required	Finalidade
<query>	sim	Free-text search query.

Opções

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

Exemplo

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

Formato dos dados (--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": []
  }
}

uip skills show

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

Argumentos

Name	Required	Finalidade
<name>	sim	Skill name, from list or search. Matched case-insensitively.

Opções

• --local — Consulte list.
• --repo <url> — Consulte list.
• --branch <name> — Consulte list.

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

Exemplo

uip skills show uipath-rpa

Formato dos dados (--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"
    }
  }
}

Instalação de habilidades de uip

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.

Argumentos

Nenhum.

Opções

• --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 Instalar no diretório do projeto atual em vez da página inicial do usuário. Rejeitado para agentes que são compatíveis apenas com um caminho global.
• --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.

Exemplos

# 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

Formato dos dados (--output json)

{
  "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 — agentes direcionados nesta execução.
• Installed — número de pares (agente, habilidade) instalados com sucesso.
• 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.

Observação:

--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.

Pré-requisitos

Acesso à rede mais git. No Windows, a descompactação de habilidades usa o PowerShell; no macOS/Linux, ele usa unzip. Se eles estiverem ausentes, o comando falhará com um resultado Failure apontando para o pré-requisito ofensiva.

atualização de habilidades de uip

Busque novamente as habilidades do UiPath e reinstale-as. Depois de instalar o conjunto novo, a CLI poda quaisquer habilidades que não estão mais no registro — de modo que update também limpa habilidades obsoletas no disco.

Argumentos

Nenhum.

Opções

• --agent <agent> — Consulte install.
• --local — Consulte install.

Exemplo

uip skills update --agent claude

Formato dos dados (--output json)

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

Updated é o número de pares (agente, habilidade) reinstalados; as entradas obsoletas são removidas separadamente e silenciosamente.

desinstalação de habilidades de uip

Remova as habilidades instaladas anteriormente da configuração de um agente e atualize o manifesto local. uninstall realiza nenhuma chamada de rede — depende do manifesto escrito por install / update para saber quais habilidades existem.

Argumentos

Nenhum.

Opções

• --agent <agent> — Consulte install. Sem ele, a CLI solicita interativamente. A passagem de um agente desconhecido falha com ValidationError.
• --local Remover do projeto atual em vez da página inicial do usuário.

Exemplo

uip skills uninstall --agent claude

Formato dos dados (--output json)

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

Modos de falha

• Nenhum manifesto encontrado ( nada já instalado ou foi excluído manualmente): ConfigError com instruções para executar uip skills install.
• Permissões de gravação no diretório de configuração do agente: Failure com uma dica de permissões de arquivos. A CLI sai com o código 1.
• O usuário cancela o seletor de agente interativo: a CLI sai com o código 130 ( SIGINT), de acordo com o contrato padrão.

Relacionado

• Habilidades — o que são habilidades, matriz de suporte do agente e como elas diferem das ferramentas.
• Autenticação — não necessária para skills; o registro é público.
• uip mcp — um caminho secundário para agentes sensíveis a MCP que não são compatíveis com habilidades.