claude-plugins/wordpress/skills/wp-update/SKILL.md

name, description, author, version, quality_score, user_invocable, desk_task

name	description	author	version	quality_score	user_invocable	desk_task
wp-update	WordPress core, plugins, and themes update management. Safely updates WordPress components with backups. Use when user mentions "wordpress update", "wp update", "update plugins", "update themes", "wordpress maintenance".	Descomplicar® Crescimento Digital	1.1.0	75	true	1553

/wp-update - Actualização WordPress

Actualização e verificação de todos os sites WordPress no servidor CWP (176.9.3.158).

---

SITES ACTIVOS (16)

Conta	Site	Notas
carstuff	carstuff.pt
ealmeida	descomplicar.pt	principal
ealmeida	emanuelalmeida.pt
ealmeida	ecommerce.descomplicar.pt
ealmeida	ecommerce-demo.descomplicar.pt
ealmeida	starter.descomplicar.pt
ealmeida	care.descomplicar.pt	KiviCare
ealmeida	e-commerce.descomplicar.pt
espiral	espiralsenior.pt	booking plugin desactivado
espiral	dev.espiralsenior.pt
familycl	familyclinic.pt	KiviCare
ignition	ignitionvortex.pt
karate	karateclubedegaia.com
sintri	sintricare.com.pt
solarfv	solarfvengenharia.com
wtc	watercontrol.pt

Domínios expirados (excluídos): jornadadoheroi.pt, tecoworking.pt, socialboost.pt

---

SCRIPT DE VERIFICAÇÃO

Local: /media/ealmeida/Dados/Dev/ClaudeDev/Claude-Scripts/wp-update/check-wp-sites.sh No servidor: /root/scripts/check-wp-sites.sh

O script verifica:

• Código HTTP (200, 301, 403, 500, etc.)
• Conteúdo da página por erros WordPress específicos:
  • "Ocorreu um erro crítico neste site"
  • "There has been a critical error"
  • "Fatal error:.*in /home/"
  • "Error establishing a database connection"

IMPORTANTE: Códigos HTTP 200 NÃO garantem que o site está OK. WordPress pode devolver 200 com página de erro crítico.

---

WORKFLOW

1. Verificação Inicial (OBRIGATÓRIO)

Executar script de verificação no servidor:

/root/scripts/check-wp-sites.sh carstuff.pt descomplicar.pt emanuelalmeida.pt ecommerce.descomplicar.pt ecommerce-demo.descomplicar.pt starter.descomplicar.pt care.descomplicar.pt e-commerce.descomplicar.pt espiralsenior.pt dev.espiralsenior.pt familyclinic.pt ignitionvortex.pt karateclubedegaia.com sintricare.com.pt solarfvengenharia.com watercontrol.pt

REGRA CRÍTICA: Se site reportar ❌ → investigar e corrigir ANTES de actualizar.

2. Actualização por Site

Para cada site funcional:

# Actualizar plugins
wp plugin update --all --allow-root --path=/home/USER/PATH

# Actualizar temas
wp theme update --all --allow-root --path=/home/USER/PATH

# Actualizar core
wp core update --allow-root --path=/home/USER/PATH

# Corrigir permissões (OBRIGATÓRIO)
chown -R USER:USER /home/USER/PATH/wp-content/

3. Verificação Final (OBRIGATÓRIO)

Re-executar script de verificação para confirmar que todos os sites continuam funcionais.

---

PATHS DOS SITES

