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

name, description, author, version, quality_score, user_invocable, category, tags, desk_task, desk_project, allowed-tools, mcps, data_sources, datasets, dependencies, triggers, packages, performance

name	description	author	version	quality_score	user_invocable	category	tags	desk_task	desk_project	allowed-tools	mcps	data_sources	datasets	dependencies	triggers	packages	performance
orcamento	Criação sistemática de orçamentos Descomplicar® baseados em tabela oficial de preços (tabela-geral.csv). Integração directa CRM para proposals/estimates. Suporta StarterWP, CorporateWP, CareWP, eCommerceWP, Marketing 360, Manutenção. Consulta obrigatória datasets Dify (Serviços, Vendas). Use when user asks to create, generate or elaborate budget/proposal, or mentions "orçamento", "proposta", "estimate", "pricing", "website budget".	Descomplicar® Crescimento Digital	3.1.0	100	true	business	orcamento proposta pricing crm proposals estimates vendas packages	1415	65	Read, Bash, mcp__desk-crm-v3, mcp__dify-kb	desk-crm-v3, dify-kb	path priority usage /media/ealmeida/Dados/GDrive/Cloud/Docs/Produtos_Servicos/tabela-geral.csv 1 All products/services with pricing path priority usage /media/ealmeida/Dados/GDrive/Cloud/Docs/Produtos_Servicos/items-subscricao.csv 2 Subscription services path priority usage /media/ealmeida/Dados/GDrive/Cloud/Docs/Produtos_Servicos/chatbots-precos.csv 2 Chatbot pricing path priority usage /media/ealmeida/Dados/GDrive/Cloud/Docs/Produtos_Servicos/items-faturacao-deskcrm.csv 2 Billing items	id name priority usage bd65f36e-6004-4584-b478-129b2c21b4d2 Serviços Descomplicar 1 Packages, pricing justification id name priority usage a7ba6005-517c-41ab-ac5e-da1c1a1c62ef Vendas 1 Proposal techniques, negotiation id name priority usage c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24 Marketing Digital 2 Value proposition, ROI id name priority usage c8489151-de94-42b2-8cee-c0b961cfac6d Websites 2 Website features comparison	skills mcps crm-ops lead-approach desk-crm-v3 dify-kb	User asks to create/generate/elaborate budget User mentions 'orçamento', 'proposta', 'pricing' User asks for 'estimate', 'quote', 'proposal' Creating pricing for leads or customers	code name base_price annual_fee timeline starter StarterWP 700 250 3-5 weeks code name base_price annual_fee timeline corporate CorporateWP 900 299 4-6 weeks code name base_price annual_fee timeline care CareWP 1300 350 4-6 weeks code name base_price annual_fee timeline ecom eCommerceWP 1100 349 7-9 weeks code name base_price billing commitment mkt Marketing 360 459 monthly 12 months code name base_price billing commitment man Manutenção 150 monthly 12 months	baseline_duration_ms target_duration_ms last_run_duration_ms success_rate 1800000 900000 null 0.92

Skill /orcamento - Criação Sistemática de Orçamentos

Skill para criar orçamentos profissionais baseados na tabela oficial de preços Descomplicar®, com integração directa ao CRM.

Quando Usar

• Criar orçamento para cliente novo ou existente
• Gerar proposta comercial (proposal ou estimate)
• Consultar preços oficiais de produtos/serviços
• Calcular valores com IVA e anuidades
• Integrar orçamento directamente no CRM

Quando NÃO Usar

• Para análise estratégica de lead (usar /lead-approach)
• Para operações CRM genéricas (usar /crm-ops)
• Para simples consulta de preços (ler CSV directamente)

---

Protocolo

Fontes de Dados (OBRIGATÓRIO)

IMPORTANTE: Antes de criar qualquer orçamento, ler SEMPRE os dados actualizados de:

/media/ealmeida/Dados/GDrive/Cloud/Docs/Produtos_Servicos/
├── tabela-geral.csv              ← Todos os produtos/serviços com preços
├── items-subscricao.csv          ← Serviços de subscrição
├── chatbots-precos.csv           ← Preços de chatbots
└── items-faturacao-deskcrm.csv   ← Items para facturação

Estrutura do CSV Principal (tabela-geral.csv)

Campo	Descrição
Codigo	Código único (ex: WEB-WP-001)
Nome	Nome do produto/serviço
Familia	Categoria principal (Websites, Design, Tecnologia, etc.)
PrecoBase	Valor em euros
Unidade	Tipo (Projeto, Hora, Investimento, Mês)
DescricaoCurta	Para orçamento
TempoEstimado	Em dias/semanas

Como Usar os CSVs

# Exemplo de leitura
import csv
with open('/media/.../Produtos_Servicos/tabela-geral.csv') as f:
    reader = csv.DictReader(f)
    for row in reader:
        if row['Codigo'] == 'WEB-WP-001':  # StarterWP
            preco = float(row['PrecoBase'])  # 700

