feat: refactor 30+ skills to Anthropic progressive disclosure pattern

- All SKILL.md files now <500 lines (avg reduction 69%) - Detailed content extracted to references/ subdirectories - Frontmatter standardised: only name + description (Anthropic standard) - New skills: brand-guidelines, spec-coauthor, report-templates, skill-creator - Design skills: anti-slop guidelines, premium-proposals reference - Removed non-standard frontmatter fields (triggers, version, author, category) Plugins affected: infraestrutura, marketing, dev-tools, crm-ops, gestao, core-tools, negocio, perfex-dev, wordpress, design-media Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 15:05:03 +00:00
parent 9404af7ac9
commit 6b3a6f2698
397 changed files with 67154 additions and 17257 deletions
--- a/negocio/skills/research/SKILL.md
+++ b/negocio/skills/research/SKILL.md
@@ -1,18 +1,11 @@
 ---
 name: research
-description: Skill especializada em pesquisa profunda e análise competitiva, usando
-  frameworks como SWOT, Porter's Five Forces e PESTEL.
-author: Descomplicar® Crescimento Digital
-version: 2.0.0
-quality_score: 55
-user_invocable: true
-desk_task: null
-allowed-tools: Task, WebFetch
+description: Pesquisa profunda e analise competitiva usando frameworks como SWOT, Porter's Five Forces e PESTEL.
 ---

-# Skill /research - Research & Competitive Analysis
+# Skill /research - Research e Competitive Analysis

-Skill especializada em pesquisa profunda e análise competitiva, usando frameworks como SWOT, Porter's Five Forces e PESTEL.
+Skill especializada em pesquisa profunda e analise competitiva, usando frameworks como SWOT, Porter's Five Forces e PESTEL.

 ## Sintaxe

@@ -20,422 +13,79 @@ Skill especializada em pesquisa profunda e análise competitiva, usando framewor
 /research [operacao] [contexto]
 ```

-**Operações:**
- `swot` - Análise SWOT (Strengths, Weaknesses, Opportunities, Threats)
+**Operacoes:**
+- `swot` - Analise SWOT (Strengths, Weaknesses, Opportunities, Threats)
 - `competitive` - Competitive analysis de concorrentes
 - `market` - Market research e sizing (TAM/SAM/SOM)
- `pestel` - Análise macro-ambiental (Political, Economic, Social, Tech, Environmental, Legal)
- `porter` - Porter's Five Forces (rivalidade, fornecedores, clientes, entrantes, substitutos)
+- `pestel` - Analise macro-ambiental (Political, Economic, Social, Tech, Environmental, Legal)
+- `porter` - Porter's Five Forces
 - `due-diligence` - Due diligence completa (M&A, partnership, investment)

 ## Quando Usar

- Análise de mercado para novo produto
+- Analise de mercado para novo produto
 - Competitive intelligence de concorrentes
- Due diligence para aquisição/parceria
- Decisão estratégica (entrar num mercado, pivot)
+- Due diligence para aquisicao/parceria
+- Decisao estrategica (entrar num mercado, pivot)
 - Pitch deck para investidores

 ---

-## Protocolo de Execução
+## Contexto NotebookLM

-### 1. Definir Scope (SEMPRE começar aqui)
+ANTES de executar, consultar notebooks para contexto especializado:

-**Research Brief Template:**
-
-```markdown
-# Research Brief: [Título]
-
-## Pergunta Central
-[O que queremos descobrir? Ex: "Viabilidade de entrar no mercado PT de e-learning corporativo"]
-
-## Stakeholders
- Decision maker: [Nome, Cargo]
- Beneficiários: [Quem usa a research?]
- Approval: [Quem aprova?]
-
-## Timeline
- Início: [Data]
- Entrega: [Data]
- Urgência: Alta / Média / Baixa
-
-## Âmbito
-**In scope:**
- [X]
- [Y]
-
-**Out of scope:**
- [A]
- [B]
-
-## Fontes a Consultar
- [ ] Fontes primárias (entrevistas, surveys)
- [ ] Fontes secundárias (relatórios, artigos)
- [ ] Dados internos (analytics, CRM)
- [ ] Dados públicos (websites, LinkedIn)
-
-## Output Esperado
- Formato: Brief (1 pág) / Report (5-10 pág) / Deep Dive (20+ pág)
- Entrega: PDF / Apresentação / Dashboard
-```
-
-### 2. Recolha de Dados
-
-**Fontes Primárias (dados originais):**
+| Notebook | ID | Consultar quando |
+|----------|-----|-----------------|
+| Estrategia e Empreendedorismo | 79d43410 | Para contexto estrategico |

 ```
