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.

Agentes compatíveis: claude, cursor, copilot, codex, opencode, autopilot, kiro, windsurf, antigravity, devin. Alguns agentes têm apenas um caminho de instalação global; outros oferecem suporte tanto local (por projeto) quanto global. Execute uip skills install --help para a tabela de destino por agente gerada a partir do registro atual.

lista de habilidades do uip

Liste as habilidades disponíveis do catálogo configurado (o repositório de habilidades da UiPath por padrão, ou outro por meio de --repo). SomenteLeitura — não instala nada nem afeta a configuração de um agente.

Argumentos

Nenhum.

Opções

• --local — Leia o armazenamento de habilidades locais do projeto atual em vez do global.
• --repo <url> — Em vez disso, liste habilidades de outro repositório: um GitHub,owner/repo um httpsgit URL / ou um diretório local,./skills como. O padrão é o repositório de habilidades da UiPath.
• --branch <name> — Ramificação para buscar de --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 lista habilidades que foram descartadas durante a descoberta porque outra habilidade na mesma origem usou o mesmo nome — visível aqui em vez de desaparecer silenciosamente.

pesquisa de habilidades da UI

Pesquise o catálogo de habilidades por objetivo ou palavra-chave e retorne as correspondências mais próximas. Somente leitura.

Argumentos

Name	Required	Finalidade
<query>	sim	Consulta de pesquisa de texto livre.

Opções

• --local — Consulte list.
• --limit <n> — Número máximo de resultados. O padrão é 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": []
  }
}

exibição de habilidades do uip

Exibe a entrada do catálogo de uma habilidade por completo. Somente leitura.

Argumentos

Name	Required	Finalidade
<name>	sim	Nome da habilidade, de list ou search. Correspondência sem diferenciação entre maiúsculas e minúsculas.

Opções

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

Um nome desconhecido falha com ValidationError, apontando para list/search para encontrar um válido.

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

Baixe habilidades da UiPath e instale-as na configuração do agente selecionado. Grava no diretório inicial do usuário por padrão; passe --local para instalar no projeto atual. Passe --repo para instalar a partir de outro repositório GitHub/git ou de um diretório local, em vez do repositório de habilidades da UiPath.

Argumentos

Nenhum.

Opções

• --agent <agent> — Segmente um único agenteclaude (,,,,,,,,,). cursorcopilotcodexopencodeautopilotkirowindsurfantigravitydevin Sem ele, a CLI solicita interativamente com um seletor de caixa de seleção. Os agentes que não são compatíveis com o escopo atual são ocultos do seletor.
• --skip-if-no-agent — Sai com sucesso (semInstalled: 0 erro,) em vez de solicitar ou falhar quando nenhum agente compatível é detectado na máquina.
• --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> — Instalar em um diretório de projeto específico. Implica --local.
• --repo <url> — Instalar a partir de outro repositório de habilidades: um GitHub,owner/repo uma httpsgit URL / ou um diretório local,./skills como. O padrão é o repositório de habilidades da UiPath.
• --branch <name> — Ramificação para buscar de --repo. O padrão é a ramificação padrão desse repositório.
• --force — Reinstalar a partir de um estado limpo — redefine o registro do Claude Code Marketplace e o cache de plug-in antes da reinstalação.

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 — diretório base no qual as habilidades foram escritas (página inicial do usuário para global, diretório do projeto para --local/).--path
• Skills — campos de dados dinâmicos das habilidades buscadas na origem configurada.
• Agents — agentes direcionados nesta execução.
• Installed — número de pares (agente, habilidade) instalados com sucesso.
• Shadowed (quando não está vazio) — habilidades com o mesmo nome foram descartadas durante a descoberta, como {Name, IgnoredPath}.
• Conflicts (quando não vazio) — habilidades ignoradas por agente porque outra origem já instalou uma habilidade desse nome lá, como {Agent, Name, OwnedBy}.

Quando --skip-if-no-agent é disparado, a resposta relata Skipped: true com um Reason e Message, e Skills/Agents vazio.

Observação:

--agent autopilot instala mais que habilidades. O Autopilot espelha o layout no disco do Claude Code, então sua instalação também copia a pasta hooks/ do catálogo como irmã de skills/ (por exemplo ~/.autopilot/hooks/). Todos os outros agentes compatíveis instalam apenas skills/. Isso não é refletido nos campos Skills/Installed acima — aqueles habilidades de contagem, não a pasta extra.

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.