Regra: Os CSVs são a fonte de verdade. O pricing-guide.md é referência rápida.

Sintaxe

/orcamento [cliente] [tipo]

Parâmetros:

• cliente - Nome ou ID do cliente (opcional, será solicitado se omitido)
• tipo - Tipo de orçamento (opcional, será apresentado menu se omitido)

Tipos disponíveis:

Código	Tipo	Template	Valor Base
starter	StarterWP	templates/website-corporativo.md	700€
corporate	CorporateWP	templates/website-corporativo.md	900€
care	CareWP (Clínicas)	templates/website-corporativo.md	1.300€
ecom	eCommerceWP	templates/e-commerce.md	1.100€
mkt	Marketing Digital 360	templates/marketing-digital.md	459€/mês
man	Manutenção	templates/manutencao.md	150€/mês

Fluxo de Execução

Fase 1: Identificação do Cliente

1. Se cliente fornecido, pesquisar no CRM:

   mcp__desk-crm-v3__search_customers query="[nome]" fields="company,vat"
   

2. Se não encontrado ou não fornecido, solicitar dados:

   • Nome da empresa
   • NIF (opcional)
   • Email contacto

3. Validar cliente existe ou criar novo:

   mcp__desk-crm-v3__create_customer company="..." vat="..." ...
   

Fase 2: Selecção de Template

1. Se tipo fornecido, carregar template correspondente
2. Se não fornecido, apresentar menu interactivo via AskUserQuestion:
   • StarterWP (700€ + 250€/ano)
   • CorporateWP (900€ + 299€/ano)
   • CareWP (1.300€ + 350€/ano)
   • eCommerceWP (1.100€ + 349€/ano)
   • Marketing 360 (459€/mês)
   • Manutenção (150€/mês)

Fase 3: Personalização

1. Ler template seleccionado de templates/
2. Apresentar questões de personalização específicas do tipo
3. Adicionar funcionalidades conforme requisitos
4. Calcular valores usando tabela de references/pricing-guide.md

Fase 4: Geração do Orçamento

1. Calcular valores finais:

   • Subtotal por item
   • IVA 23%
   • Total
   • Anuidade (se aplicável)

2. Criar estimate no CRM:

   mcp__desk-crm-v3__create_estimate
     client_id=[id]
     date=[hoje]
     expiry_date=[hoje + 30 dias]
     items=[items calculados]
     terms="Condições de Pagamento: 50% na adjudicação + 50% na entrega"
   

3. Apresentar resumo ao utilizador com link para CRM

Tabela de Preços Base

Ver references/pricing-guide.md para tabela completa.

Websites

Produto	Setup	Anuidade	Prazo
StarterWP	700€	250€	3-5 sem
CorporateWP	900€	299€	4-6 sem
eCommerceWP	1.100€	349€	7-9 sem
ChallengeWP	700€	250€	8-10 sem
CareWP	1.300€	350€	4-6 sem

Funcionalidades Frequentes

Funcionalidade	Valor
EasyAppointment	175€ (55+120)
Chat da Página	50€ + 50€/ano
Forms Inteligentes	150€
CartRecovery	190€ (90+100) + 90€/ano
Pixel + GTM	50€
ShopBuilder	5€/produto

Serviços Recorrentes

Serviço	Valor Mensal	Compromisso
Marketing 360	459€	12 meses
Manutenção	150€	12 meses

Termos e Condições Padrão

CONDIÇÕES DE PAGAMENTO

1. Projectos: 50% na adjudicação + 50% na entrega
2. Serviços recorrentes: facturação mensal antecipada

VALIDADE

Orçamento válido por 30 dias a partir da data de emissão.

ANUIDADE

A anuidade inclui:
- Alojamento Premium SSD NVMe
- Certificado SSL
- Actualizações de segurança
- Suporte técnico básico

Descomplicar® Crescimento Digital
NIF: 514 623 168 | descomplicar.pt

Estrutura de Items para API

Cada item do orçamento segue o formato:

{
  "description": "Descrição do serviço",
  "qty": 1,
  "rate": 700,
  "unit": "un"
}

Unidades:

• un - Unidade (projecto/item único)
• mes - Mês (serviço recorrente)
• ano - Ano (anuidade)

Checklist de Execução

• Cliente identificado/criado no CRM
• Tipo de orçamento seleccionado
• Template carregado
• Funcionalidades adicionais identificadas
• Valores calculados (subtotal + IVA)
• Anuidade calculada (se aplicável)
• Estimate criado no CRM
• Resumo apresentado ao utilizador

Exemplos de Uso

Exemplo 1: Website simples

/orcamento "TechStartup Lda" starter
→ StarterWP: 700€ + IVA
→ Anuidade: 250€/ano

