Habilidades

Conceito de habilidades no UiPath CLI, explicando como as habilidades diferem das ferramentas e como os agentes de codificação as instalam e usam.

Habilidades são pacotes de instruções que ensinam agentes de codificação de IA a criar automações UiPath com uip. Elas não são ferramentas. As ferramentas estendem a CLI com novos comandos; as habilidades estendem um agente de codificação com conhecimento específico da UiPath. Um desenvolvedor digita uip or jobs start; um agente de codificação que tem uma habilidade instalada sabe quando alcançar esse comando, quais entradas ele precisa e como sequenciá-lo com uip solution pack, uip or packages upload e o resto.

O que é uma habilidade

Uma habilidade é um pacote de arquivos Markdown — instruções, exemplos, regras de decisão — que um agente lê junto com sua conversa para decidir como realizar uma tarefa da UiPath. O pacote abrange padrões como "como empacotar e implantar um projeto do Studio", "como executar um conjunto de testes no CI" ou "como configurar um gatilho do Orchestrator a partir da linha de comando". O agente usa a habilidade da mesma forma que um desenvolvedor usaria a documentação, exceto que a habilidade tem o escopo restrito às tarefas que o autor da habilidade considera relevantes.

A UiPath publica um catálogo de habilidades no GitHub. uip skills install baixa todo o catálogo e o instala nos agentes que você escolher.

Agentes compatíveis

Os seguintes agentes de codificação são suportados hoje:

Agente	Valor da sinalização	Local de instalação
Claude Code (Plugin)	claude	Gerenciado pelo sistema de plug-in Claude Code — apenas global
Cursor	cursor	~/.cursor/skills/<skill>/ (global) ou ./.cursor/skills/<skill>/ (local)
Copilot do GitHub	copilot	~/.copilot/skills/<skill>/ (global) ou ./.github/skills/<skill>/ (local)
Código	codex	~/.agents/skills/<skill>/ (global) ou ./.agents/skills/<skill>/ (local) — o diretório padrão aberto de Habilidades do agente
Abrir código	opencode	~/.config/opencode/skills/<skill>/ (global) ou ./.opencode/skills/<skill>/ (local)
UiPath Autopilot	autopilot	~/.autopilot/skills/<skill>/ (global) ou ./.autopilot/skills/<skill>/ (local)
Especifica (Amazon Q)	kiro	~/.kiro/skills/<skill>/ (global) ou ./.kiro/skills/<skill>/ (local)
Navegar	windsurf	~/.windsurf/skills/<skill>/ (global) ou ./.windsurf/skills/<skill>/ (local)
CLI de antivírus	antigravity	~/.gemini/antigravity-cli/skills/<skill>/ (global) ou ./.agents/skills/<skill>/ (local)
Diabo	devin	~/.agents/skills/<skill>/ (global) ou ./.agents/skills/<skill>/ (local) — o diretório padrão aberto de Habilidades do agente

Os destinos exatos são impressos por uip skills install --agent <name> antes que qualquer arquivo seja escrito. Execute uip skills --help para ver a tabela ativa para sua instalação.

Observação:

O UiPath Autopilot instala mais do que habilidades. O Autopilot espelha o layout no disco do Claude Code, portanto, a instalação para ele também copia a pasta hooks/ do catálogo como irmã de skills/ — todos os outros agentes acima instalam apenas skills/.

Granularidade: agentes, não habilidades

é uip skills install ou nada no catálogo de habilidades. Você escolhe um ou mais agentes e a CLI instala todas as habilidades que a UiPath publica atualmente em cada um desses agentes. Você não escolhe habilidades individuais.

Motivo: o conjunto de habilidades é pequeno o suficiente para que a escolha seletiva produza mais inconsistência do que benefício, e o próprio agente decide qual habilidade se aplica a uma determinada tarefa com base em seu próprio raciocínio — o catálogo de habilidades é efetivamente uma referência que o agente consulta quando uma tarefa está relacionado à UiPath. Fornecer ao agente habilidades extras que ele não usará tem baixa sobrecarga.

O que você escolhe :

• Quais agentes ( --agent <name>, ou interativamente a partir de uma caixa de seleção quando o sinalizador é omitido — seleção múltipla).
• Escopo global ou local (por meio --local, onde o agente for compatível).

Instalações globais versus locais

Dois escopos:

