Habilidades do Agente

Este texto foi traduzido usando IA. Se você quiser ver o texto original em inglês, clique aqui.

Agent Skills são um conjunto curado de “habilidades” reutilizáveis (pacotes de prompts/ferramentas) que você pode adicionar à caixa de ferramentas de um agente de codificação com IA para ajudá-lo a trabalhar de forma mais eficaz em tarefas de desenvolvimento relacionadas ao WordPress.

Elas padronizam como um agente de IA é instruído a executar fluxos de trabalho comuns do WordPress, para que você não precise re-explicar o contexto toda vez (por exemplo, como abordar design de UI, análise estática, cache e otimização de banco de dados, etc.).

Elas têm como objetivo tornar os agentes:

• Mais seguros, porque incorporam boas práticas e proteções
• Mais consistentes, considerando fluxos de trabalho repetíveis
• Mais rápidos de integrar, já que os agentes recebem contexto imediato

Como são instaladas

As Agent Skills são incorporadas ao ambiente do seu agente de duas formas:

1. Instalação local no projeto: As habilidades ficam dentro do diretório do seu projeto, para que todos no projeto possam usar os mesmos comportamentos.
2. Instalação global: As habilidades ficam no diretório de configuração do agente de codificação do usuário, sendo aplicadas em todos os projetos.

Em ambos os casos, o agente de codificação lê as habilidades do disco e as incorpora às suas instruções de operação.

Como as habilidades são arquivos de conteúdo, o modelo de atualização mais seguro é:

• Trate as skills como ativos versionados
• Busque atualizações periodicamente
• Revise as diferenças antes de aplicá-las amplamente (especialmente para configurações compartilhadas/de equipe)

Quais WordPress Agent Skills estão disponíveis?

A lista de Agent Skills disponíveis pode mudar, então visite o repositório público para obter as informações mais atualizadas.

Existem skills para muitos fundamentos do WordPress, incluindo:

• Desenvolvimento de blocos
• Desenvolvimento de plugins
• REST API
• WordPress Playground
• Performance
• Interactivity API
• Design

Opções de instalação

Existem algumas formas de integrar o agent-skills, dependendo do seu ambiente e de como você prefere gerenciar dependências.

Opção 1: skills.sh

Se você quer uma instalação rápida sem clonar e compilar o repositório manualmente, use o skills.sh, um auxiliar de instalação que facilita a adição de arquivos de agent skills no seu ambiente local.

Pré-requisito: Node.js (para que você possa executar comandos npx)

1. Escolha as skills que você deseja instalar. Você também pode executar npx skills add https://github.com/WordPress/agent-skills --list para visualizar os nomes de todas as skills disponíveis.
2. Instale as skills. Por exemplo, o comando a seguir instalaria wordpress-router, wp-project-triage, wp-block-development, wp-block-themes e wp-plugin-development para o Claude Code:

npx skills add https://github.com/WordPress/agent-skills 
  --agent claude-code 
  --skill wordpress-router 
  --skill wp-project-triage 
  --skill wp-block-development 
  --skill wp-block-themes 
  --skill wp-plugin-development

Para usar um agente diferente, substitua --agent claude-code pelo seu agente (por exemplo, --agent cursor). Você também pode instalar para múltiplos agentes passando vários argumentos --agent.

Durante a instalação, será perguntado se você deseja instalar as skills globalmente ou por projeto. Instale as skills globalmente por padrão usando o argumento --global.

Para remover uma skill, execute npx skills remove wp-block-themes, substituindo wp-block-themes pela skill que você deseja remover.

Para verificar atualizações, execute npx skills check e depois npx skills update para atualizar.

Ao remover skills ou executar atualizações, use o mesmo escopo utilizado na instalação. Instalações globais (--global) afetam as skills de toda a máquina, enquanto instalações por projeto afetam as skills armazenadas junto ao código do projeto.

Opção 2:

Se você precisa de controle total, ou está contribuindo para as próprias skills, clone o repositório de skills e siga os passos manuais de build/instalação.

Escolhendo habilidades: “todas” vs habilidades “relevantes”

Você pode não precisar de todas as Agent Skills disponíveis para o seu projeto. Em vez disso, você pode adicionar habilidades com base no que está desenvolvendo. Por exemplo:

• Desenvolvimento de blocos / Gutenberg: wp-block-development e wp-interactivity-api
• Temas de blocos/edição de site: wp-block-themes e wpds
• Desenvolvimento de plugins: wp-plugin-development e wp-abilities-api

Instale todas as habilidades quando você estiver:

• Fazendo refatorações amplas em múltiplas áreas (blocos + temas + plugins), ou
• Construindo ferramentas de plataforma onde você deseja cobertura máxima.