Site	Path
carstuff.pt	/home/carstuff/public_html
descomplicar.pt	/home/ealmeida/public_html
emanuelalmeida.pt	/home/ealmeida/emanuelalmeida.pt
ecommerce.descomplicar.pt	/home/ealmeida/ecommerce.descomplicar.pt
ecommerce-demo.descomplicar.pt	/home/ealmeida/ecommerce-demo.descomplicar.pt
starter.descomplicar.pt	/home/ealmeida/starter.descomplicar.pt
care.descomplicar.pt	/home/ealmeida/care.descomplicar.pt
e-commerce.descomplicar.pt	/home/ealmeida/e-commerce.descomplicar.pt
espiralsenior.pt	/home/espiral/public_html
dev.espiralsenior.pt	/home/espiral/dev.espiralsenior.pt
familyclinic.pt	/home/familycl/public_html
ignitionvortex.pt	/home/ignition/public_html
karateclubedegaia.com	/home/karate/karateclubedegaia.com
sintricare.com.pt	/home/sintri/public_html
solarfvengenharia.com	/home/solarfv/public_html
watercontrol.pt	/home/wtc/public_html

---

ERROS COMUNS E SOLUÇÕES

Erro: "Class not found" (KiviCare)

# Desactivar plugin problemático
mv /path/wp-content/plugins/PLUGIN /path/wp-content/plugins/PLUGIN.disabled

# Reinstalar do care.descomplicar.pt (tem versões actualizadas)
cp -r /home/ealmeida/care.descomplicar.pt/wp-content/plugins/PLUGIN /path/wp-content/plugins/
chown -R USER:USER /path/wp-content/plugins/PLUGIN

Erro: "Operation not permitted"

# Adicionar FS_METHOD ao wp-config.php
sed -i "/^define.*WP_DEBUG/a define('FS_METHOD', 'direct');" /path/wp-config.php

Erro: Permissões após update

chown -R USER:USER /path/wp-content/

---

PLUGINS PREMIUM (Licenças)

Alguns plugins não actualizam automaticamente por falta de licença:

• elementor-pro
• wpforms (versão paga)
• bdthemes-element-pack

Estes requerem actualização manual via CodeCanyon/download.

---

INTEGRAÇÃO COM /today

Esta skill é invocada automaticamente às segundas-feiras pelo comando /today.

Workflow segunda-feira:

1. /today detecta que é segunda
2. Executa verificação inicial
3. Reporta estado dos sites
4. Propõe actualizações pendentes

---

CHANGELOG

v1.1.0 (2026-02-02)

• Script movido para /media/ealmeida/Dados/Dev/ClaudeDev/Claude-Scripts/wp-update/
• Removidos domínios expirados da lista (jornadadoheroi, tecoworking, socialboost)
• Adicionada documentação sobre verificação de conteúdo
• README.txt adicionado com tarefa DeskCRM

v1.0.0 (2026-02-02)

• Criação inicial
• Script de verificação robusta
• Lista de 16 sites activos
• Integração com /today para segundas-feiras

---

Quando NÃO Usar

• Para tarefas fora do domínio de especialização desta skill
• Quando outra skill mais específica está disponível
• Para operações que requerem aprovação manual obrigatória
• Quando os requisitos não estão claramente definidos

Protocolo de Execução

1. Análise Inicial

   • Verificar requisitos e contexto
   • Identificar ferramentas necessárias

2. Preparação

   • Validar acesso a recursos
   • Preparar ambiente de trabalho

3. Execução

   • Executar operações de forma incremental
   • Validar cada passo antes de prosseguir

4. Validação

   • Verificar resultados obtidos
   • Confirmar sucesso da operação

5. Conclusão

   • Documentar alterações realizadas
   • Reportar status final e próximos passos

Exemplos de Uso

Exemplo 1: Caso Básico

User: [requisição simples relacionada com wp-update]
Skill: [execução directa com validação]
Output: [resultado conciso e accionável]

Exemplo 2: Caso Complexo

User: [requisição multi-passo ou complexa]
Skill:
  1. Análise dos requisitos
  2. Planeamento da abordagem
  3. Execução faseada
  4. Validação contínua
Output: [resultado detalhado com próximos passos]

Exemplo 3: Caso com Dependências

User: [requisição que depende de outros sistemas]
Skill:
  1. Verificar dependências disponíveis
  2. Coordenar com skills/MCPs necessários
  3. Executar workflow integrado
Output: [resultado completo com referências]