Exemplo 2: E-commerce com funcionalidades

/orcamento "Loja Online SA" ecom
→ Questiona: Nº produtos? Gateways? Transportadoras?
→ Calcula com funcionalidades
→ Gera orçamento detalhado

Exemplo 3: Interactivo completo

/orcamento
→ Solicita cliente
→ Apresenta menu de tipos
→ Questões de personalização
→ Gera orçamento no CRM

MCPs Utilizados

mcp__desk-crm-v3__search_customers  - Pesquisar cliente
mcp__desk-crm-v3__get_customer      - Obter detalhes cliente
mcp__desk-crm-v3__create_customer   - Criar cliente novo
mcp__desk-crm-v3__create_estimate   - Criar orçamento
mcp__desk-crm-v3__get_estimates     - Listar orçamentos existentes

Códigos de Produtos (tabela-geral.csv)

Websites

Código	Produto	Preço
WEB-WP-001	StarterWP	700€
WEB-WP-002	CorporateWP	900€
WEB-WP-003	eCommerceWP	1.100€
WEB-WP-004	ChallengeWP	700€
WEB-WP-005	CareWP	1.300€

Branding

Código	Produto	Preço
DES-BRA-001	Branding WOW Essencial	850€
DES-BRA-002	Branding Completo	1.100€
DES-BRA-003	Branding WOW Digital	400€

AcceleratorX

Código	Produto	Preço
TEC-WPC-001	AcceleratorX WP ProCMS	650€
TEC-ECO-001	AcceleratorX e-Commerce	750€
TEC-MEM-001	AcceleratorX Membership	450€
TEC-BOO-001	AcceleratorX Booking	450€
TEC-CAR-001	AcceleratorX Care	750€

Consultoria

Código	Produto	Preço
EST-CON-001	Consultoria Estratégica	90€/hora
EST-COA-001	Coaching e Formação	50€/hora
EST-BRA-001	Estratégia de Marca	900€

Referências

• references/pricing-guide.md - Tabela de preços rápida
• templates/website-corporativo.md - Templates StarterWP, CorporateWP, CareWP
• templates/e-commerce.md - Template eCommerceWP
• templates/marketing-digital.md - Template Marketing 360
• templates/manutencao.md - Template Manutenção

Fonte de Dados Principal

/media/ealmeida/Dados/GDrive/Cloud/Docs/Produtos_Servicos/tabela-geral.csv

---

Datasets Dify (Consulta Obrigatória)

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

Dataset	ID	Prioridade
Serviços Descomplicar	bd65f36e-6004-4584-b478-129b2c21b4d2	1
Vendas	a7ba6005-517c-41ab-ac5e-da1c1a1c62ef	1
Marketing Digital	c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24	2
Desenvolvimento de WebSites	c8489151-de94-42b2-8cee-c0b961cfac6d	2

Como Consultar

// Pesquisar serviços e preços
mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "bd65f36e-6004-4584-b478-129b2c21b4d2",
  query: "pacote website ecommerce"
})

// Técnicas de proposta e negociação
mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "a7ba6005-517c-41ab-ac5e-da1c1a1c62ef",
  query: "proposta comercial fechamento"
})

// Funcionalidades de websites
mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "c8489151-de94-42b2-8cee-c0b961cfac6d",
  query: "funcionalidades website corporativo"
})

Quando Consultar

• Definir escopo de projecto
• Justificar preços ao cliente
• Comparar funcionalidades entre pacotes
• Criar proposta de valor diferenciada

---

Instrumentação Automática

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

Baseline

Métrica	Valor
Tempo baseline	30 min
Tempo target	15 min
Melhoria esperada	-50%

Ao Executar Esta Skill

1. Início: Registar SKILL_START = Date.now()
2. Consultas KB: Rastrear consultas Dify (KB_CONSULTED, KB_HITS)
3. Tool calls: Contar chamadas MCP
4. Fim: Gravar métrica

Query para Gravar (executar no final da skill)

-- Executar via SSH ou MCP no final da skill
INSERT INTO tblskill_agent_metrics (
  type, name, duration_ms, status, staff_id,
  kb_consulted, kb_cache_hit, tool_calls, project_id
) VALUES (
  'skill', '/orcamento', {DURACAO_MS}, '{STATUS}', 25,
  {KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
);

Exemplo Completo

-- Orçamento criado com sucesso em 20 minutos, consultou Dify, sem cache
INSERT INTO tblskill_agent_metrics (
  type, name, duration_ms, status, staff_id,
  kb_consulted, kb_cache_hit, tool_calls, project_id
) VALUES (
  'skill', '/orcamento', 1200000, 'success', 25,
  1, 0, 8, 65
);

Ver Métricas

/metrics /orcamento

Protocolo

Ver ~/.claude/skills/_core/instrumentation-protocol.md

---

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