claude-plugins/crm-ops/skills/crm-admin/SKILL.md

name, description, disable-model-invocation

name	description	disable-model-invocation
crm-admin	Administração e manutenção do Desk CRM. Gestão de utilizadores, permissões, campos personalizados, configuração de sistema e módulos Perfex.	true

CRM Admin Specialist

Skill para gestão e desenvolvimento Perfex CRM seguindo padrões Descomplicar®.

Quando Usar

• Consultas de dados CRM (clientes, projectos, tarefas)
• Relatórios e analytics de facturação
• Desenvolvimento de módulos Perfex
• Automação de processos CRM
• Integração com sistemas externos

Protocolo Obrigatório

1. MCP First (SEMPRE)

Antes de qualquer operação, usar MCPs:

mcp__desk-crm-v3__get_customers - verificar dados existentes
mcp__memory-supabase__search_memories "[contexto crm]"
mcp__wikijs__search_pages "perfex crm [funcionalidade]"

2. Dados Reais Obrigatórios

• NUNCA simular dados quando MCPs disponíveis
• Usar mcp__desk-crm-v3__* para TODAS operações CRM
• Validar IDs de clientes/projectos antes de modificar

3. Segurança de Dados

• NUNCA expor dados sensíveis de clientes em logs
• Confirmar antes de operações destrutivas (delete)
• Backup mental do estado antes de modificações bulk

MCPs Disponíveis - DeskCRM v3

Clientes

mcp__desk-crm-v3__get_customers      # Listar (filtros: search, active, country)
mcp__desk-crm-v3__get_customer       # Detalhes (client_id)
mcp__desk-crm-v3__create_customer    # Criar (company obrigatório)
mcp__desk-crm-v3__update_customer    # Actualizar (client_id)
mcp__desk-crm-v3__customer_analytics # Analytics (client_id, period)
mcp__desk-crm-v3__search_customers   # Pesquisa multi-campo (query, fields)

Projectos

mcp__desk-crm-v3__get_projects       # Listar (status, client_id, billing_type)
mcp__desk-crm-v3__get_project        # Detalhes (project_id)
mcp__desk-crm-v3__create_project     # Criar (name, client_id, billing_type)
mcp__desk-crm-v3__update_project     # Actualizar (project_id)
mcp__desk-crm-v3__project_analytics  # Analytics (period, status)

Tarefas

mcp__desk-crm-v3__get_tasks          # Listar (status, assigned_to, rel_type)
mcp__desk-crm-v3__get_task           # Detalhes (task_id)
mcp__desk-crm-v3__create_task        # Criar (name obrigatório)
mcp__desk-crm-v3__update_task        # Actualizar (task_id)
mcp__desk-crm-v3__task_analytics     # Analytics (period, staff_id)

Leads

mcp__desk-crm-v3__get_leads          # Listar (status, source, assigned)
mcp__desk-crm-v3__create_lead        # Criar (name obrigatório)
mcp__desk-crm-v3__update_lead        # Actualizar (lead_id)
mcp__desk-crm-v3__convert_lead_to_customer  # Converter (lead_id)
mcp__desk-crm-v3__lead_analytics     # Funil e conversões (report_type)

Financeiro

mcp__desk-crm-v3__get_payments             # Pagamentos
mcp__desk-crm-v3__get_estimates            # Orçamentos
mcp__desk-crm-v3__financial_kpi_dashboard  # KPIs (period)
mcp__desk-crm-v3__profit_loss_statement    # DRE (date_from, date_to)
mcp__desk-crm-v3__cash_flow_statement      # Fluxo caixa
mcp__desk-crm-v3__accounts_receivable_aging # Contas a receber

Tickets/Suporte

mcp__desk-crm-v3__get_tickets        # Listar (status, priority, assigned)
mcp__desk-crm-v3__create_ticket      # Criar (subject, message)
mcp__desk-crm-v3__reply_ticket       # Responder (ticket_id, message)
mcp__desk-crm-v3__ticket_analytics   # Analytics (period, department_id)

Assinatura para Módulos

<?php
/**
 * [Nome do Módulo/Ficheiro]
 *
 * @author Descomplicar® Crescimento Digital
 * @link https://descomplicar.pt
 * @copyright 2025 Descomplicar®
 */

Padrões de Relatórios

Ao gerar relatórios, incluir:

1. Período: Data início/fim claramente indicada
2. Totais: Agregações relevantes
3. Top N: Rankings quando aplicável
4. Comparação: Com período anterior se relevante

Checklist Consultas

• Usar MCPs para dados reais
• Validar IDs antes de operações
• Não expor dados sensíveis
• Confirmar operações destrutivas
• Apresentar dados formatados PT-PT

---

Datasets Dify (Consulta Obrigatória)

Em caso de dúvidas ou para aprofundar conhecimento, consultar os seguintes datasets via MCP:

Dataset	ID	Prioridade
PerfexCRM	43354eb6-f0b2-40cc-aa53-44e375ab347c	1
Vendas	a7ba6005-517c-41ab-ac5e-da1c1a1c62ef	2
Gestão	22799925-8dc5-4a1f-92b9-233468a5048b	2
Gestão de Processos	cae2a27e-f5bc-4d75-8a7a-9f83064f2512	3

Como Consultar

// Pesquisar funcionalidades Perfex
mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "43354eb6-f0b2-40cc-aa53-44e375ab347c",
  query: "modulo facturas automaticas"
})

// Pesquisar técnicas de vendas
mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "a7ba6005-517c-41ab-ac5e-da1c1a1c62ef",
  query: "pipeline vendas conversao"
})

Quando Consultar

• Desenvolver módulos Perfex CRM
• Configurar automações de vendas
• Optimizar processos de facturação
• Implementar workflows de gestão de clientes

---

Versão: 1.0.0 | Autor: Descomplicar®

---

Instrumentação Automática

Esta skill grava métricas automaticamente para análise PDCA.

Query para Gravar (executar no final)

INSERT INTO tblskill_agent_metrics (
  type, name, duration_ms, status, staff_id,
  kb_consulted, kb_cache_hit, tool_calls, project_id
) VALUES (
  'skill', '/$SKILL_NAME', {DURACAO_MS}, '{STATUS}', 25,
  {KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
);

---

Instrumentação: Activa | Data: 2026-02-03

---

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

Exemplos de Uso

Exemplo 1: Caso Básico

User: [requisição simples relacionada com crm-admin]
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]