-ENTREVISTAS
- Stakeholders internos (5-10)
- Clientes actuais (10-20)
- Prospects (5-10)
- Experts da indústria (3-5)
-
-Template perguntas:
-1. Maior desafio no [área]?
-2. Soluções actuais? Satisfação?
-3. O que faria a solução ideal?
-4. Quanto vale resolver este problema?
-5. Quem decide compra? Processo?
-
-SURVEYS
- Amostra: 50-200 respostas (statistical significance)
- Duração: < 5 minutos
- Incentivo: Sorteio / Report grátis
- Plataforma: Typeform / Google Forms
-```
-
-**Fontes Secundárias (dados existentes):**
-
-```
-RELATÓRIOS INDÚSTRIA
- Gartner, Forrester, IDC (paywalled)
- Statista, eMarketer (público)
- CB Insights (funding, trends)
-
-DADOS PÚBLICOS
- Websites concorrentes (WebFetch)
- LinkedIn (empresa, equipa, vagas)
- Crunchbase (funding, investors)
- G2, Capterra, Trustpilot (reviews)
- Google Trends (interesse ao longo tempo)
- SimilarWeb (tráfego, sources)
-
-DADOS INTERNOS
- Google Analytics (comportamento users)
- Desk CRM (deals ganhos/perdidos)
- Support tickets (pain points)
- Sales calls recordings (objecções)
-```
-
-### 3. Frameworks de Análise
-
-**A. SWOT Analysis**
-
-```
-┌─────────────────────────┬─────────────────────────┐
-│     STRENGTHS           │      WEAKNESSES         │
-│     (Interno +)         │      (Interno -)        │
-├─────────────────────────┼─────────────────────────┤
-│ O que fazemos bem?      │ Onde falhamos?          │
-│ Recursos únicos?        │ Recursos que faltam?    │
-│ Vantagens competitivas? │ Desvantagens vs compe?  │
-│                         │                         │
-│ Ex:                     │ Ex:                     │
-│ • Equipa experiente     │ • Marca desconhecida    │
-│ • Tech stack moderna    │ • Budget marketing      │
-│ • Clientes satisfeitos  │ • Sem sales team        │
-└─────────────────────────┴─────────────────────────┘
-
-┌─────────────────────────┬─────────────────────────┐
-│    OPPORTUNITIES        │       THREATS           │
-│    (Externo +)          │      (Externo -)        │
-├─────────────────────────┼─────────────────────────┤
-│ Tendências a favor?     │ Riscos externos?        │
-│ Gaps no mercado?        │ Concorrência?           │
-│ Mudanças regulação?     │ Mudanças tecnológicas?  │
-│                         │                         │
-│ Ex:                     │ Ex:                     │
-│ • GDPR → procura        │ • Big tech entra        │
-│ • Remote work trend     │ • Recessão económica    │
-│ • Incentivos PT2030     │ • Open source gratuito  │
-└─────────────────────────┴─────────────────────────┘
-```
-
-**Próximos Passos (Estratégias):**
-```
-SO (Strengths + Opportunities): Crescimento agressivo
-ST (Strengths + Threats): Defesa activa
-WO (Weaknesses + Opportunities): Melhorar para aproveitar
-WT (Weaknesses + Threats): Dano mínimo / Pivot
-```
-
-**B. Porter's Five Forces**
-
-```
-┌─────────────────────────────────────────────────┐
-│ 1. RIVALIDADE ENTRE CONCORRENTES                │
-├─────────────────────────────────────────────────┤
-│ □ Quantos concorrentes directos?                │
-│ □ Crescimento do mercado?                       │
-│ □ Diferenciação possível?                       │
-│ □ Switching costs?                              │
-│ □ Guerras de preços?                            │
-│                                                 │
-│ Intensidade: ALTA / MÉDIA / BAIXA              │
-└─────────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────────┐
-│ 2. PODER DE NEGOCIAÇÃO DOS FORNECEDORES         │
-├─────────────────────────────────────────────────┤
-│ □ Poucos fornecedores alternativos?             │
-│ □ Custos de mudança elevados?                   │
-│ □ Fornecedor pode integrar verticalmente?       │
-│                                                 │
-│ Poder: ALTO / MÉDIO / BAIXO                     │
-└─────────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────────┐
-│ 3. PODER DE NEGOCIAÇÃO DOS CLIENTES             │
-├─────────────────────────────────────────────────┤
-│ □ Poucos clientes (concentração)?               │
-│ □ Produto/serviço commoditizado?                │
-│ □ Switching costs baixos?                       │
-│ □ Transparência de preços?                      │
-│                                                 │
-│ Poder: ALTO / MÉDIO / BAIXO                     │
-└─────────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────────┐
-│ 4. AMEAÇA DE NOVOS ENTRANTES                    │
-├─────────────────────────────────────────────────┤
-│ □ Barreiras à entrada (capital, regulação)?     │
-│ □ Economias de escala necessárias?              │
-│ □ Lealdade à marca existente?                   │
-│ □ Acesso a canais de distribuição?              │
-│                                                 │
-│ Ameaça: ALTA / MÉDIA / BAIXA                    │
-└─────────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────────┐
-│ 5. AMEAÇA DE PRODUTOS SUBSTITUTOS               │
-├─────────────────────────────────────────────────┤
-│ □ Alternativas com melhor price/performance?    │
-│ □ Switching costs baixos para substituto?       │
-│ □ Tendências favor do substituto?               │
-│                                                 │
-│ Ameaça: ALTA / MÉDIA / BAIXA                    │
-└─────────────────────────────────────────────────┘
-
-CONCLUSÃO:
-Atractividade da indústria: ALTA / MÉDIA / BAIXA
-Estratégia recomendada: [...]
-```
-
-**C. PESTEL Analysis**
-
-```
-POLITICAL (Regulação, Estabilidade)
-• Regulação GDPR/privacy → [impacto]
-• Incentivos fiscais I&D → [oportunidade]
-• Estabilidade governo PT → [risco]
-
-ECONOMIC (Inflação, Crescimento, Câmbio)
-• Taxa de juro → [impacto custos financiamento]
-• Crescimento PIB PT → [procura]
-• Taxa de desemprego → [talento disponível]
-
-SOCIAL (Demografia, Tendências, Valores)
-• Remote work trend → [oportunidade]
-• Envelhecimento população → [target]
-• Adopção tecnologia SMBs → [timing]
-
-TECHNOLOGICAL (Inovação, Disrupção)
-• AI/ML acessível → [competitive advantage]
-• Cloud computing → [custos infra]
-• Open source → [ameaça]
-
-ENVIRONMENTAL (Sustentabilidade, Clima)
-• Pressão ESG → [requisito]
-• Carbon neutrality → [diferenciador]
-• Green tech → [nicho]
-
-LEGAL (Legislação, Compliance)
-• Lei do trabalho remoto → [oportunidade]
-• Regulação sector X → [barreira entrada]
-• IP/patents → [protecção]
-```
-
-**D. Competitive Analysis Template**
-
-```markdown
-# Competitive Analysis: [Concorrente X]
-
-## Overview
- **Website:** [URL]
- **Fundação:** [Ano]
- **HQ:** [Localização]
- **Tamanho:** [Nº employees] - via LinkedIn
- **Funding:** [Total raised] - via Crunchbase
- **Investors:** [Lista] - via Crunchbase
- **Status:** Activo / Estável / Crescendo / Declinando
-
-## Produto/Serviço
-**Oferta principal:**
- [Produto A]
- [Produto B]
-
-**Pricing:**
-| Plano | Preço | Features-chave |
-|-------|-------|----------------|
-| Free | 0€ | [features] |
-| Pro | 29€/mês | [features] |
-| Enterprise | Custom | [features] |
-
-**Diferenciadores:**
- [O que eles fazem bem único]
-
-**Tech Stack:** (via BuiltWith/Wappalyzer)
- Frontend: [React / Vue / etc]
- Backend: [Node / Python / etc]
- Hosting: [AWS / Vercel / etc]
-
-## Go-to-Market
-**Target:** [ICP - Ideal Customer Profile]
-**Channels:**
- SEO: [Organic traffic estimate] - SimilarWeb
- PPC: [Ads visíveis] - SpyFu
- Content: [Blog posts/mês]
- Social: [Followers, engagement]
-
-**Messaging:**
- Headline: "[copiar da homepage]"
- Value prop: "[resumir em 1 frase]"
-
-## Customer Feedback (G2/Capterra/Trustpilot)
-**Rating:** 4.2/5 (123 reviews)
-
-**Top Positives:**
- [Feature A] mentioned in 60% reviews
- [Aspecto B] praised
-
-**Top Complaints:**
- [Bug/limitation C] em 40% reviews
- [Pricing] considerado caro
-
-## Strengths vs Us
- ✅ [Vantagem deles]
- ✅ [Vantagem deles]
-
-## Weaknesses vs Us
- ❌ [Desvantagem deles]
- ❌ [Gap que exploramos]
-
-## Oportunidades de Diferenciação
-1. [Feature X que eles não têm]
-2. [Segmento Y que ignoram]
-3. [Pricing model Z mais justo]
-
-## Threat Level
-🔴 HIGH / 🟡 MEDIUM / 🟢 LOW
-
-**Reasoning:** [...]
-```
-
-### 4. Market Sizing (TAM/SAM/SOM)
-
-```
-TAM (Total Addressable Market)
-"Se tivéssemos 100% do mercado..."
-Exemplo: Todas as PMEs em Portugal = 1.2M empresas × 500€/ano = 600M€
-
-SAM (Serviceable Available Market)
-"Mercado que conseguimos servir realisticamente..."
-Exemplo: PMEs 10-50 employees em PT = 80k empresas × 500€ = 40M€
-
-SOM (Serviceable Obtainable Market)
-"Quota que conseguimos capturar em 3 anos..."
-Exemplo: 2% do SAM = 800 empresas × 500€ = 400k€
-
-Validação:
-□ Bottom-up (clientes × preço)
-□ Top-down (% de mercado total)
-□ Value theory (quanto vale resolver problema)
-```
-
-### 5. Synthesis & Reporting
-
-**Executive Summary (1 página):**
-
-```markdown
-# Executive Summary: [Título Research]
-
-## Key Question
-[Pergunta central]
-
-## Conclusion (TL;DR)
-[Recomendação clara: GO / NO-GO / WAIT / PIVOT]
-
-## Key Findings (Top 3)
-1. [Finding mais importante]
-2. [Finding #2]
-3. [Finding #3]
-
-## Risks & Mitigations
-| Risco | Probabilidade | Impacto | Mitigação |
-|-------|---------------|---------|-----------|
-| [Risco A] | Alta | Alto | [Como mitigar] |
-
-## Next Steps
-1. [Acção imediata]
-2. [Acção follow-up]
-3. [Decision point]
-
-## Resources Needed
- Budget: [X]€
- Time: [Y] semanas
- Team: [Z] pessoas
+mcp__notebooklm__notebook_query({
+  notebook_id: "79d43410-0e29-4be1-881d-84db6bdc239a",
+  query: "<adaptar ao contexto do pedido do utilizador>"
+})
 ```

 ---

-## Consultar Datasets Dify
+## Protocolo de Execucao

-**SEMPRE antes de análise estratégica:**
+### 1. Definir Scope (SEMPRE comecar aqui)

-| Dataset | ID | Query Exemplo |
-|---------|----|--------------:|
-| **Estratégia** | `7d1d1d21-bc05-43d8-ab8f-6b7b90dafc28` | "analise swot porter five forces" |
-| **Marketing Digital** | `c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24` | "competitive analysis research metodologia" |
-| **Gestão** | `22799925-8dc5-4a1f-92b9-233468a5048b` | "due diligence checklist decisao" |
+Usar Research Brief Template em: `references/recolha-dados-templates.md`

-### Como Consultar
+### 2. Recolha de Dados

-```javascript
-// Frameworks estratégicos
-mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
-  dataset_id: "7d1d1d21-bc05-43d8-ab8f-6b7b90dafc28",
-  query: "swot porter pestel analise estrategica",
-  retrieval_mode: "hybrid_search",
-  top_k: 5
-});
+Fontes primarias (entrevistas, surveys) e secundarias (relatorios, dados publicos, dados internos) detalhadas em: `references/recolha-dados-templates.md`

