Habilidades

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 (guia)	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	~/.github/skills/<skill>/ (global) ou ./.github/skills/<skill>/ (local)
CLI do Gemini	gemini	~/.gemini/skills/<skill>/ (global) ou ./.gemini/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)

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.

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 todos os agentes são compatíveis 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. Os outros cinco agentes são compatíveis com 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.
• Cursor, Gemini CLI, Codex e OpenCode carregam a habilidade Markdown como regras de contexto anexadas a cada conversa.
• O GitHub Copilot lê habilidades do seu diretório de regras do usuário.

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