Conversando com colegas devs em WordCamps e outros eventos de tecnologia, virou padrão: todo mundo testa IA no fluxo do WordPress, mas reclama que o código gerado raramente segue as convenções da comunidade. Sanitização incorreta, hooks no lugar errado, padrões de PHP antigos. Aí entra uma nova funcionalidade no WordPress Studio: as Agent Skills.

Neste guia, vou explicar o que são essas habilidades, como ativá-las e por que elas mudam a forma como Claude Code, Cursor e Studio Code trabalham com seu projeto WordPress.

O que são Agent Skills?

Agent Skills são arquivos de instrução especializados (SKILL.md) que possuem conhecimento técnico sobre o ecossistema WordPress. Em vez de você reexplicar a um agente de IA, a cada sessão, como registrar um bloco Gutenberg ou sanitizar entradas, a Skill injeta esse contexto automaticamente.

Cada habilidade abrange uma área específica do WordPress. Portanto, o agente lê o arquivo, incorpora as regras e passa a respeitar os padrões oficiais sem prompt repetitivo da sua parte.

Por que isso importa para o desenvolvedor?

Sem habilidades ativas, a IA tende a:

• Gerar plugins sem wp_nonce_field() ou checagem de capabilities.
• Misturar código de temas clássicos com o de blocos.
• Sugerir APIs depreciadas, como query_posts no lugar de WP_Query.
• Ignorar padrões de FSE (Full Site Editing) e do theme.json.

Com as Agent Skills ligadas, o agente respeita as diretrizes oficiais por padrão. Como resultado, você acelera as entregas sem abrir mão da qualidade ou da segurança.

Habilidades disponíveis no Studio

O WordPress Studio já vem pré-configurado com um conjunto essencial de skills que cobre os principais cenários de desenvolvimento:

Habilidade	Foco e Capacidades
Studio CLI	Comandos do Studio, gerenciamento de sites e fluxos de terminal.
Plugin Development	Hooks, filters, actions e padrões de segurança em plugins.
Block Development	Criação de blocos Gutenberg com @wordpress/scripts e block patterns.
Block Themes	FSE, theme.json e templates de Edição Completa do Site.
REST API	Endpoints customizados, autenticação e integração de dados.
WP-CLI & Ops	Automação, scripts de manutenção e comandos de servidor.

Cada uma dessas skills é mantida pela equipe da Automattic. Ou seja, você está sempre alinhado às APIs mais recentes do core.

Como ativar Agent Skills no Studio

Existem dois caminhos no Studio: ativação global ou por projeto.

Configuração por projeto

Quando o site exige um conjunto específico, como apenas Plugin development:

1. Selecione o site no Studio.
2. Clique em “Edit site” ou no ícone de engrenagem.
3. Na aba Skills, gerencie as habilidades desse ambiente.

Essa granularidade é importante. Afinal, ativar tudo o tempo todo polui o contexto e atrapalha o agente. As skills instaladas serão listadas na categoria “instaladas”.

Como funciona por baixo dos panos

Ao ativar uma habilidade, o Studio cria a pasta .agents/skills/ dentro do diretório do site WordPress. Os agentes de IA leem os arquivos SKILL.md correspondentes e, em seguida, incorporam as regras ao contexto da sessão.

Integração nativa com Claude Code

Para quem usa o Claude Code, o Studio simplifica o setup ainda mais:

• Cria links simbólicos automaticamente em .claude/skills/.
• O Claude reconhece as habilidades sem configuração manual via terminal.
• O fluxo é o mesmo no Cursor, que também lê skills do diretório do projeto.

Um link simbólico funciona como um atalho que aponta para outro caminho no sistema de arquivos, permitindo que você mantenha uma única fonte de verdade (.agent/skills) e exponha-a em outro local esperado pela ferramenta (.claude/skills) sem duplicar arquivos.

O processo é simples: garanta que o diretório de origem existe, remova qualquer pasta pré-existente no destino do link (já que ln -s falha se o caminho já estiver ocupado) e execute:

 ln -s /caminho/absoluto/para/.agent/skills .claude/skills

Sempre usando caminho absoluto para que o link permaneça válido de qualquer diretório.

Depois disso, qualquer alteração feita em uma das pastas reflete imediatamente na outra, e você pode confirmar o resultado com ls -la .claude/skills, que mostrará uma seta (->) indicando o destino real.

Por causa disso, a experiência é “ativada e funciona”. Você não precisa editar claude.json, ajustar o prompt do sistema ou copiar os arquivos manualmente.

Dicas de especialista

Algumas considerações que aprendi usando Agent Skills no dia a dia:

• Combine com critério: ativar todas as habilidades de uma vez polui o contexto. Selecione apenas o que fizer sentido para o projeto.
• Customize para seu time: você pode criar arquivos SKILL.md próprios com padrões internos da sua agência ou squad.
• Revise sempre o output: a habilidade orienta, mas não substitui a revisão humana. Senso crítico continua valendo.

Conclusão

Agent Skills representam uma evolução importante para quem usa IA no fluxo do WordPress. Em vez de orquestrar prompts genéricos a cada sessão, você delega ao agente conhecimento curado pela própria comunidade.

Portanto, se você já usa Claude Code, Cursor ou Studio Code para desenvolver com WordPress, ativar as Agent Skills é o próximo passo natural. O resultado é claro: menos tempo corrigindo a IA, mais tempo construindo features.