• Global (padrão) — as habilidades são instaladas uma vez por usuário, no perfil do agente do usuário. Disponível em todos os projetos nessa máquina.
• Local (--local) — as habilidades são instaladas no diretório atual. Rastreado ao lado do projeto; disponível apenas quando o agente está em execução nesse diretório.

Use local para um projeto que fixe habilidades a uma versão específica da UiPath CLI ou para um repositório em que um conjunto específico de habilidades deve ser fornecido a todos os colaboradores, independentemente do que eles tiverem instalado globalmente.

Observação:

Nem todo agente é compatível com --local. o Claude Code é somente global (o sistema de plug-in do Claude Code tem o escopo de usuário); a execução de uip skills install --agent claude --local produz um ValidationError. Todos os outros agentes compatíveis aceitam ambos os escopos.

Quando você executa uip skills install --local, a CLI também adiciona o armazenamento em disco (.uipath/.skills/, sob a raiz passo a passo) a .gitignore para que os pacotes de habilidades em cache não sejam confirmados.

Instalação, atualização, desinstalação

Três comandos gerenciam o ciclo de vida:

uip skills install --agent claude                 # install globally for Claude Code
uip skills install --agent cursor --local         # install into this project for Cursor
uip skills install                                # interactive: pick agents from a checkbox
uip skills update --agent claude                  # re-fetch and reinstall
uip skills uninstall --agent claude               # remove skills for Claude Code only

Todos os três solicitam o agente de destino interativamente quando é --agent , o que é conveniente em uma estação de trabalho e um problema no CI — sempre passe o sinalizador em pipelines.

update também remove habilidades que foram descartadas do catálogo remoto desde sua última instalação, portanto, um agente instalado rastreia o catálogo à medida que ele evolui. Os arquivos de habilidade por agente são escritos ou substituídos na instalação e atualização.

Como o agente usa as habilidades

Após instalado, cada agente lê arquivos de habilidades por meio de seu próprio mecanismo:

• O Claude Code carrega habilidades por meio do sistema de plug-ins — eles se tornam plug-ins para uso de ferramentas que o agente pode invocar.
• Habilidade de carregamento Cursor, Codex e OpenCode Markdown como regras de contexto anexadas a cada conversa.
• O GitHub Copilot lê habilidades do seu diretório de regras do usuário.

Os agentes compatíveis restantes (UiPath Autopilot, Kiro, Air UiPath, Winsurf, Antigravity CLI, Devin) leem os arquivos de habilidades instaladas por meio de seu próprio mecanismo — consulte a documentação do próprio agente para saber como ele revela as habilidades instaladas.

Da perspectiva do desenvolvedor, a diferença é invisível. Você pede ao agente "empacotar e implantar este projeto" e, se uma habilidade abranger isso, o agente segue a receita — chamando uip solution pack, uip solution publish, uip solution deploy run em ordem, lidando com a seleção de sinalizador e relatando.

O que as habilidades não são

• As habilidades não substituem a documentação. Eles depuram fórmulas orientadas para tarefas; a referência completa está nos documentos uip (este site). Um agente com habilidades ainda se beneficia da leitura de páginas de referência por comando.
• As habilidades não dão ao agente acesso ao seu tenant da UiPath. eles instruem o agente como usar uip; a autenticação real acontece por meio de uip login em sua máquina da mesma forma que quando você executa comandos por conta própria.
• Habilidades não são ferramentas. uip tools são grupos uip skills comando distintos. Comandos de envio de ferramentas; habilidades ensinam aos agentes como usá-las.
• As habilidades não são servidores de Protocolo de Contexto do Modelo (MCP). uip mcp expõe uma superfície MCP separada para clientes com reconhecimento de MCP. O sistema de habilidades é o principal caminho de integração de IA na versão 1.x; O MCP está disponível para configurações especializadas, mas não é a integração principal.

O que ler a seguir

• Uso do UiPath CLI com agentes de codificação — orientações para configurar cada agente, verificar a instalação e executar uma tarefa de ponta a ponta.
• referência de habilidades uip — sinalizadores, códigos de saída e exemplos completos.
• Gerenciamento de ferramentas e habilidades — ciclo de vida diário, fixar, auditar o que está instalado.
• Ferramentas ( plugins ) — o outro mecanismo de extensão; explica a distinção entre "ferramentas" e "Habilidades".