-// Metodologias research
-mcp__dify-kb__dify_kb_retrieve_segments({
-  dataset_id: "c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24",
-  query: "research metodologia fontes validacao",
-  retrieval_mode: "hybrid_search",
-  top_k: 5
-});
-```
+### 3. Frameworks de Analise
+
+Templates completos para SWOT, Porter's Five Forces, PESTEL e Competitive Analysis em: `references/frameworks-analise.md`
+
+**Resumo dos frameworks:**
+
+| Framework | Quando usar | Foco |
+|-----------|-------------|------|
+| SWOT | Qualquer analise estrategica | Interno (S/W) + Externo (O/T) |
+| Porter | Avaliar atractividade industria | 5 forcas competitivas |
+| PESTEL | Analise macro-ambiental | 6 factores externos |
+| Competitive | Analisar concorrentes | Produto, pricing, GTM, feedback |
+
+### 4. Market Sizing (TAM/SAM/SOM)
+
+Template em: `references/recolha-dados-templates.md` (seccao Market Sizing)
+
+### 5. Synthesis e Reporting
+
+Executive Summary template em: `references/recolha-dados-templates.md` (seccao Executive Summary)

 ---

 ## MCPs Utilizados

 ```
-mcp__web-fetch__*                    # Análise websites concorrentes
-mcp__dify-kb__dify_kb_retrieve_segments  # Frameworks estratégicos
+mcp__web-fetch__*                    # Analise websites concorrentes
+mcp__notebooklm__notebook_query      # Frameworks estrategicos
 mcp__google-workspace__*             # Docs para reports
 ```

@@ -446,67 +96,33 @@ mcp__google-workspace__*             # Docs para reports
 ### 1. Competitive Analysis
 ```
 /research competitive "Concorrente X"
-→ Recolha dados (website, reviews, funding)
-→ Framework análise (SWOT vs nós)
-→ Report estruturado
-→ Export para Google Docs
+-> Recolha dados (website, reviews, funding)
+-> Framework analise (SWOT vs nos)
+-> Report estruturado
+-> Export para Google Docs
 ```

 ### 2. Market Entry Decision
 ```
 /research swot + pestel + porter
-→ Análise multi-framework
-→ Consultadify KB (best practices)
-→ Risk assessment
-→ Recomendação GO/NO-GO
+-> Analise multi-framework
+-> Consulta NotebookLM (best practices)
+-> Risk assessment
+-> Recomendacao GO/NO-GO
 ```

-### 3. Due Diligence Rápida
+### 3. Due Diligence Rapida
 ```
 /research due-diligence "Empresa Y"
-→ Levantamento financeiro, equipa, produto
-→ Red flags check
-→ Valuation estimate
-→ Report executivo
+-> Levantamento financeiro, equipa, produto
+-> Red flags check
+-> Valuation estimate
+-> Report executivo
 ```

 ---

-## Agentes Recomendados
+## References

-```javascript
-// Research profundo
-Task({
-  subagent_type: "research-analyst",
-  model: "sonnet",
-  prompt: "Full competitive analysis. Sector: [X]. Competitors: [A, B, C]."
-});
-
-// Estratégia go-to-market
-Task({
-  subagent_type: "marketing-planning-expert",
-  model: "sonnet",
-  prompt: "Market entry strategy. Target: [segment]. Research findings: [...]"
-});
-```
-
---
-
-## Instrumentação Automática
-
-### Query para Gravar (executar no final)
-
-```sql
-INSERT INTO tblskill_agent_metrics (
-  type, name, duration_ms, status, staff_id,
-  kb_consulted, kb_cache_hit, tool_calls, project_id
-) VALUES (
-  'skill', '/research', {DURACAO_MS}, '{STATUS}', 25,
-  {KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
-);
-```
-
---
-
-**Versão**: 2.0.0 | **Data**: 2026-02-03 | **Autor**: Descomplicar®
-**Instrumentação**: Activa
+- `references/frameworks-analise.md` - Templates SWOT, Porter, PESTEL, Competitive Analysis
+- `references/recolha-dados-templates.md` - Fontes dados, Research Brief, TAM/SAM/SOM, Executive Summary