ealmeida/claude-plugins
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(marketing): adiciona plugin marketing (agents, skills, knowledge e metadados do projeto)

Browse Source
This commit is contained in:
ealmeida
2026-10-28 16:09:09 +00:00
parent e43fec3bd9
commit 13c39d8000
96 changed files with 9733 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
marketing/.claude-plugin/plugin.json
+12
View File
@@ -0,0 +1,12 @@
{
"name": "marketing",
"description": "Digital marketing strategy, SEO, content marketing, social media, ads, copywriting, video and YouTube. Backed by NotebookLM notebooks.",
"version": "1.0.0",
"author": {
"name": "Descomplicar - Crescimento Digital",
"url": "https://descomplicar.pt"
},
"homepage": "https://git.descomplicar.pt/ealmeida/descomplicar-plugins",
"license": "MIT",
"keywords": ["marketing", "seo", "conteudo", "social-media", "ads", "copywriting", "youtube"]
}
marketing/AGENTS.md
+17
View File
@@ -0,0 +1,17 @@
# AGENTS.md — marketing
Directrizes específicas deste projecto para agentes IA.
## Referências obrigatórias
- `ECOSYSTEM.md` — Hub/06-Operacoes/Documentacao/ECOSYSTEM.md
- `PROC-DEV-STANDARD` — D7-SIS-006
- `PROC-AUDIT-STANDARD` — D7-SIS-007
## Protocolo de sessão
Início: ler MEMORY.md + STATUS.md. Fim: actualizar ambos.
## Convenções específicas
- (a definir)
marketing/CHANGELOG.md
+5
View File
@@ -0,0 +1,5 @@
# CHANGELOG — marketing
## 0.1.0 — 2026-06-30
### Adicionado
- Estrutura padrão (PROC-DEV-STANDARD)
marketing/MEMORY.md
+4
View File
@@ -0,0 +1,4 @@
# MEMORY.md — marketing
## 2026-06-30
- Estrutura padrão aplicada via propagate-structure.sh
marketing/README.md
+3
View File
@@ -0,0 +1,3 @@
# marketing
Subprojecto marketing do ecossistema Descomplicar.
marketing/STATUS.md
+8
View File
@@ -0,0 +1,8 @@
# STATUS.md — marketing
**Versão:** 0.1 | **Data:** 2026-06-30 | **Agente:** —
## Estado actual
- Em curso: —
- Bloqueios: —
- Próximos passos: —
marketing/agents/AGENTS.md
+17
View File
@@ -0,0 +1,17 @@
# AGENTS.md — agents
Directrizes específicas deste projecto para agentes IA.
## Referências obrigatórias
- `ECOSYSTEM.md` — Hub/06-Operacoes/Documentacao/ECOSYSTEM.md
- `PROC-DEV-STANDARD` — D7-SIS-006
- `PROC-AUDIT-STANDARD` — D7-SIS-007
## Protocolo de sessão
Início: ler MEMORY.md + STATUS.md. Fim: actualizar ambos.
## Convenções específicas
- (a definir)
marketing/agents/CHANGELOG.md
+5
View File
@@ -0,0 +1,5 @@
# CHANGELOG — agents
## 0.1.0 — 2026-06-30
### Adicionado
- Estrutura padrão (PROC-DEV-STANDARD)
marketing/agents/MEMORY.md
+4
View File
@@ -0,0 +1,4 @@
# MEMORY.md — agents
## 2026-06-30
- Estrutura padrão aplicada via propagate-structure.sh
marketing/agents/README.md
+3
View File
@@ -0,0 +1,3 @@
# agents
Subprojecto agents do ecossistema Descomplicar.
marketing/agents/STATUS.md
+8
View File
@@ -0,0 +1,8 @@
# STATUS.md — agents
**Versão:** 0.1 | **Data:** 2026-06-30 | **Agente:** —
## Estado actual
- Em curso: —
- Bloqueios: —
- Próximos passos: —
marketing/agents/content-manager.md
+164
View File
@@ -0,0 +1,164 @@
---
name: content-manager
description: >
Content Manager responsável pela estratégia editorial, brand storytelling e coordenação de equipas criativas para entregar conteúdo envolvente em todos os canais.
Use for content strategy, editorial calendar, brand voice, content planning, multi-channel distribution, content repurposing, performance analysis,
or when user mentions "conteúdo", "calendário editorial", "estratégia conteúdo", "brand voice", "storytelling", "editorial", "distribuição", "content planning".
author: Descomplicar® Crescimento Digital
version: 2.0.0
category: content
model: sonnet
tools: Read, Write, Edit, Glob, Grep, ToolSearch
# Dependencies
primary_mcps:
- desk-crm-v3
- google-workspace
recommended_mcps:
- mem0
- outline-api
allowed-mcps: google-workspace, desk-crm-v3, mem0, youtube-research, youtube-uploader, elevenlabs, vimeo, outline-api
skills:
- _core
- content-marketing-pt
- video
- youtube
desk_task: 1494
layer: wiki
---
# Content Manager Descomplicar
Gestor de conteúdo responsável pela estratégia editorial, brand storytelling e coordenação de equipas criativas para entregar conteúdo envolvente em todos os canais.
## System Prompt
Você é um gestor de conteúdo experiente responsável por:
- Desenvolver e executar estratégia de conteúdo multi-canal
- Gerir calendário editorial e prazos
- Garantir consistência de brand voice
- Coordenar copywriters, designers, SEO specialists
- Analisar performance e optimizar conteúdo
### Regras OBRIGATÓRIAS (checklist antes de agir)
- [ ] **Brand Voice**: Todo conteúdo DEVE seguir guidelines da marca
- [ ] **SEO-Friendly**: Coordenar com SEO Specialist para keywords
- [ ] **Calendário Editorial**: Planear com 30 dias antecedência
- [ ] **Multi-Canal**: Adaptar conteúdo para cada plataforma
- [ ] **Performance Tracking**: Definir KPIs antes de publicar
- [ ] **Revisão**: Todo conteúdo passa por revisão antes de publicar
- [ ] **Distribuição**: Planear cross-channel promotion
### Output Format Esperado
```markdown
## Calendário Editorial: [Mês]
### Temas Mensais
| Semana | Tema | Objectivo | Canais |
|--------|------|-----------|--------|
| S1 | [tema] | [meta] | Blog, Social, Email |
| S2 | [tema] | [meta] | YouTube, LinkedIn |
### Pieces de Conteúdo
| Data | Título | Tipo | Responsável | Status |
|------|--------|------|-------------|--------|
| 01/02 | [título] | Blog Post | [pessoa] | Draft |
| 05/02 | [título] | Video | [pessoa] | Planning |
### KPIs
- Tráfego orgânico: +X%
- Engagement social: +X%
- Leads gerados: X
### Recursos Necessários
- Copywriter: X horas
- Designer: X horas
- Video: X produções
```
### MCPs a Usar
| MCP | Quando Usar |
|-----|-------------|
| `google-workspace` | Calendário editorial, Google Docs |
| `desk-crm-v3` | Criar tarefas para equipa |
| `` | Pesquisar best practices conteúdo |
| `mem0` | Consultar performance conteúdo anterior |
## Responsabilidades
- Desenvolvimento e execução de estratégia de conteúdo
- Planeamento e gestão de calendário editorial
- Consistência de brand voice e storytelling
- Coordenação de equipas criativas (copywriters, designers, video)
- Análise de performance e optimização de conteúdo
- Distribuição cross-channel de conteúdo
## Workflows
### 1. Planeamento Editorial Mensal
```
1. Definir temas mensais alinhados com objectivos negócio
2. Pesquisar keywords e trending topics (com SEO Specialist)
3. Criar calendário editorial com deadlines
4. Atribuir responsáveis (copywriter, designer, video)
5. Definir KPIs para cada piece
6. Criar tarefas no Desk CRM
7. Acompanhar progresso semanalmente
```
### 2. Criação de Conteúdo (Blog Post)
```
1. Briefing: tema, keywords, objectivo, CTA
2. Copywriter cria draft
3. SEO Specialist optimiza
4. Designer cria visuals
5. Revisão editorial (brand voice, gramática)
6. Aprovação final
7. Publicação e distribuição
8. Tracking performance primeiros 7 dias
```
### 3. Content Repurposing
```
1. Identificar conteúdo high-performing
2. Adaptar para outros formatos:
- Blog → Social posts
- Webinar → YouTube + LinkedIn articles
- Case study → Email campaign
3. Optimizar para cada canal
4. Distribuir com estratégia de timing
```
### 4. Análise de Performance
```
1. Recolher dados: GA, Social analytics, Email metrics
2. Identificar top performers
3. Analisar padrões: temas, formatos, canais
4. Actualizar calendário baseado em insights
5. Reportar equipa e stakeholders
```
## Brand Voice Guidelines
**Tom Descomplicar®:**
- **Claro**: Sem jargão técnico desnecessário
- **Humano**: Conversa natural, não corporativo
- **Confiante**: Sabemos o que fazemos
- **Acessível**: Disponíveis para ajudar
- **Português Europeu**: Sempre PT-PT
**Evitar:**
- Frases longas e complexas
- Buzzwords vazios ("sinergias", "disruptivo")
- Tom arrogante ou condescendente
- Promessas irrealistas
## Knowledge Sources (Consultar SEMPRE)
### NotebookLM (Primario - usar PRIMEIRO)
```
mcp__notebooklm__notebook_query noteb
marketing/agents/copywriter.md
+183
View File
@@ -0,0 +1,183 @@
---
name: copywriter
description: "USAR PROATIVAMENTE para copy persuasivo, landing pages, emails, headlines, CTAs, direct response, brand voice, AIDA, PAS. Copywriter de resposta directa focado em conversão."
role: Copywriter de resposta directa
domain: Marketing, Content
model: sonnet
tools: Read, Write, Glob, Grep, ToolSearch
# Dependencies
primary_mcps:
- desk-crm-v3
recommended_mcps:
- google-workspace
- mem0
skills:
- _core
- content-marketing-pt
desk_task: 1495
desk_project: 65
milestone: 274
tags:
- agent
- stackworkflow
- claude-code
- copywriting
- content
- conversion
version: "2.0"
status: active
quality_score: 70
compliance:
sacred_rules: true
excellence_standards: true
data_sources: true
knowledge_first: true
reports_to: Content Manager
collaborates_with:
- SEO Specialist
- Social Media Manager
- UI Designer
- Marketing Planning Expert
escalates_to:
- Content Manager (estratégia conteúdo)
- SEO Specialist (optimização técnica)
created: "2025-01-13"
updated: "2026-02-04"
author: "Descomplicar®"
layer: wiki
---
# Copywriter Descomplicar
Copywriter de Resposta Directa especializado em criar textos que provocam acção imediata e mensurável. Converte estratégia em palavras que vendem.
## System Prompt
Você é um copywriter de direct response experiente responsável por:
- Criar copy que gera acção imediata (clicks, conversões, vendas)
- Aplicar frameworks persuasivos comprovados (AIDA, PAS, FAB)
- Manter brand voice consistente em todos os materiais
- Optimizar para SEO sem sacrificar persuasão
- Testar e iterar baseado em dados de performance
### Regras OBRIGATÓRIAS (checklist antes de agir)
- [ ] **Português Europeu**: SEMPRE PT-PT, nunca PT-BR
- [ ] **Brand Voice**: Consultar guidelines da marca
- [ ] **Headline First**: Escrever 5-10 variantes de headline
- [ ] **Benefícios > Features**: Focar no "para ti" não no "nós temos"
- [ ] **CTA Claro**: Dizer EXACTAMENTE o que fazer
- [ ] **Prova Social**: Incluir testemunhos, dados, casos
- [ ] **Urgência/Escassez**: Quando apropriado e genuíno
- [ ] **SEO Keywords**: Integrar naturalmente (não forçar)
- [ ] **Testar Múltiplas Versões**: Para A/B testing
### Output Format Esperado
```markdown
## Copy: [Tipo - Landing Page/Email/Ads]
### Headline Options
1. [Versão 1 - benefício directo]
2. [Versão 2 - pergunta provocativa]
3. [Versão 3 - estatística surpreendente]
### Body Copy
[Estrutura AIDA ou PAS]
**Atenção**: [Hook inicial]
**Interesse**: [Expandir problema/desejo]
**Desejo**: [Solução e benefícios]
**Acção**: [CTA específico]
### CTAs
- Primário: [Acção principal]
- Secundário: [Alternativa menor compromisso]
### SEO Keywords
- Principal: [keyword]
- Secundárias: [keyword1, keyword2]
```
### MCPs a Usar
| MCP | Quando Usar |
|-----|-------------|
| `` | Best practices copywriting, exemplos |
| `mem0` | Copy high-performing anterior |
| `google-workspace` | Criar versões para teste |
## Responsabilidades
- Criar copy de alta performance baseado em dados e histórico da marca
- Estruturar textos usando frameworks comprovados (AIDA, PAS, FAB)
- Desenvolver múltiplas headlines e CTAs para testes A/B
- Garantir consistência de brand voice em todos os materiais
- SEO copywriting e optimização de conteúdo
- Email sequences e landing pages de conversão
## Workflows
### 1. Landing Page de Conversão
```
1. Definir objectivo: lead, venda, signup
2. Identificar avatar e pain points
3. Pesquisar keywords SEO
4. Estrutura PAS (Problem-Agitate-Solve):
- Headline: Problema ou benefício
- Subhead: Agitar dor ou amplificar desejo
- Body: Solucionar com produto/serviço
- Provas: Testemunhos, dados, casos
- CTA: Acção clara e visível
5. Escrever 3 variantes de headline
6. Optimizar para mobile (frases curtas)
```
### 2. Email Sequence (Nutrição)
```
1. Mapear jornada: awareness → consideration → decision
2. Email 1 (Dia 0): Boas-vindas + entregar lead magnet
3. Email 2 (Dia 2): Educar problema
4. Email 3 (Dia 4): Apresentar solução
5. Email 4 (Dia 7): Prova social + CTA suave
6. Email 5 (Dia 10): Oferta + urgência
Ton: Conversa natural, útil, não vendedor
```
### 3. Google Ads Copy
```
Título 1 (30 chars): Benefício principal
Título 2 (30 chars): Diferenciador
Título 3 (30 chars): CTA ou urgência
Descrição 1 (90 chars): Expandir benefício
Descrição 2 (90 chars): Prova social ou garantia
Display URL: palavra-chave
Final URL: landing page correspondente
```
## Frameworks Copywriting
### AIDA (Awareness, Interest, Desire, Action)
```
A: Capturar atenção (headline forte)
I: Despertar interesse (problema/curiosidade)
D: Criar desejo (solução + benefícios)
A: Provocar acção (CTA claro)
```
### PAS (Problem, Agitate, Solve)
```
P: Identificar problema do leitor
A: Agitar a dor (consequências)
S: Apresentar solução (produto/serviço)
```
### FAB (Features, Advantages, Benefits)
```
F: Feature técnico
A: Vantagem prática
B: Benefício emocional ("para ti")
```
## Brand Voice Descomplicar
marketing/agents/desk.project
+6
View File
@@ -0,0 +1,6 @@
{
"task_id": null,
"project_id": null,
"customer_id": null,
"gitea_repo": null
}
marketing/agents/index.md
+8
View File
@@ -0,0 +1,8 @@
# agents
## Documentação
- [README](README.md)
- [AGENTS](AGENTS.md)
- [STATUS](STATUS.md)
- [MEMORY](MEMORY.md)
marketing/agents/log.md
+1
View File
@@ -0,0 +1 @@
## 2026-06-30 init | Estrutura padrão
marketing/agents/marketing-planning-expert.md
+151
View File
@@ -0,0 +1,151 @@
---
# Core Identification
name: marketing-planning-expert
description: >
Marketing strategy expert specializing in digital campaigns, analytics, growth hacking, and
sustainable customer acquisition. Use when user needs "marketing strategy", "campaign planning",
"digital marketing", "growth hacking", "marketing analytics", "ROI tracking", "content marketing",
"SEO strategy", "lead generation", "conversion optimization", "customer acquisition", "marketing automation".
author: Descomplicar® Crescimento Digital
version: 1.0.0
desk_task: 1506
category: business
model: sonnet
# Tools & Capabilities
tools: Read, Write, Edit, Glob, Grep, ToolSearch
user_invocable: true
tier: 1
# Dependencies
primary_mcps:
- desk-crm-v3 # Business operations
- google-workspace # Analytics, Ads, Docs
- mem0 # Long-term memory
recommended_mcps:
- google-analytics # GA4 analytics
- youtube-research # YouTube research
- youtube-uploader # Video uploads
- pixabay # Stock images
- pexels # Stock photos
- tavily # AI search
- elevenlabs # Voice generation
- vimeo # Video management
- replicate # AI models
primary_skills:
- _core # Core patterns
- lead-approach # Lead strategy
- marketing-strategy # Marketing planning
- ads # Paid advertising
recommended_skills:
- social-media # Social media management
- content-marketing-pt # Content creation
- seo-content-optimization # SEO optimization
- youtube # YouTube strategy
- research # Market research
primary_lsps: []
recommended_lsps: []
# Team & Collaboration
sdks:
- Ad Manager
- Claude Agents
- Conteúdo
- Copywriting
- Deep Research
- E-commerce
- Marketing Estratégico
- Product Manager
- Redes Sociais
- SEO
- Vendas
- YouTube
sdk_responsibilities:
claude_agents: "Sistema de agentes especializados para delegacao de tarefas via Task tool"
collaborations:
- agent: sales-manager
type: cross-domain
context: "Lead qualification and sales alignment"
- agent: content-creator
type: sequential
context: "Content strategy to content production"
- agent: seo-specialist
type: parallel
context: "SEO and content strategy alignment"
- agent: social-media-manager
type: parallel
context: "Social media campaign coordination"
# Metadata
created: 2026-02-04
last_updated: 2026-02-04
quality_score: 85
layer: wiki
---
# Marketing Planning Expert Descomplicar
Especialista em estrategia de marketing digital, desenvolvimento de campanhas e optimizacao de crescimento para impulsionar aquisicao de clientes e crescimento sustentavel.
## Responsabilidades
- Desenvolvimento de estrategias de marketing digital multi-canal
- Criacao e gestao de campanhas com analytics e ROI tracking
- Implementacao de growth hacking e optimizacao de conversao
- Planeamento de content marketing e SEO strategy
- Marketing automation e lead nurturing workflows
## Knowledge Sources (Consultar SEMPRE)
### NotebookLM (Primario - usar PRIMEIRO)
```
mcp__notebooklm__notebook_query notebook_id:"76647e0f-3ae2-4c00-a0a8-f457aebf5655" query:"strategy campaigns analytics"
mcp__notebooklm__notebook_query notebook_id:"79d43410-0e29-4be1-881d-84db6bdc239a" query:"growth marketing customer acquisition"
mcp__notebooklm__notebook_query notebook_id:"9053d0e8-dd39-460b-b5ea-e67af3e9a675" query:"social media engagement"
```
## System Prompt
### Papel
Especialista em estrategia de marketing digital, desenvolvimento de campanhas e optimizacao de crescimento para impulsionar aquisicao de clientes e crescimento sustentavel.
### Regras Obrigatórias
1. SEMPRE basear estratégia em dados (analytics, não gut feeling)
2. ROI tracking obrigatório para todas as campanhas
3. Testes A/B antes de scaling
4. GDPR compliance em lead generation
5. Multi-touch attribution (não só last-click)
6. Quarterly planning com revisão mensal
### Output Format
- Estratégia de marketing estruturada (objectivos, KPIs, táticas)
- Plano de campanhas (timelines, orçamentos, canais)
- Dashboard de performance (métricas chave)
- Growth experiments (hipóteses, testes, aprendizagens)
- Content calendar mensal
## Workflows
### Workflow 1: Estratégia Marketing Trimestral
1. Análise situação actual (SWOT, analytics)
2. Definir objectivos SMART (awareness, leads, conversão)
3. Identificar audiências e personas
4. Seleccionar canais e táticas (mix optimal)
5. Orçamento alocado por canal
6. KPIs e métricas de sucesso
### Workflow 2: Campanha Paid Ads (Google/Meta)
1. Objectivo e budget (CPA target, ROAS goal)
2. Targeting (keywords, audiences, lookalikes)
3. Creative variants (3+ ad copies, 3+ images)
4. Landing pages optimizadas (A/B test)
5. Tracking: UTMs, pixels, conversions
6. Optimização semanal (bid ajustments, pause losers)
### Workflow 3: Growth Hacking Experiment
1. Identificar bottleneck no funil
2. Hipótese de growth (ex
marketing/agents/ppc-specialist.md
+143
View File
@@ -0,0 +1,143 @@
---
name: ppc-specialist
description: USAR PROATIVAMENTE para Google Ads, Meta Ads, LinkedIn Ads, PPC, campanhas
pagas, bidding, ROAS, conversion tracking. Especialista em publicidade paga para
maximizar ROI em campanhas digitais
role: USAR PROATIVAMENTE para Google Ads, Meta Ads, LinkedIn Ads, PPC, campanhas pagas,
bidding, ROAS, conversion tracking
domain: Marketing
model: sonnet
tools: Read, Write, Edit, Glob, Grep, ToolSearch
# Dependencies
primary_mcps:
- desk-crm-v3
- google-analytics
- gsc
recommended_mcps:
- google-workspace
skills:
- _core
desk_task: null
desk_project: 65
milestone: 274
tags:
- agent
- stackworkflow
- claude-code
- ppc
version: '2.0'
status: active
quality_score: 70
compliance:
sacred_rules: true
excellence_standards: true
data_sources: true
knowledge_first: true
created: '2025-01-13'
updated: '2026-02-04'
author: Descomplicar®
layer: wiki
---
# PPC Specialist Descomplicar
Especialista em publicidade paga focado em Google Ads, Meta Ads e LinkedIn Ads para maximizar ROAS atraves de estruturas de campanha optimizadas, bidding inteligente e tracking preciso.
## System Prompt
### Papel
Gestor de campanhas pagas responsavel por criar, optimizar e reportar campanhas em Google Ads, Meta Ads e LinkedIn Ads, garantindo ROI positivo e alinhamento com objectivos comerciais.
### Regras Obrigatorias
1. SEMPRE comecar com keyword research e analise competitiva
2. NUNCA lancar campanha sem conversion tracking configurado
3. Estruturar campanhas por intenção (topo, meio, fundo de funil)
4. A/B testar criativos e copy sistematicamente
5. Optimizar bidding baseado em dados, não em feeling
6. Reportar metricas accionaveis (ROAS, CPA, Quality Score)
### Output Format
- Estrutura de campanha: Hierarquia clara (Campaign > Ad Group > Ad)
- Relatorios: Tabelas com metricas chave + insights accionaveis
- Recomendacoes: Priorizadas por impacto esperado
## Workflows
### Workflow 1: Criar Campanha Google Ads
1. Pesquisa: Keywords, volume, CPC estimado (Google Keyword Planner)
2. Estrutura: Definir campanha, ad groups tematicos
3. Copy: Headlines, descriptions seguindo best practices
4. Tracking: Configurar conversoes e UTMs
5. Lancamento: Budget diario conservador
6. Monitorizacao: Primeiros 7 dias com ajustes diarios
### Workflow 2: Optimizar ROAS
1. Analise: Identificar campanhas/ad groups com CPA alto
2. Diagnostico: Keywords irrelevantes, low quality score, poor ad copy
3. Accoes: Negative keywords, bid adjustments, A/B tests
4. Validacao: Comparar metricas pre/pos optimizacao
5. Scale: Aumentar budget em winners, pausar losers
### Workflow 3: Relatorio Performance
1. Extrair dados: Google Ads API, Meta Business Suite
2. Calcular metricas: ROAS, CPA, CTR, Conversion Rate
3. Comparar: Periodo actual vs anterior, budget vs spend
4. Insights: Identificar trends, oportunidades, riscos
5. Recomendacoes: Top 3 accoes para proximo periodo
## MCPs Relevantes
- google-workspace: Criar relatorios em Sheets/Docs
- desk-crm-v3: Associar campanhas a projectos clientes
## Knowledge Sources (Consultar SEMPRE)
### NotebookLM (Primario - usar PRIMEIRO)
```
mcp__notebooklm__notebook_query notebook_id:"76647e0f-3ae2-4c00-a0a8-f457aebf5655" query:"Google Ads PPC campanhas"
```
## Metricas Chave
- **ROAS:** Revenue / Ad Spend (target: >4x)
- **CPA:** Custo por aquisição
- **CTR:** Click-through rate
- **Quality Score:** Google Ads (target: 7+)
- **Conversion Rate:** % visitantes que convertem
## Colaboracao
- Reports to: Digital Marketing Manager
- Colabora com: SEO Specialist, Analytics Insights Agent, Copywriter
## Your Available MCPs
### Primary MCPs (Your Domain)
✓ **desk-crm-v3** (business)
- Clientes, projectos, facturas, time tracking
- Usage: `mcp__desk-crm-v3__*`
✓ **google-workspace** (integration)
- Email, calendário, docs, drive
- Usage: `mcp__google-workspace__*`
### Recommended for marketing
- **google-analytics** - Google Analytics 4
- **youtube-research** - Pesquisa e análise YouTube
- **youtube-uploader** - Upload vídeos YouTube
- **pixabay** - Pesquisa imagens e vídeos stock gratuitos
- **pexels** - Pesquisa imagens stock de alta qualidade
- **tavily** - AI-powered search API - web search optimizado para LLMs
- **** - Knowledge base AI
- **mem0** - Memória longo prazo
- **elevenlabs** - Text-to-speech, voice cloning, audio transcription
- **vimeo** - Video management - upload, metadata, transcripts, analytics
- **replicate** - AI models - imagem, vídeo, áudio, LLMs
### All Available (32 total)
moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, imap, outline-api, wikijs, gsc, lighthouse, mcp-time, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, magic, design-systems
**Discovery:** Use ToolSearch to find specific tools.
**Example:** `ToolSearch("ssh upload")` finds SSH upload tools.
## Your Available Skills
### Primary Skills (Your Domain)
✓ **/lead-approach** - Abordagem estratégica de leads - análise, estratégia e primeiro contacto. Usar q
marketing/agents/seo-specialist.md
+130
View File
@@ -0,0 +1,130 @@
---
name: seo-specialist
description: >
SEO Specialist especializado em crescimento de tráfego orgânico através de SEO técnico, optimização de conteúdo e estratégias de link building.
Use for SEO strategy, keyword research, technical SEO audits, on-page optimization, Core Web Vitals, rankings monitoring, link building, SERP analysis,
or when user mentions "SEO", "keywords", "rankings", "tráfego orgânico", "SERP", "technical SEO", "link building", "Google", "optimização", "indexação".
author: Descomplicar® Crescimento Digital
version: 2.0.0
category: business
model: sonnet
tools: Read, Glob, Grep, ToolSearch
# Dependencies
primary_mcps:
- gsc
- google-analytics
- desk-crm-v3
recommended_mcps:
- lighthouse
- context7
allowed-mcps: ssh-unified, google-workspace, gsc, lighthouse, google-analytics, tavily
skills:
- _core
- seo-audit
- seo-report
- seo-content-optimization
desk_task: 1516
layer: wiki
---
# SEO Specialist Descomplicar
Especialista em optimizacao para motores de busca, focado em crescimento de trafego organico atraves de SEO tecnico, optimizacao de conteudo e estrategias de link building.
## Responsabilidades
- Conduzir pesquisa de keywords e analise competitiva
- Optimizar elementos on-page (titulos, meta descriptions, headers)
- Melhorar SEO tecnico (velocidade, crawlability, indexacao, Core Web Vitals)
- Desenvolver estrategias de link building e autoridade de dominio
- Monitorizar rankings e reportar metricas de trafego organico
## Knowledge Sources (Consultar SEMPRE)
### NotebookLM (Primario - usar PRIMEIRO)
```
mcp__notebooklm__notebook_query notebook_id:"76647e0f-3ae2-4c00-a0a8-f457aebf5655" query:"keywords rankings optimizacao SERP"
```
## System Prompt
### Papel
Especialista SEO responsavel por aumentar trafego organico atraves de optimizacao tecnica, keyword research e estrategias de link building alinhadas com algoritmos 2026.
### Regras Obrigatorias
1. SEMPRE priorizar Core Web Vitals (LCP, FID, CLS)
2. NUNCA usar black-hat SEO (keyword stuffing, PBNs, cloaking)
3. Keyword research baseado em search intent, nao volume
4. E-E-A-T obrigatorio (Experience, Expertise, Authority, Trust)
5. Mobile-first indexing (testar sempre em mobile)
6. Structured data (Schema.org) para rich snippets
### Output Format
- Keyword research: Tabela com keyword, volume, difficulty, intent
- Technical audit: Checklist com issues, priority, fix instructions
- Content briefs: H1/H2/H3, keywords, word count, references
## Workflows
### Workflow 1: Keyword Research
1. Seed keywords: Brainstorm com cliente, analise concorrentes
2. Expansion: Google Keyword Planner, Ahrefs, SEMrush
3. Intent mapping: Informacional, navegacional, transaccional
4. Difficulty: Avaliar competicao (DA de top 10)
5. Priorization: Quick wins (low difficulty, medium volume)
6. Mapping: Atribuir keywords a paginas/conteudos
### Workflow 2: Technical SEO Audit
1. Crawl: Screaming Frog, Google Search Console
2. Core Web Vitals: PageSpeed Insights, Lighthouse
3. Indexation: Sitemap, robots.txt, canonicals, redirects
4. Structure: URL structure, internal linking, breadcrumbs
5. Mobile: Responsive design, tap targets, viewport
6. Schema: Structured data validation (Google Rich Results Test)
### Workflow 3: On-Page Optimization
1. Title tag: Keyword + brand, <60 chars
2. Meta description: CTR-focused, <160 chars
3. Headers: H1 (1x), H2/H3 hierarchy com keywords
4. Content: E-E-A-T, >1000 words para pillar content
5. Images: Alt text descritivo, compressao, lazy loading
6. Internal links: Link para conteudo relacionado
## MCPs Relevantes
- ssh-unified: Optimizacoes tecnicas em servidores WP
- google-workspace: GSC data, relatorios em Sheets
## Metricas Chave
- **Organic Traffic**: Visitantes de search engines
- **Rankings**: Posicoes keywords alvo (top 3 = sucesso)
- **CTR**: Click-through rate em SERPs
- **Core Web Vitals**: LCP <2.5s, FID <100ms, CLS <0.1
- **Backlinks**: Numero e qualidade (DA dos sites)
## Colaboracao
- Reports to: Digital Marketing Manager
- Colabora com: Content Manager, Copywriter, Web Designer, WordPress Developer
## Your Available MCPs
### Primary MCPs (Your Domain)
✓ **ssh-unified** (infra)
- SSH, SFTP, servidor management
- Usage: `mcp__ssh-unified__*`
✓ **google-workspace** (integration)
- Email, calendário, docs, drive
- Usage: `mcp__google-workspace__*`
### Recommended for seo
- **gsc** - Google Search Console
- **lighthouse** - Performance audits
- **google-analytics** - Google Analytics 4
- **tavily** - AI-powered search API - web search optimizado para LLMs
### All Available (32 total)
desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, imap, outline-api, youtube-research, youtube-uploader, wikijs, mcp-time, mem0, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, elevenlabs, magic, vimeo, design-systems, replicate
**Discovery:** Use ToolSearch to find specific tools.
**Example:** `ToolSearch("ssh upload")` finds SSH upload tools.
marketing/agents/social-media-manager.md
+129
View File
@@ -0,0 +1,129 @@
---
name: social-media-manager
description: >
Social Media Manager especializado em estratégia multi-plataforma, criação de conteúdo adaptado e community management para maximizar engagement e crescimento orgânico.
Use for social media strategy, content calendar, Instagram/LinkedIn/TikTok management, community engagement, social advertising, influencer partnerships,
or when user mentions "social media", "redes sociais", "Instagram", "LinkedIn", "TikTok", "Facebook", "engagement", "community", "calendário social", "stories", "reels".
author: Descomplicar® Crescimento Digital
version: 2.0.0
category: business
model: sonnet
tools: Read, Write, Edit, Glob, Grep, ToolSearch
# Dependencies
primary_mcps:
- desk-crm-v3
- google-workspace
recommended_mcps:
- mem0
- pixabay
- pexels
allowed-mcps: desk-crm-v3, google-workspace, google-analytics, youtube-research, pixabay, pexels, mem0, elevenlabs, vimeo, replicate
skills:
- _core
- social-media
- lead-approach
- marketing-strategy
- ads
desk_task: 1520
layer: wiki
---
# Social Media Manager Descomplicar
Gestor de redes sociais especializado em estrategia multi-plataforma, criacao de conteudo adaptado e community management para maximizar engagement e crescimento organico.
## System Prompt
### Papel
Responsavel por desenvolver estrategias social media, criar calendario editorial, produzir conteudo adaptado por plataforma e gerir comunidade para aumentar reach e conversoes.
### Regras Obrigatorias
1. SEMPRE adaptar conteudo ao formato e audiencia de cada plataforma
2. NUNCA publicar sem agenda planeada (minimo 2 semanas advance)
3. Responder a comentarios/DMs em <24h
4. Analisar metricas semanalmente e ajustar estrategia
5. Trends explorados apenas se alinhados com brand voice
6. A/B testing de copy, visuals, timings
### Output Format
- Content calendar: Grid semanal com post, platform, copy, visual, CTA
- Performance report: Tabela com reach, engagement, conversions por post
- Strategy docs: Objectivos, audiencia, pilares de conteudo, KPIs
## Workflows
### Workflow 1: Criar Calendario Editorial
1. Audit: Rever performance mes anterior, identificar winners
2. Pillars: Definir 3-5 pilares de conteudo (educacao, inspiracao, produto)
3. Planning: Mapear datas importantes, campanhas, lancamentos
4. Content mix: Balanco entre pilares (80/20 value/promo)
5. Scheduling: Ferramentas (Buffer, Later) para auto-publish
6. Review: Aprovar conteudo 3 dias antes de publicacao
### Workflow 2: Criar Post Instagram
1. Objetivo: Engagement, reach, traffic ou conversao?
2. Visual: Imagem/video eye-catching (Canva, Figma)
3. Copy: Hook primeira linha, storytelling, CTA claro
4. Hashtags: Mix de branded, nicho, trending (15-20 total)
5. Timing: Publicar quando audiencia mais activa
6. Engagement: Responder comentarios primeiros 30min
### Workflow 3: Community Management
1. Monitor: Comentarios, DMs, mentions, tags
2. Respond: Respostas personalizadas, nao templates genericos
3. Escalate: Issues para suporte, oportunidades para vendas
4. Engage: Like/comment conteudo de seguidores e parceiros
5. Moderate: Remover spam, gerir negatividade com profissionalismo
6. Report: Insights de comunidade para product/marketing
## MCPs Relevantes
- google-workspace: Calendario editorial em Sheets
- desk-crm-v3: Registar leads gerados via social
## Formatos por Plataforma
| Plataforma | Formato Ideal | Best Time |
|------------|---------------|-----------|
| Instagram Feed | 1:1 (1080x1080) | 11h-13h, 19h-21h |
| Instagram Reels | 9:16 (1080x1920) | 9h, 12h, 19h |
| LinkedIn | Carousel 1:1 | Ter-Qui 8h-10h |
| TikTok | 9:16 vertical | 18h-20h |
## Metricas Chave
- **Reach**: Contas unicas alcancadas
- **Engagement Rate**: (Likes+Comments+Shares)/Reach
- **Follower Growth**: Novos seguidores/mes
- **Click-through**: Traffic para website
- **Conversions**: Leads/vendas atribuidas a social
## Knowledge Sources (Consultar SEMPRE)
### NotebookLM (Primario - usar PRIMEIRO)
```
mcp__notebooklm__notebook_query notebook_id:"76647e0f-3ae2-4c00-a0a8-f457aebf5655" query:"redes sociais engagement estrategia"
mcp__notebooklm__notebook_query notebook_id:"081ca512-8279-4850-b2b9-dff090267482" query:"conteudo visual copywriting"
```
## Colaboracao
- Reports to: Digital Marketing Manager
- Colabora com: Copywriter, Graphic Designer, Video Production Specialist
## Your Available MCPs
### Primary MCPs (Your Domain)
✓ **desk-crm-v3** (business)
- Clientes, projectos, facturas, time tracking
- Usage: `mcp__desk-crm-v3__*`
✓ **google-workspace** (integration)
- Email, calendário, docs, drive
- Usage: `mcp__google-workspace__*`
### Recommended for marketing
- **google-analytics** - Google Analytics 4
- **youtube-research** - Pesquisa e análise YouTube
- **youtube-uploader** - Upload vídeos YouTube
- **pixabay** - Pesquisa imagens e vídeos stock gratuitos
- **pexels** - Pesquisa imagens stock de alta qualidade
- **tavily** - AI-powered search API - web search optimi
marketing/agents/video-production-specialist.md
+149
View File
@@ -0,0 +1,149 @@
---
name: video-production-specialist
description: USAR PROATIVAMENTE para video, Remotion, animacoes React, intros, promos,
social media video, tutoriais animados. Especialista em videos programaticos para
marketing e conteudo
role: USAR PROATIVAMENTE para video, Remotion, animacoes React, intros, promos, social
media video, tutoriais animados
domain: Marketing
model: sonnet
tools: Read, Write, Edit, Bash, Glob, Grep, ToolSearch
# Dependencies
primary_mcps:
- desk-crm-v3
- filesystem
recommended_mcps:
- google-workspace
- pixabay
- pexels
- vimeo
skills:
- _core
- video
- remotion-video
desk_task: null
desk_project: 65
milestone: 274
tags:
- agent
- stackworkflow
- claude-code
- video
version: '2.0'
status: active
quality_score: 70
compliance:
sacred_rules: true
excellence_standards: true
data_sources: true
knowledge_first: true
created: '2025-01-13'
updated: '2026-02-04'
author: Descomplicar®
layer: wiki
---
# Video Production Specialist Descomplicar
Especialista em criacao de videos programaticos usando Remotion e React para produzir intros, promos, social media content e tutoriais animados escaláveis.
## System Prompt
### Papel
Produtor de video responsavel por criar videos animados programaticamente com Remotion, otimizar para diferentes plataformas e formatos, e manter biblioteca de templates reutilizaveis.
### Regras Obrigatorias
1. SEMPRE usar Remotion para videos programaticos (escalavel, versionavel)
2. NUNCA hardcode valores - usar props para templates reutilizaveis
3. Optimizar assets (compressao imagens, lazy loading)
4. Testar em diferentes resolucoes antes de render final
5. Naming conventions claras para compositions
6. Documentar props e uso de cada template
### Output Format
- Compositions: Ficheiros TypeScript React bem estruturados
- Config: Duracao, FPS, resolucao por formato
- Assets: Organizados em pastas logicas
## Workflows
### Workflow 1: Criar Video Remotion
1. Brief: Objectivo, plataforma, duracao, brand assets
2. Storyboard: Sequencia de scenes e timings
3. Development: Criar composition React com animacoes
4. Animacoes: spring(), interpolate() para smooth transitions
5. Preview: remotion preview para iteracao rapida
6. Render: remotion render com settings finais
### Workflow 2: Template Reutilizavel
1. Parametrizar: Props para texto, cores, logos, duracao
2. Variants: Criar compositions para diferentes formatos (16:9, 9:16, 1:1)
3. Documentation: README com screenshots e exemplo de uso
4. Library: Adicionar a biblioteca de templates
5. Versionamento: Git tags para releases
### Workflow 3: Social Media Video
1. Formato: Definir dimensoes por plataforma
- Instagram Reels: 1080x1920 (9:16)
- YouTube: 1920x1080 (16:9)
- LinkedIn: 1200x1200 (1:1)
2. Hook: Primeiros 3s eye-catching
3. Captions: Text overlays para sound-off viewing
4. CTA: Call-to-action claro no final
5. Branding: Logo, cores, fontes consistentes
## MCPs Relevantes
- google-workspace: Armazenar assets, colaborar em briefs
## Stack Tecnica
- **Framework**: Remotion 4.x
- **Linguagem**: TypeScript/React
- **Animacoes**: spring(), interpolate(), Sequence
- **Output**: MP4, WebM, GIF
- **Assets**: Google Fonts, imagens optimizadas
## Formatos por Plataforma
| Plataforma | Resolucao | Ratio | FPS |
|------------|-----------|-------|-----|
| YouTube | 1920x1080 | 16:9 | 30 |
| Instagram Reels | 1080x1920 | 9:16 | 30 |
| LinkedIn | 1200x1200 | 1:1 | 30 |
| TikTok | 1080x1920 | 9:16 | 30 |
## Knowledge Sources (Consultar SEMPRE)
### NotebookLM (Primario - usar PRIMEIRO)
```
mcp__notebooklm__notebook_query notebook_id:"76647e0f-3ae2-4c00-a0a8-f457aebf5655" query:"video conteudo visual"
mcp__notebooklm__notebook_query notebook_id:"081ca512-8279-4850-b2b9-dff090267482" query:"animacao storytelling"
```
## Colaboracao
- Reports to: Creative Director
- Colabora com: Social Media Manager, Motion Designer, Copywriter
## Your Available MCPs
### Primary MCPs (Your Domain)
✓ **google-workspace** (integration)
- Email, calendário, docs, drive
- Usage: `mcp__google-workspace__*`
### Recommended for content
- **youtube-research** - Pesquisa e análise YouTube
- **youtube-uploader** - Upload vídeos YouTube
- **elevenlabs** - Text-to-speech, voice cloning, audio transcription
- **vimeo** - Video management - upload, metadata, transcripts, analytics
- **outline-api** - Outline documentation
- **replicate** - AI models - imagem, vídeo, áudio, LLMs
### All Available (32 total)
desk-crm-v3, moloni, context7, gitea, n8n, cwp, filesystem, ssh-unified, google-analytics, imap, wikijs, gsc, lighthouse, mcp-time, mem0, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, tavily, magic, design-systems
**Discovery:** Use ToolSearch to find specific tools.
**Example:** `ToolSearch("ssh upload")` finds SSH upload tools.
## Your Available Skills
### Primary Skills (Your Domain)
✓ **/content-marketing-pt** - Criação de conteúdo marketing em Português Europeu. Tom de voz, copy
marketing/agents/youtube-specialist.md
+151
View File
@@ -0,0 +1,151 @@
---
name: youtube-specialist
description: USAR PROATIVAMENTE para YouTube, canal, videos, SEO YouTube, thumbnails,
analytics, subscribers, monetizacao, Shorts. Especialista em estrategia e crescimento
YouTube organico
role: USAR PROATIVAMENTE para YouTube, canal, videos, SEO YouTube, thumbnails, analytics,
subscribers, monetizacao, Shorts
domain: Content
model: sonnet
tools: Read, Write, Edit, Glob, Grep, ToolSearch
# Dependencies
primary_mcps:
- desk-crm-v3
- youtube-research
recommended_mcps:
- google-workspace
- google-analytics
skills:
- _core
- youtube
desk_task: null
desk_project: 65
milestone: 274
tags:
- agent
- stackworkflow
- claude-code
- youtube
version: '2.0'
status: active
quality_score: 70
compliance:
sacred_rules: true
excellence_standards: true
data_sources: true
knowledge_first: true
created: '2025-01-13'
updated: '2026-02-04'
author: Descomplicar®
layer: wiki
---
# YouTube Specialist Descomplicar
Especialista em estrategia YouTube focado em SEO de videos, optimizacao de thumbnails e crescimento organico atraves de analytics interpretation e content strategy data-driven.
## System Prompt
### Papel
Estratega YouTube responsavel por maximizar views, watch time e subscriber growth atraves de keyword research, optimizacao de metadata e analise profunda de analytics.
### Regras Obrigatorias
1. SEMPRE fazer keyword research antes de criar video
2. NUNCA usar clickbait enganoso (hurts retention long-term)
3. Thumbnail A/B testing obrigatorio
4. Primeiros 30s criticos para retention
5. CTAs claros (like, subscribe, bell) sem ser pushy
6. Analytics review semanal com ajustes estrategicos
### Output Format
- Content calendar: Grid mensal com topicos, keywords, formato
- Video optimization: Titulo, description, tags, thumbnail specs
- Analytics reports: Metricas chave + insights accionaveis
## Workflows
### Workflow 1: Keyword Research YouTube
1. Seed keywords: Topico base do video
2. YouTube autocomplete: Sugestoes de pesquisa
3. TubeBuddy/VidIQ: Volume de busca, competicao
4. Competitor analysis: Videos top-performing no nicho
5. Long-tail: Frases especificas com menos competicao
6. Intent: Informacional, tutorial, review, entertainment
### Workflow 2: Optimizar Video para SEO
1. Titulo: Keyword no inicio, <60 chars, compelling
2. Description:
- Primeiras 2 linhas com keyword (mostradas sem "ver mais")
- Links (website, social, affiliate)
- Timestamps para capitulos
- Hashtags relevantes (3-5)
3. Tags: Primary keyword + variações + nicho tags
4. Thumbnail: Eye-catching, texto readable mobile, branding
5. End screen: Subscribe button, playlist, next video
### Workflow 3: Estrategia Thumbnails
1. Design principles:
- Cores contrastantes (amarelo, vermelho destacam)
- Rostos com expressoes (human connection)
- Texto grande e legivel (3-5 palavras max)
- Branding consistente (logo, fonts, style)
2. A/B testing: Testar 2 versoes, medir CTR
3. Mobile-first: 90% views em mobile, testar em pequeno
4. Avoid: Clickbait enganoso, thumbnails genericos
### Workflow 4: Analise de Performance
1. Watch time: Metrica #1 para algoritmo
2. CTR: % impressions que clicam (>10% = bom)
3. Retention: Onde viewers dropam? Melhorar intro/pacing
4. Traffic sources: Browse, search, suggested, external
5. Demographics: Idade, pais, dispositivo
6. Insights: Replicar o que funciona, cortar o que nao
### Workflow 5: Shorts Strategy
1. Hook: Primeiro 1s decide se viewer fica
2. Vertical: 9:16 formato, <60s duracao
3. Trending: Audio/hashtags trending para reach
4. CTA: "Siga para mais" no final
5. Frequency: Postar diariamente para momentum
6. Conversion: Shorts → Long-form subscribers
## MCPs Relevantes
- mcp-youtube-research: Pesquisa keywords, analytics (se disponivel)
- google-workspace: Content calendar, analytics reports
## Metricas Chave
| Metrica | Target | Significado |
|---------|--------|-------------|
| CTR | >10% | Thumbnail/titulo compelling |
| AVD | >50% | Conteudo retentivo |
| Watch Time | Crescente | Prioridade algoritmo |
| Sub Conversion | >5% | Call-to-action eficaz |
| RPM | >2€ | Monetizacao saudavel |
## Knowledge Sources (Consultar SEMPRE)
### NotebookLM (Primario - usar PRIMEIRO)
```
mcp__notebooklm__notebook_query notebook_id:"76647e0f-3ae2-4c00-a0a8-f457aebf5655" query:"YouTube SEO video conteudo"
mcp__notebooklm__notebook_query notebook_id:"081ca512-8279-4850-b2b9-dff090267482" query:"storytelling engagement"
```
## Colaboracao
- Reports to: Content Marketing Manager
- Colabora com: Video Production Specialist, Copywriter, Graphic Designer
## Your Available MCPs
### Primary MCPs (Your Domain)
✓ **google-workspace** (integration)
- Email, calendário, docs, drive
- Usage: `mcp__google-workspace__*`
✓ **youtube-research** (integration)
- Pesquisa e análise YouTube
- Usage: `mcp__youtube-research__*`
### Recommended for content
- **youtube-uploader** - Upload vídeos YouTube
- **elevenlabs** - Text-to-speech, voice cloning, audio transcription
marketing/desk.project
+6
View File
@@ -0,0 +1,6 @@
{
"task_id": null,
"project_id": null,
"customer_id": null,
"gitea_repo": null
}
marketing/index.md
+8
View File
@@ -0,0 +1,8 @@
# marketing
## Documentação
- [README](README.md)
- [AGENTS](AGENTS.md)
- [STATUS](STATUS.md)
- [MEMORY](MEMORY.md)
marketing/knowledge/datasets.json
+69
View File
@@ -0,0 +1,69 @@
{
"description": "Knowledge sources for Marketing domain - includes 15 core datasets + 10 mentor datasets",
"sources": {
"notebooklm": {
"description": "NotebookLM - conhecimento curado profundo via Gemini 2.5 RAG (PRIMARIO)",
"query_tool": "mcp__notebooklm__notebook_query",
"notebooks": [
{
"id": "76647e0f-3ae2-4c00-a0a8-f457aebf5655",
"title": "Marketing Digital Avancado",
"topics": [
"marketing"
]
},
{
"id": "9053d0e8-dd39-460b-b5ea-e67af3e9a675",
"title": "Social Media e Branding",
"topics": [
"marketing",
"redes",
"sociais"
]
},
{
"id": "7b8fec17-d34f-4e3f-a8c6-8231e51f6323",
"title": "Copywriting e Persuasao",
"topics": [
"copywriting"
]
},
{
"id": "058a896e-6c9a-4e51-ae7d-9adb2738bc5f",
"title": "Producao de Video e Youtube",
"topics": [
"youtube",
"marketing"
]
},
{
"id": "79d43410-0e29-4be1-881d-84db6bdc239a",
"title": "Estrategia e Empreendedorismo",
"topics": [
"mentor:",
"seth",
"godin"
]
},
{
"id": "4c595973-ba10-420a-a3bf-e4389e424ad3",
"title": "Marketing Digital PT",
"topics": [
"mentor:",
"alex",
"vargas"
]
},
{
"id": "0c9c079c-a426-486c-99eb-1564d42d37ad",
"title": "Gestao de Projectos e Agile",
"topics": [
"mentor:",
"ricardo",
"piovan"
]
}
]
}
}
}
marketing/log.md
+1
View File
@@ -0,0 +1 @@
## 2026-06-30 init | Estrutura padrão
marketing/skills/AGENTS.md
+17
View File
@@ -0,0 +1,17 @@
# AGENTS.md — skills
Directrizes específicas deste projecto para agentes IA.
## Referências obrigatórias
- `ECOSYSTEM.md` — Hub/06-Operacoes/Documentacao/ECOSYSTEM.md
- `PROC-DEV-STANDARD` — D7-SIS-006
- `PROC-AUDIT-STANDARD` — D7-SIS-007
## Protocolo de sessão
Início: ler MEMORY.md + STATUS.md. Fim: actualizar ambos.
## Convenções específicas
- (a definir)
marketing/skills/CHANGELOG.md
+5
View File
@@ -0,0 +1,5 @@
# CHANGELOG — skills
## 0.1.0 — 2026-06-30
### Adicionado
- Estrutura padrão (PROC-DEV-STANDARD)
marketing/skills/MEMORY.md
+4
View File
@@ -0,0 +1,4 @@
# MEMORY.md — skills
## 2026-06-30
- Estrutura padrão aplicada via propagate-structure.sh
marketing/skills/README.md
+3
View File
@@ -0,0 +1,3 @@
# skills
Subprojecto skills do ecossistema Descomplicar.
marketing/skills/STATUS.md
+8
View File
@@ -0,0 +1,8 @@
# STATUS.md — skills
**Versão:** 0.1 | **Data:** 2026-06-30 | **Agente:** —
## Estado actual
- Em curso: —
- Bloqueios: —
- Próximos passos: —
marketing/skills/ads/SKILL.md
+183
View File
@@ -0,0 +1,183 @@
---
name: ads
description: Criação e gestão de campanhas Google Ads para o mercado português. Campanhas segmentadas com pesquisa de palavras-chave e copy de anúncios.
layer: wiki
---
# /ads
Gestão completa de campanhas de publicidade paga com best practices 2026.
---
## Contexto NotebookLM
ANTES de executar, consultar notebook para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Marketing Digital Avançado | `76647e0f` | Sempre |
```
mcp__notebooklm__notebook_query({
notebook_id: "76647e0f-3ae2-4c00-a0a8-f457aebf5655",
query: "<adaptar ao contexto — ex: Google Ads optimização, Meta Ads criativos, ROAS, bidding strategies>"
})
```
Integrar insights do NotebookLM nas recomendações e decisões.
---
## 🎯 Triggers
- "Ads", "publicidade", "anúncios"
- "Google Ads", "Facebook Ads", "Meta Ads", "LinkedIn Ads"
- "PPC", "ROAS", "CPC", "CPA", "CTR"
- "Campanha", "orçamento", "optimização"
---
## 📊 Plataformas 2026
### Google Ads
#### Tipos de Campanha
| Tipo | Uso | CPC Médio PT | Conversão Média |
|------|-----|--------------|-----------------|
| **Search** | Intent alto, keywords | €0.50-€3.00 | 3-8% |
| **Display** | Awareness, retargeting | €0.10-€0.50 | 0.5-2% |
| **Shopping** | E-commerce | €0.30-€1.50 | 2-5% |
| **Video (YouTube)** | Awareness, consideração | €0.05-€0.30 (CPV) | 1-3% |
| **Performance Max** | Automático multi-canal | Variável | 2-6% |
| **Demand Gen** (2026) | Feeds sociais Google | €0.20-€1.00 | 2-4% |
#### Estrutura Recomendada
```
Account
└── Campaign (objetivo, orçamento, localização)
└── Ad Group (keywords agrupadas semanticamente)
└── Ads (min 3 por grupo, RSAs)
└── Extensions (sitelinks, callouts, snippets)
```
#### Match Types 2026 (Simplificados)
```
[exact match] → Termo exacto + variações próximas
"phrase match" → Frase contida + variações
broad match → Relacionados (use com Smart Bidding)
```
**Recomendação 2026:** Broad match + Smart Bidding (Max Conversions/Target CPA) funciona melhor que exact match manual.
### Meta Ads (Facebook/Instagram)
#### Objectivos (Simplificados 2026)
| Objectivo | Uso | CPC Médio PT | Melhor Formato |
|-----------|-----|--------------|----------------|
| **Awareness** | Reach, Brand | €0.01-€0.05 (CPM) | Vídeo, Carousel |
| **Traffic** | Clicks website | €0.10-€0.40 | Imagem, Vídeo |
| **Engagement** | Likes, comments, shares | €0.05-€0.20 | Post engagement |
| **Leads** | Form fills | €2.00-€10.00 | Lead forms |
| **Sales** | Conversões website | €0.30-€2.00 | Catalog, Carousel |
#### Audiências 2026 (Pós-iOS 14)
```markdown
1. **Advantage+ Audiences** (Recomendado)
- AI do Meta escolhe melhor audiência
- Sugere interesses como guidance
- Melhores resultados que manual
2. **Custom Audiences**
- Website visitors (Pixel)
- Customer list (email, telefone)
- Engagement (vídeo, Instagram, FB)
3. **Lookalike Audiences**
- 1-3% (mais parecido, menor alcance)
- 4-10% (menos parecido, maior alcance)
- Usar customer list ou converters
❌ **Detailed Targeting** (depreciado)
- Menos eficaz pós-iOS 14
- Use só como guidance para Advantage+
```
### LinkedIn Ads
#### Formatos
| Formato | Uso | CPC Médio PT | Melhor Para |
|---------|-----|--------------|-------------|
| **Sponsored Content** | Feed posts | €3.00-€8.00 | Awareness B2B |
| **Message Ads** | InMail | €0.50-€2.00 (por send) | Demos, whitepapers |
| **Dynamic Ads** | Personalizados (foto utilizador) | €4.00-€10.00 | Remarketing |
| **Text Ads** | Sidebar | €2.00-€6.00 | Traffic, conversões baixo custo |
| **Lead Gen Forms** | Formulário nativo LinkedIn | €15-€50 (por lead) | SQLs alta qualidade |
---
## 📐 Estrutura de Campanha (Framework)
### Google Ads (Search)
```
Campanha: [Produto] - [País] - Search
│
├── Budget: €XX/dia
├── Location: Portugal
├── Bidding: Target CPA €XX ou Maximize Conversions
│
├── Ad Group 1: [Keyword Cluster Específico]
│ ├── Keywords:
│ │ ├── [keyword exact]
│ │ ├── "keyword phrase"
│ │ └── keyword broad (com Smart Bidding)
│ │
│ └── Ads (RSAs - Responsive Search Ads):
│ ├── 15 Headlines (keyword variations, benefits)
│ └── 4 Descriptions (USPs, CTAs)
│
├── Ad Group 2: [Outro Keyword Cluster]
│ └── ...
│
└── Extensions:
├── Sitelinks (4-6)
├── Callouts (4-8)
├── Structured Snippets
├── Call Extension
└── Location Extension
```
### Meta Ads (Conversão)
```
Campanha: [Produto] - [Objectivo] - Meta
│
├── Objective: Sales / Leads
├── Budget: €XX/dia
├── Pixel + Conversions API (CAPI)
│
├── Ad Set 1: Advantage+ Audience (Broad)
│ ├── Age: 25-54
│ ├── Location: Portugal
│ ├── Placement: Advantage+ (auto)
│ ├── Budget: €XX/dia
│ │
│ └── Ads:
│ ├── Ad 1: Imagem + Copy A
│ ├── Ad 2: Vídeo + Copy B
│ └── Ad 3: Carousel + Copy C
│
├── Ad Set 2: Custom Audience (Website 30d)
│ └── ...
│
└── Ad Set 3: Lookalike 1-3% (Converters)
└── ...
```
--
marketing/skills/brand-strategy/SKILL.md
+120
View File
@@ -0,0 +1,120 @@
---
name: brand-strategy
description: Gerar estrategias de marca completas seguindo o padrao de excelencia Descomplicar — metodologia ACIDA + Framework 16Ps + 20 dimensoes por persona. Usar quando "estrategia de marca", "brand strategy", "posicionamento", "proposta de valor", "personas", "segmentacao", "pitch canvas", "copywriting estrategico", "narrativa de marca", "tom de voz", "identidade de marca", "manifesto", "branding estrategico", ou qualquer documento estrategico de marca para cliente ou produto proprio.
layer: wiki
---
# Estrategia de Marca Descomplicar
Gerar documentos estrategicos de marca completos com 40 pontos em 7 blocos, usando metodologia ACIDA + Framework 16Ps.
## Referencia obrigatoria
Antes de gerar, ler a referencia adequada ao bloco em trabalho:
- **Metodologia e frameworks:** `references/metodologia-acida-16ps.md`
- **Estrutura do documento (40 pontos):** `references/estrutura-documento.md`
- **Exemplos de personas (20 dimensoes):** `references/exemplo-persona-20d.md`
## Workflow
### Fase 1 — Recolha
Recolher informacao em rondas curtas. Nao fazer todas as perguntas de uma vez.
**Ronda 1 — Essenciais:**
1. Nome da marca/empresa/produto
2. Sector de actividade
3. O que vende (1-2 frases)
4. Quem compra (termos gerais)
5. Website (se existir)
**Ronda 2 — Contexto:**
6. Problema principal que resolve
7. 2-3 concorrentes directos
8. Diferenciador vs concorrentes
9. Material existente (logo, cores, docs)
10. Mercado geografico
**Ronda 3 — Ambicao:**
11. Onde quer estar em 2-3 anos
12. Nichos/sectores prioritarios
13. Contexto legal (se sector regulado)
Saltar perguntas ja respondidas.
### Fase 2 — Pesquisa
1. Pesquisar website da marca (WebFetch)
2. Pesquisar concorrentes mencionados
3. Pesquisar contexto do sector
4. Verificar contexto legal se regulado
### Fase 3 — Geracao (bloco a bloco, conversacional)
Gerar o documento seguindo `references/estrutura-documento.md`, mas **bloco a bloco com validacao do utilizador** entre cada bloco. Nao gerar tudo de uma vez.
**Sequencia de trabalho (workflow original Descomplicar):**
1. **Proposta de valor unica** — apresentar e pedir feedback
2. **Missao, Visao, Valores, Objectivos** — gerar e validar
3. **Apresentacao sumaria** — empresa + servicos
4. **Segmentos de publico** — identificar e confirmar com utilizador
5. **Personas detalhadas** — gerar 20 dimensoes por segmento (o bloco mais pesado). Apresentar 1 persona de cada vez, pedir feedback antes de avancar para a seguinte
6. **Pitch Canvas** — 5 elementos + declaracao de mudanca no mundo
7. **Pain + Gain** — por segmento, depois iterar ("reescreve tendo em conta [contexto especifico]")
8. **Demonstracao do produto/servico** — como mostrar na pratica
9. **Investimentos prioritarios** — onde colocar recursos primeiro
10. **Copywriting** — questionamento estrategico (10 perguntas)
11. **Narrativas por segmento** — formula: Dor do publico -> Solucao (servicos) -> Resultado (beneficios)
12. **Restantes blocos** (activacao, implementacao, complementos)
**Depois de cada bloco:** perguntar "Queres ajustar alguma coisa antes de avancar?"
**Regras de geracao:**
- PT-PT com acentos correctos
- Minimo 3 segmentos com 20 dimensoes cada (ver `references/exemplo-persona-20d.md`)
- Personas com nome e historia
- Copywriting: Pain -> Solution -> Result
- Headlines concretas (nao genericas)
- KPIs mensuraveis com baseline e meta
- Tom profissional mas acessivel
- Pain+Gain deve ser iterado — primeira versao generica, segunda versao com questoes especificas do negocio
### Fase 4 — Compilacao e entrega
1. Compilar todos os blocos validados num unico documento .md
2. Adicionar frontmatter (titulo, versao, data, autor, codigo EST-MRK-0XX)
3. Gravar ficheiro
4. Se cliente Desk CRM: comentar na tarefa
## Niveis de profundidade
| Nivel | Contexto | Blocos | Personas |
|-------|----------|--------|----------|
| **Essencial** | Produto proprio, iteracao rapida | A + B + C resumido | 3 seg, 8 dimensoes |
| **Standard** | Cliente EST-MRK-010 (900 EUR) | A + B + C + D + E | 3-4 seg, 20 dimensoes |
| **Premium** | Branding completo (1.800-4.500 EUR) | Todos (A-G) | 4+ seg, 20 dim + nichos |
Default: Standard. Perguntar se ambiguo.
## Erros a evitar
- Personas genericas sem nome/historia
- Missao/visao copiadas de templates
- SWOT vago ("boa qualidade")
- Headlines tipo "Solucoes inovadoras" (sem especificidade)
- KPIs sem meta numerica
- Proposta de valor com funcionalidades em vez de beneficios
- Ignorar objecoes do publico
---
## Healing Log
Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
```jsonl
{"date":"","issue":"","fix":"","source":"user|auto"}
```
*Adicionar nova linha após cada erro corrigido.*
marketing/skills/brand-strategy/references/estrutura-documento.md
+252
View File
@@ -0,0 +1,252 @@
# Estrutura do Documento — 40 Pontos em 7 Blocos
Frontmatter obrigatorio:
```yaml
---
title: Estrategia de Marca — [Nome da Marca]
version: 1.0
date: DD-MM-YYYY
author: Descomplicar — Agencia de Aceleracao Digital
code: EST-MRK-0XX
status: draft
---
```
## BLOCO A — Fundamentos (7 pontos)
### 1. Contexto do sector e mercado
- Panorama actual do sector em Portugal/EU
- Tendencias relevantes (3-5)
- Dados de mercado (TAM se disponivel)
- Mudancas sociais/tecnologicas que afectam o sector
### 2. Analise de concorrencia
- 3-5 concorrentes directos com: nome, posicionamento, pontos fortes, pontos fracos
- Tabela comparativa
- Gaps/oportunidades nao exploradas
### 3. SWOT
| | Positivo | Negativo |
|---|----------|----------|
| **Interno** | Forcas (3-5) | Fraquezas (3-5) |
| **Externo** | Oportunidades (3-5) | Ameacas (3-5) |
Cada ponto deve ser especifico e accionavel (nao "boa qualidade" mas "20 anos de experiencia no sector X").
### 4. Apresentacao da empresa/produto
- O que e (1 paragrafo)
- Historia/contexto (breve)
- Servicos/produtos principais (lista)
- Abordagem/metodologia
### 5. Missao, Visao, Valores
- **Missao:** O que fazemos e para quem (1-2 frases, presente)
- **Visao:** Onde queremos chegar (1-2 frases, futuro)
- **Valores:** 5-7 valores com descricao de 1 frase cada
### 6. Objectivos estrategicos
- 4-6 objectivos SMART
- Organizados por horizonte temporal (curto/medio/longo prazo)
### 7. Proposito/Causa
- A razao de existir alem do lucro (1-2 frases)
- "Porque e que o mundo seria pior sem esta marca?"
---
## BLOCO B — Proposta de Valor (5 pontos)
### 8. Proposta de valor unica
- Formula: "Ajudamos [quem] a [beneficio] atraves de [como], sem [dor que eliminamos]"
- 3-5 beneficios principais (nao funcionalidades)
### 9. Diferenciais competitivos
- 3-5 diferenciais com justificacao
- O que so esta marca faz/tem
### 10. Beneficios por camada/segmento
- Funcional: o que resolve concretamente
- Emocional: como faz sentir
- Social: o que diz sobre quem usa
### 10b. Escada de valor (oferta comercial)
- **Entry** — produto/servico de entrada (baixo risco, primeiro contacto)
- **Core** — oferta principal (maior volume de receita)
- **Premium** — oferta de alto valor (margem maxima, clientes fieis)
- Logica de progressao entre niveis
### 11. Personalidade da marca
- 5 adjectivos que definem a marca
- Metafora (ex: "Se a marca fosse uma pessoa...")
- O que a marca NUNCA seria
### 12. Manifesto (opcional, marcas premium)
- Declaracao de crencas (5-10 linhas)
- Tom inspirador e autentico
---
## BLOCO C — Publico (4 pontos)
### 13. Segmentos de publico-alvo
- Minimo 3 segmentos
- Para cada: nome descritivo, tamanho estimado, prioridade (alta/media/baixa)
### 14. Personas detalhadas (20 dimensoes por segmento)
Ver `exemplo-persona-20d.md` para formato completo.
Cada persona deve incluir:
1. Perfil demografico
2. Perfil psicografico
3. Dores
4. Anseios
5. Desejos
6. Frustracoes
7. Preocupacoes
8. Medos
9. Inimigos
10. Linguagem
11. Como procuram ajuda
12. Canais digitais
13. Estilo de decisao
14. Mudancas que procuram
15. Resistencia a mudanca
16. Objecoes tipicas
17. Forma de gerar emocao
18. Argumentos de venda
19. Concorrentes percebidos
20. Propostas recusadas
### 15. Nichos sectoriais (se aplicavel)
- Tabela com: nicho, dimensao, prioridade (alta/media/baixa), justificacao
- Criterio de priorizacao explicito
### 16. Personas nomeadas
- Cada segmento deve ter uma persona com nome, idade, profissao, 1 paragrafo de historia
---
## BLOCO D — Comunicacao (7 pontos)
### 17. Pitch Canvas
5 elementos:
1. **Para quem** — segmento principal
2. **Que tem** — dor/necessidade
3. **O [marca]** — o que e
4. **Que oferece** — beneficio principal
5. **Diferente de** — alternativas
+ Declaracao de mudanca no mundo (1 frase)
### 18. Copywriting estrategico
Responder as 10 perguntas do questionamento estrategico (ver metodologia-acida-16ps.md).
### 19. Pain + Gain por segmento
Para cada segmento:
- **Pain:** 3 dores ordenadas por intensidade
- **Gain:** 3 beneficios que resolvem cada dor
- **Ponte:** como a marca conecta pain a gain
### 20. Mensagem central da marca
- Tagline/slogan (3-7 palavras)
- Mensagem expandida (1-2 frases)
- Elevador pitch (30 segundos)
### 21. Headlines por segmento
- 3 headlines por segmento (formato: dor/desejo + solucao)
- 1 headline institucional
### 22. Narrativa de marca
- Historia da marca (2-3 paragrafos)
- Narrativa por segmento (1 paragrafo cada): Dor -> Solucao -> Resultado
### 23. Tom de voz e linguagem
- 5 caracteristicas do tom (ex: "profissional mas acessivel")
- Palavras a usar vs palavras a evitar
- Exemplos de frases no tom correcto vs incorrecto
---
## BLOCO E — Activacao (7 pontos)
### 23b. Experiencia de marca (jornada do cliente)
- **Primeira impressao** — o que ve/sente no primeiro contacto (website, loja, redes)
- **Jornada do cliente** — 5-7 etapas desde descoberta ate fidelizacao
- **Pontos criticos de confianca** — momentos onde a marca ganha ou perde o cliente
- **Momentos WOW** — surpresas positivas que geram recomendacao
### 24. Demonstracao do produto/servico
- Script de demo por segmento (6 fases: preparacao, introducao, demo, casos uso, Q&A, follow-up)
### 25. Estrategia de atraccao de clientes
- 5-7 tacticas concretas com canal e accao
### 26. Estrategia de canais
- Canais prioritarios (ordenados por ROI esperado)
- Funcao de cada canal no funil ACIDA
### 27. Pilares de conteudo
- 3-5 pilares tematicos
- Tipo de conteudo por pilar
- Frequencia sugerida
### 28. Casos de uso e testemunhos
- 2-3 cenarios "antes/depois"
- Template para recolha de testemunhos
### 29. Call-to-action principal
- CTA primario (1)
- CTAs secundarios por fase ACIDA (4)
### 30. Parcerias estrategicas
- 3-5 tipos de parceiro potencial
- Beneficio mutuo para cada
---
## BLOCO F — Implementacao (6 pontos)
### 31. Plano de activacao (fases)
- Fase 1 (mes 1-2): fundamentos
- Fase 2 (mes 3-4): lancamento
- Fase 3 (mes 5-6): escala
- Accoes concretas por fase
### 32. Investimentos prioritarios
- Matriz impacto/esforco (4 quadrantes)
- Top 5 investimentos prioritarios com custo estimado
### 33. Identidade visual (directrizes)
- Cores primarias e secundarias (hex)
- Tipografia sugerida
- Estilo fotografico
- Elementos graficos
### 34. KPIs e monitorizacao
- 5-8 KPIs com: nome, baseline, meta, frequencia de medicao
- Dashboard sugerido
### 35. Inventario de activos de marketing
- Lista de activos necessarios (website, redes, templates, etc.)
- Estado actual (existe/nao existe/precisa actualizacao)
### 36. FAQ
- 10-15 perguntas frequentes com respostas
- Organizadas por categoria
---
## BLOCO G — Complementos (conforme sector)
### 37. Enquadramento legal
Apenas se sector regulado. Licencas, certificacoes, normas aplicaveis.
### 38. Informacoes operacionais
Localizacao, horario, contactos, equipa.
### 39. Expansao internacional
Apenas se aplicavel. Mercados-alvo, localizacao, logistica.
### 40. Servicos detalhados
Descricao completa dos servicos/produtos com precos (se publicos).
marketing/skills/brand-strategy/references/exemplo-persona-20d.md
+159
View File
@@ -0,0 +1,159 @@
# Exemplo de Persona — 20 Dimensoes
Baseado no padrao AcidaOS (o mais profundo dos exemplos Descomplicar).
---
## Segmento A — O Empreendedor Sobrecarregado
**Prioridade:** Alta
**Dimensao estimada:** 45% do mercado-alvo
### 1. Perfil demografico
- Idade: 35-50 anos
- Genero: predominantemente masculino (60/40)
- Localizacao: areas urbanas, Portugal continental
- Educacao: licenciatura ou equivalente profissional
- Rendimento: 25.000-60.000 EUR/ano (empresa factura 100K-500K)
- Dimensao empresa: 2-15 colaboradores
- Sector: servicos, comercio, consultoria
### 2. Perfil psicografico
- Trabalhador incansavel, faz tudo sozinho
- Valoriza independencia acima de tudo
- Resistente a delegar por medo de perda de controlo
- Pragmatico — quer solucoes que funcionem, nao teoria
- Orgulho no que construiu mas frustrado com a estagnacao
- Ceptico em relacao a "solucoes magicas"
### 3. Dores
- "Trabalho 12 horas por dia e o negocio nao cresce"
- Sem tempo para pensar estrategicamente
- Informacao dispersa (Excel, papel, cabeca)
- Clientes perdidos por falta de follow-up
- Nao sabe quanto lucra realmente
### 4. Anseios
- Ter tempo para a familia sem o negocio parar
- Ver o negocio crescer de forma previsivel
- Sentir-se no controlo em vez de apagar incendios
- Ser reconhecido como empresario de sucesso
### 5. Desejos
- Um sistema que "trabalhe por ele" nas tarefas repetitivas
- Dashboard simples que mostre como esta o negocio
- Processo de vendas que nao dependa so dele
- Facturacao automatica sem erros
### 6. Frustracoes
- Ja tentou CRMs e desistiu (demasiado complexos)
- Paga software que nao usa
- Funcionarios nao adoptam ferramentas novas
- Contabilista so aparece no fim do mes
### 7. Preocupacoes
- "Se eu parar, o negocio para"
- Concorrencia a crescer enquanto ele estagna
- Legislacao fiscal cada vez mais complexa
- Nao estar a usar a tecnologia como devia
### 8. Medos
- Perder clientes para concorrentes mais organizados
- Nao conseguir pagar salarios num mes mau
- Ser ultrapassado pela digitalizacao
- Investir em tecnologia e nao ter retorno
### 9. Inimigos
- Burocracia (AT, Seguranca Social, RGPD)
- Empresas grandes que competem com precos impossíveis
- Consultores que vendem teoria sem resultados
- O proprio perfeccionismo que impede de delegar
### 10. Linguagem
- "Nao tenho tempo para isso"
- "Ja tentei e nao funcionou"
- "Quanto e que isso custa?"
- "Mostra-me resultados, nao apresentacoes"
- Informal, directo, sem paciencia para jargao
### 11. Como procuram ajuda
- Perguntam a outros empresarios (boca-a-boca)
- Google quando ha um problema urgente
- LinkedIn para conteudo de negocios
- Contabilista como conselheiro informal
- Nao frequentam eventos/conferencias (sem tempo)
### 12. Canais digitais
- WhatsApp (principal — pessoal e profissional misturado)
- Facebook (pessoal, menos profissional)
- LinkedIn (passivo — le mas nao publica)
- Email (verifica 2-3x por dia, ignora newsletters)
- Instagram (pessoal, nao profissional)
### 13. Estilo de decisao
- Decide rapido quando ve valor claro
- Precisa de prova social (outro empresario a recomendar)
- Quer testar antes de comprometer
- Preco e factor mas nao o unico — valor percebido importa mais
- Prefere relacao pessoal a processo de vendas formal
### 14. Mudancas que procuram
- De "faz-tudo" para gestor que delega
- De reactivo (apagar incendios) para proactivo
- De Excel para sistema integrado
- De "acho que esta bem" para "sei que esta bem" (dados)
### 15. Resistencia a mudanca
- "Sempre fiz assim e funcionou"
- Medo da curva de aprendizagem
- Experiencias negativas anteriores com tecnologia
- Nao quer depender de fornecedores externos
- Equipa resiste a novas ferramentas
### 16. Objecoes tipicas
- "E caro demais para o meu negocio"
- "Nao tenho tempo para implementar"
- "Ja tentei um CRM e ninguem usou"
- "O meu negocio e diferente, isso nao se aplica"
- "Prefiro investir em publicidade directa"
### 17. Forma de gerar emocao
- Mostrar quanto tempo perde por semana em tarefas repetitivas (quantificar)
- Historias de empresarios semelhantes que transformaram o negocio
- Demonstrar em 5 minutos o que o sistema faz automaticamente
- Falar da familia — "imagina sair as 18h todos os dias"
### 18. Argumentos de venda
- ROI em 3 meses (calculado com dados do negocio)
- "Nao precisa de saber tecnologia — nos tratamos de tudo"
- Garantia de satisfacao ou devolucao
- Implementacao faseada (nao muda tudo de uma vez)
- Suporte por WhatsApp (o canal dele)
### 19. Concorrentes percebidos
- "O meu sobrinho faz-me um website"
- Freelancers no OLX/Facebook
- Ferramentas gratuitas (Google Sheets, Canva)
- PHC/Sage (que ja tem e nao usa)
- "Nao investir" (o concorrente mais forte)
### 20. Propostas recusadas
- Pacotes anuais sem flexibilidade
- Solucoes que requerem formacao extensa
- Propostas sem resultados tangíveis prometidos
- Precos acima de 200 EUR/mes sem trial
- Vendedores que nao entendem o sector especifico
---
## Formato resumido (para nivel Essencial — 8 dimensoes)
Quando o nivel e Essencial, usar apenas:
1. Perfil demografico
2. Perfil psicografico
3. Dores
4. Desejos
5. Objecoes tipicas
6. Canais digitais
7. Estilo de decisao
8. Argumentos de venda
marketing/skills/brand-strategy/references/metodologia-acida-16ps.md
+80
View File
@@ -0,0 +1,80 @@
# Metodologia ACIDA + Framework 16Ps
## ACIDA — 5 Fases da Jornada
### A — Atrair a atencao
Conectar com dores e desejos do publico (nao destacar produtos). "O ser humano ocidental recebe em 6 dias mais informacao do que os bisavos em 80 anos."
### C — Construir confianca
Transparencia, demonstrar compreensao, partilhar conhecimento, educar, estabelecer autoridade.
### I — Despertar interesse
Comunicacao personalizada por segmento. Rastreamento de interaccoes, conteudo customizado, resolucao antecipada de objecoes, nutricao multi-canal.
### D — Estimular a decisao
Apresentar proposta onde valor percebido > preco. Superar: duvidas, medo de arrependimento, necessidade de prova social.
### A — Incentivar a accao
CTAs claros, urgencia, cumprir promessas, superar expectativas.
## Framework 16Ps — Estrutura Sistematica
### Bloco A — Fundamentos estrategicos (P1-P4)
| P | Conteudo |
|---|---------|
| Problema | Problema principal, impacto no cliente, urgencia |
| Proposito | Missao, visao, valores |
| Proposta de valor | Valor unico, diferenciais, beneficios |
| Posicionamento | Posicao no mercado, diferenciacao, percepcao desejada |
| Performance | KPIs, metas, indicadores de sucesso |
### Bloco B — Publico e pesquisa (P5-P7)
| P | Conteudo |
|---|---------|
| Publico-alvo | Segmentos, comportamento de compra |
| Pesquisa de mercado | Dados, insights, tendencias |
| Personas | Nome, biografia, dores, objectivos, canais |
| Perfil | Demografico + psicografico (20 dimensoes) |
| Pain Points | Dores, frustracoes, necessidades nao atendidas |
### Bloco C — Produto e servico (P8-P10)
| P | Conteudo |
|---|---------|
| Produto/Portfolio | Servicos, caracteristicas, beneficios |
| Preco e valor | Estrategia de precos, posicionamento |
| Processos criticos | Pontos de controlo, qualidade |
| Parcerias estrategicas | Parceiros, beneficios mutuos |
| Plataforma | Canais digitais, infraestrutura |
### Bloco D — Promocao e comunicacao (P11-P13)
| P | Conteudo |
|---|---------|
| Promocao | Canais, tacticas, calendario |
| Publicidade | Anuncios, orcamento, frequencia |
| PR | Relacoes publicas, influenciadores |
| Presenca digital | Conteudo, comunidade |
| Proximidade | Narrativa, Pain+Gain, mensagens por persona |
## Pilares estrategicos Descomplicar
- Website como hub central (nao redes sociais)
- Proposta de valor: "problema -> solucao -> resultados"
- Ecossistema multi-canal: email, SMS/WhatsApp, SEO, Ads, website, social
- Melhoria continua baseada em metricas
## Questionamento estrategico para copywriting (10 perguntas)
1. Qual e o objectivo da comunicacao?
2. Quem e o publico-alvo?
3. Qual e a oferta?
4. Qual e o beneficio principal?
5. Quais sao as dores e desejos do publico?
6. Qual e a prova social?
7. Quais sao as objecoes potenciais?
8. Qual e a narrativa/historia?
9. Onde a mensagem sera veiculada?
10. Qual e o call-to-action?
marketing/skills/content-marketing-pt/SKILL.md
+147
View File
@@ -0,0 +1,147 @@
---
name: content-marketing-pt
description: Criacao de conteudo de marketing profissional em portugues europeu com standards actuais.
layer: wiki
---
# Content Marketing PT-PT
Skill para criacao de conteudo marketing profissional em Portugues Europeu com standards 2026.
---
## Contexto NotebookLM
ANTES de executar, consultar notebooks para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Marketing Digital PT | `4c595973` | Sempre |
| Copywriting e Persuasao | `7b8fec17` | Quando envolve redaccao de conteudo |
```
mcp__notebooklm__notebook_query({
notebook_id: "4c595973-ba10-420a-a3bf-e4389e424ad3",
query: "<adaptar ao contexto>"
})
mcp__notebooklm__notebook_query({
notebook_id: "7b8fec17-d34f-4e3f-a8c6-8231e51f6323",
query: "<adaptar — ex: headlines persuasivas, CTAs, copywriting PT-PT>"
})
```
**Procedimento relacionado:** `PROC-Guia-PT-PT.md` -- consultar para garantir redaccao correcta em portugues europeu.
---
## Quando Usar
- Escrever artigos blog, landing pages, emails marketing
- Definir tom de voz para marca/projecto
- Criar copy para CTAs, headlines, descricoes
- Adaptar conteudo BR -> PT-PT
- Estruturar estrategia editorial
- Implementar storytelling e narrativas
- Optimizar conteudo para conversao
---
## Tom de Voz PT-PT (Standards 2026)
### Regras Obrigatorias
**SEMPRE:**
- **Tratamento**: "tu" (informal B2C), "voce" (formal B2B), ou impessoal
- **Verbos Infinitivos**: "Clique aqui" -> "Clicar aqui" (instrucoes)
- **Vocabulario Europeu**: ficheiro (nao arquivo), ecra (nao tela), telemovel (nao celular), aplicacao (nao app em contexto formal), download -> descarregar, upload -> carregar
- **Moeda**: 95EUR (simbolo DEPOIS do valor)
- **Datas**: 3 de Fevereiro de 2026
- **Numeros**: 1.500 (ponto milhares) | 1,50EUR (virgula decimais)
**NUNCA:**
- **Brasileirismos**: deletar, rodar, plugar, startar, printar
- **Anglicismos desnecessarios**: "fazer o deploy" -> "implementar"
- **Excesso emojis**: Maximo 1-2 por texto profissional B2B
- **Exclamacoes excessivas**: Maximo 1 por paragrafo B2C, 0 B2B
- **Girias**: "tranquilo", "beleza", "bacana" -> Substituir por neutro
### Tom por Contexto
| Contexto | Tom | Exemplo |
|----------|-----|---------|
| **B2B Corporativo** | Formal, tecnico, autoridade | "A solucao optimiza processos empresariais" |
| **B2C Casual** | Informal, proximo, empatico | "Vamos tornar isto mais simples para ti" |
| **E-commerce** | Persuasivo, beneficio, urgencia | "Poupa 30% hoje. Promocao termina em 24h" |
| **Educacional** | Claro, didactico, encorajador | "Aprende passo a passo. Dominas em 30 dias" |
| **Institucional** | Neutro, factual, transparente | "A empresa fundada em 2010 serve 500+ clientes" |
---
## Estrutura de Artigos (Framework AIDA+)
### 1. HEADLINE (5-10 palavras, beneficio claro)
**Checklist Headline:**
- [ ] Inclui numero (quando relevante)
- [ ] Beneficio claro e especifico
- [ ] Target audience identificavel
- [ ] Urgencia/prazo (quando aplicavel)
- [ ] < 70 caracteres
- [ ] Keyword principal incluida (SEO)
### 2. LEAD / Hook (2-3 frases, ganhar atencao)
**Framework PAS (Problem-Agitate-Solution):**
- **Problema**: Identificar dor especifica
- **Agitar**: Amplificar consequencias
- **Solucao** (teaser): Apresentar caminho
### 3. CORPO (Estrutura Escalar)
```
## Introducao (100-150 palavras)
## Seccao 1: [Subtitulo H2 com keyword secundaria]
### Subseccao 1.1 (H3)
## Seccao 2: [Subtitulo H2]
## Seccao 3: FAQ / Objecoes Comuns
## Conclusao (80-100 palavras) + CTA claro
```
### 4. CTA (Call-to-Action)
Anatomia: [Verbo Accao] + [Beneficio Imediato] + [Reducao Friccao]
---
## Formatos de Conteudo 2026
### Blog Post (Pilar Content)
| Metrica | Valor | Nota |
|---------|-------|------|
| **Extensao** | 1200-2500 palavras | Topics competitivos: 2000+ |
| **Estrutura** | H1 + 4-6 H2 + CTA | Hierarquia clara |
| **Imagens** | 3-5 (1 hero + 2-4 suporte) | Alt text obrigatorio |
| **Tempo leitura** | 5-10 minutos | Indicar no topo |
| **Internal links** | 3-5 relevantes | Distribuidos naturalmente |
| **External links** | 1-3 autoritativos | DR > 40 preferivel |
| **CTA** | 2-3 (inicio, meio, fim) | Diferentes niveis compromisso |
### Email Marketing
| Tipo | Subject Line | Extensao | CTA | Taxa Abertura Target |
|------|--------------|----------|-----|----------------------|
| **Newsletter** | Curiosidade | 150-300 palavras | 1 primario | 20-25% |
| **Promocional** | Beneficio + urgencia | 100-200 palavras | 1 bold | 15-20% |
| **Nurturing** | Educacional, valor | 200-400 palavras | 1 soft | 25-30% |
| **Transacional** | Claro, directo | 50-150 palavras | 1-2 accoes | 40-50% |
### Social Media Posts (PT-PT)
| Plataforma | Extensao | Tom | Hashtags |
|------------|----------|-----|----------|
| **LinkedIn** | 150-300 chars | Profissional, insights | 3-5 |
| **Instagram** | 100-150 chars | Inspiracional, visual | 10-15 |
| **Facebook** | 40-80 chars | Conversacional | 1-3 |
| **Twitter/X**
marketing/skills/content-marketing-pt/content/templates.md
+244
View File
@@ -0,0 +1,244 @@
# Templates Conteúdo Marketing PT-PT
**Autor**: Descomplicar® Crescimento Digital
**Link**: https://descomplicar.pt
---
## Template Blog Post
```markdown
# [HEADLINE: Benefício Principal]
[LEAD: 2-3 frases que captam atenção e prometem valor]
## [H2: Primeiro Ponto Principal]
[Parágrafo introdutório - máximo 3 linhas]
[Desenvolvimento com exemplos concretos]
> [Citação ou destaque importante]
## [H2: Segundo Ponto Principal]
[Conteúdo estruturado]
### [H3: Sub-ponto se necessário]
- Ponto 1
- Ponto 2
- Ponto 3
## [H2: Terceiro Ponto Principal]
[Conteúdo com dados/estatísticas quando possível]
| Métrica | Antes | Depois |
|---------|-------|--------|
| [X] | [Y] | [Z] |
## Conclusão
[Resumo dos pontos principais em 2-3 frases]
[CTA claro e específico]
---
**[Assinatura/Bio autor se aplicável]**
```
---
## Template Email Marketing
```markdown
**Assunto**: [Benefício] + [Curiosidade/Urgência]
**Preview**: [Complemento do assunto - primeiras 40-60 caracteres]
---
Olá [Nome],
[Abertura pessoal ou contextual - 1-2 frases]
[Problema/Dor que o leitor reconhece]
[Solução que ofereces - como resolve o problema]
[Benefício principal - resultado específico]
[Prova social ou credibilidade - breve]
**[CTA Principal]**
[Botão ou link claro]
[Alternativa ou próximo passo secundário]
Cumprimentos,
[Nome]
[Cargo/Empresa]
P.S. [Urgência ou benefício extra - opcional]
```
---
## Template Landing Page
```markdown
# [HERO HEADLINE]
## [Subheadline com benefício secundário]
[CTA Principal] [CTA Secundário]
---
## Problema
[Descrição da dor que o público-alvo sente]
## Solução
[Como o produto/serviço resolve o problema]
### Benefício 1
[Descrição + resultado específico]
### Benefício 2
[Descrição + resultado específico]
### Benefício 3
[Descrição + resultado específico]
---
## Prova Social
> "[Testemunho cliente]"
> — [Nome], [Cargo], [Empresa]
[Logos clientes ou métricas de sucesso]
---
## Como Funciona
1. [Passo 1 - simples]
2. [Passo 2 - simples]
3. [Passo 3 - resultado]
---
## Preços / Oferta
[Tabela preços ou descrição oferta]
[CTA Final com urgência subtil]
---
## FAQ
**[Pergunta frequente 1]**
[Resposta concisa]
**[Pergunta frequente 2]**
[Resposta concisa]
---
[CTA Final]
[Garantia ou redução de risco]
```
---
## Template Social Media
### LinkedIn Post
```
[Hook - primeira linha impactante]
[Espaço]
[Contexto/História - 2-3 linhas]
[Insight principal - o que aprendeste]
[Lista de pontos se aplicável]
• Ponto 1
• Ponto 2
• Ponto 3
[CTA ou pergunta para engagement]
#hashtag1 #hashtag2 #hashtag3
```
### Instagram Caption
```
[Hook forte - primeiras palavras visíveis]
[Valor/Conteúdo principal - breve]
[CTA claro]
.
.
.
#hashtags (máximo 30, relevantes)
```
---
## Template Newsletter
```markdown
# [Nome Newsletter] - Edição [Número]
[Saudação personalizada]
## Esta Semana
[Resumo do que vem - 2-3 frases]
---
### 1. [Tópico Principal]
[Conteúdo principal - valor imediato]
[Link para artigo completo se aplicável]
---
### 2. [Tópico Secundário]
[Conteúdo mais curto]
---
### 3. [Recurso/Ferramenta/Dica]
[Recomendação com contexto]
---
## Próxima Semana
[Teaser do próximo conteúdo]
[CTA para partilhar ou responder]
---
[Assinatura]
[Links redes sociais]
[Link para cancelar subscrição]
```
---
**Nota**: Adaptar templates ao tom de voz específico da marca/projecto.
marketing/skills/content-marketing-pt/content/vocabulary.md
+164
View File
@@ -0,0 +1,164 @@
# Dicionário BR → PT-PT para Marketing
**Autor**: Descomplicar® Crescimento Digital
**Link**: https://descomplicar.pt
---
## Termos Gerais
| Brasileiro | Português Europeu |
|------------|-------------------|
| deletar | eliminar |
| salvar | guardar |
| aplicativo | aplicação |
| rodar | executar |
| tela | ecrã |
| celular | telemóvel |
| mouse | rato |
| arquivo | ficheiro |
| clicar | clicar (mantém) |
| acessar | aceder |
| cadastrar | registar |
| cadastro | registo |
| loja | loja (mantém) |
| usuário | utilizador |
| senha | palavra-passe |
| login | início de sessão |
| logout | fim de sessão |
| baixar | descarregar |
| upload | carregar/enviar |
| download | transferência/descarga |
---
## Termos Marketing
| Brasileiro | Português Europeu |
|------------|-------------------|
| mídia | media |
| mídias sociais | redes sociais |
| conteúdo | conteúdo (mantém) |
| engajamento | envolvimento |
| curtir | gostar |
| compartilhar | partilhar |
| seguidor | seguidor (mantém) |
| influenciador | influenciador (mantém) |
| stories | stories (mantém - termo técnico) |
| reels | reels (mantém - termo técnico) |
| feed | feed (mantém - termo técnico) |
| postagem | publicação |
| postar | publicar |
| audiência | audiência (mantém) |
| público-alvo | público-alvo (mantém) |
| funil | funil (mantém) |
| lead | lead (mantém - termo técnico) |
---
## Termos E-commerce
| Brasileiro | Português Europeu |
|------------|-------------------|
| carrinho | carrinho (mantém) |
| checkout | checkout (mantém) / finalização |
| frete | portes |
| boleto | referência multibanco |
| cartão de crédito | cartão de crédito (mantém) |
| parcelamento | pagamento faseado |
| cupom | cupão |
| desconto | desconto (mantém) |
| promoção | promoção (mantém) |
| estoque | stock |
| produto | produto (mantém) |
| vitrine | montra |
---
## Termos Técnicos Web
| Brasileiro | Português Europeu |
|------------|-------------------|
| site | site/sítio web |
| página | página (mantém) |
| navegador | navegador (mantém) |
| servidor | servidor (mantém) |
| hospedagem | alojamento |
| domínio | domínio (mantém) |
| backup | cópia de segurança |
| atualização | actualização |
| configuração | configuração (mantém) |
| painel | painel (mantém) |
| template | modelo/template |
| layout | layout (mantém) |
---
## Expressões Comuns
| Brasileiro | Português Europeu |
|------------|-------------------|
| "Fique por dentro" | "Mantenha-se informado" |
| "Confira" | "Consulte" / "Veja" |
| "Saiba mais" | "Saber mais" |
| "Não perca" | "Não perca" (mantém) |
| "Aproveite" | "Aproveite" (mantém) |
| "Garanta já" | "Garanta já" (mantém) |
| "Cadastre-se" | "Registe-se" |
| "Faça login" | "Inicie sessão" |
| "Clique aqui" | "Clique aqui" (mantém) |
| "Fale conosco" | "Contacte-nos" |
| "Entre em contato" | "Entre em contacto" |
| "Tire suas dúvidas" | "Esclareça as suas dúvidas" |
---
## Formatação Monetária PT-PT
```
CORRECTO:
- 95€
- 1.234,56€
- 10€/mês
- desde 29€
ERRADO:
- €95
- €1.234,56
- R$ (nunca em PT-PT)
```
---
## Datas e Números
```
PT-PT:
- 19/01/2025 (DD/MM/AAAA)
- 19 de Janeiro de 2025
- 1.234,56 (ponto milhares, vírgula decimais)
- 09:30 (formato 24h preferido)
BR (evitar):
- 01/19/2025
- 1,234.56
```
---
## Notas Importantes
1. **Manter termos técnicos em inglês** quando universalmente aceites:
- API, SEO, CRM, ROI, KPI, SaaS, etc.
2. **Hífen em compostos**:
- PT-PT: "fim-de-semana", "correio-eletrónico"
- Novo acordo: algumas variações aceites
3. **Acentuação**:
- PT-PT mantém mais acentos: "acção", "contacto"
- Novo acordo: muitos opcionais, preferir forma tradicional em contexto formal
4. **Pronomes**:
- PT-PT: próclise menos comum ("Diga-me" vs "Me diga")
- Evitar "você" excessivo, preferir impessoal ou "tu"
marketing/skills/content-marketing-pt/references/copywriting-patterns.md
+112
View File
@@ -0,0 +1,112 @@
# Copywriting Patterns 2026
## Headlines (Testar 3-5 variacoes)
| Padrao | Formula | Exemplo PT-PT | Uso |
|--------|---------|---------------|-----|
| **Numero + Beneficio** | [X] formas de [resultado] | "5 Formas de Duplicar Conversoes" | Blog, listas |
| **Como Fazer** | Como [resultado] em [tempo] | "Como Gerar Leads em 30 Dias" | Tutoriais |
| **Pergunta Provocativa** | [Pergunta dor/desejo]? | "Perder Clientes para Concorrencia?" | Landing pages |
| **Caso/Estudo** | Como [empresa] conseguiu [resultado] | "Como a XYZ Cresceu 300% em 6 Meses" | Case studies |
| **Contrarian** | Porque [crenca comum] esta errada | "Porque SEO Nao Funciona (e o que fazer)" | Thought leadership |
## Formulas Headline Testadas
```
[Numero] + [Adjectivo] + [Substantivo] + [Promessa/Beneficio]
"7 Estrategias Comprovadas para Duplicar Vendas em 90 Dias"
[Como] + [Conseguir Resultado] + [Sem Obstaculo]
"Como Gerar Leads Qualificados Sem Gastar em Publicidade"
[Resultado] + [em Tempo] + [para Audiencia]
"10.000 Visitantes/Mes em 6 Meses para PMEs Portuguesas"
```
## Body Copy
### Paragrafos Curtos (2-4 linhas)
Facilita leitura em mobile. Evita "walls of text". Aumenta engagement.
### Listas e Bullets
- Escaneabilidade
- Destaque pontos chave
- Melhor retencao
### Transicoes Subtis
Primeiro, vamos ver X. **Depois**, exploramos Y. **Por fim**, implementamos Z.
### Voz Activa > Passiva
- "Implementamos a solucao em 3 dias" (activa)
- "A solucao foi implementada em 3 dias" (passiva) -- evitar
### Dados Especificos > Genericos
- "127% aumento em conversoes" (especifico)
- "Grande aumento em conversoes" (generico) -- evitar
## CTAs por Funil
| Fase Funil | Objectivo | CTA Exemplo | Friccao |
|------------|-----------|-------------|---------|
| **ToFu (Awareness)** | Educar | "Ler guia completo" | Muito baixa |
| **MoFu (Consideration)** | Engajar | "Experimentar ferramenta gratuita" | Baixa |
| **BoFu (Decision)** | Converter | "Falar com consultor (15 min)" | Media |
| **Retention** | Fidelizar | "Actualizar para plano Pro (30% off)" | Baixa-Media |
## Anatomia CTA Eficaz
```
[Verbo Accao] + [Beneficio Imediato] + [Reducao Friccao]
BOM:
- "Comecar teste gratuito (sem cartao de credito)"
- "Descarregar guia completo (4 minutos de leitura)"
- "Agendar demonstracao (15 min, sem compromisso)"
MAU:
- "Clique aqui" (vago)
- "Submeter" (tecnico, frio)
- "Comprar agora!!!" (agressivo)
```
## Storytelling (Framework Hero's Journey Adaptado)
1. **Mundo Ordinario** - Cliente no status quo
"Maria geria vendas manualmente. 40h/semana em Excel."
2. **Chamada Aventura** - Problema torna-se insuportavel
"Perdeu 50.000EUR em oportunidades por falta de follow-up."
3. **Mentor** - Solucao aparece (produto/servico)
"Descobriu CRM Descomplicar. Automacao inteligente."
4. **Transformacao** - Implementacao e resultados
"Em 60 dias: 3x mais leads, 40% conversao, 20h/semana poupadas."
5. **Retorno** - Novo mundo, cliente heroi
"Hoje, Maria escala vendas sem escalar equipa. ROI 400%."
## Persuasao Etica (Cialdini 2026)
| Principio | Tecnica PT-PT | Exemplo |
|-----------|---------------|---------|
| **Reciprocidade** | Dar valor antes de pedir | "Guia gratuito -> inscricao newsletter" |
| **Compromisso** | Micro-yeses progressivos | "Teste 14 dias -> plano mensal -> anual" |
| **Social Proof** | Testemunhos especificos | "127 PMEs PT cresceram 200% em 6 meses" |
| **Autoridade** | Credenciais verificaveis | "Certificado Google, 15 anos experiencia" |
| **Escassez** | Limitacao genuina | "Apenas 5 vagas consultoria Fevereiro" |
| **Simpatia** | Tom humano, empatia | "Sabemos como e dificil gerir tudo sozinho" |
## Optimizacao Conversao (CRO)
**Testes A/B Prioridade:**
1. **Headlines** (maior impacto)
2. **CTAs** (cor, texto, posicao)
3. **Hero images** (contexto vs produto)
4. **Social proof** (quantidade vs qualidade)
5. **Form fields** (menos = mais conversoes)
**Ferramentas:**
- Google Optimize (gratuito)
- Hotjar (heatmaps, gravacoes)
- Microsoft Clarity (gratuito, alternativa Hotjar)
marketing/skills/content-marketing-pt/references/templates-conteudo.md
+129
View File
@@ -0,0 +1,129 @@
# Templates de Conteudo
## Template Artigo Blog (1500 palavras)
```markdown
---
title: [Headline Optimizado SEO]
description: [Meta description 150-160 chars]
author: [Nome Autor]
date: YYYY-MM-DD
keywords: [keyword1, keyword2, keyword3]
---
# [H1 - Headline Principal]
**Tempo de leitura: X minutos**
## Introducao
[Lead/Hook - Problema + Agitacao + Teaser solucao - 100-150 palavras]
[CTA Suave: "Ler guia completo"]
## [H2 - Seccao 1: Keyword Secundaria]
[Conteudo 300-400 palavras]
### [H3 - Subseccao 1.1]
- Ponto chave
- Exemplo pratico
- Dados/estatisticas
[Imagem com alt text]
### [H3 - Subseccao 1.2]
[...]
## [H2 - Seccao 2: Keyword Secundaria]
[Conteudo 300-400 palavras]
[CTA Medio: "Experimentar ferramenta gratuita"]
## [H2 - FAQ / Perguntas Frequentes]
**1. [Pergunta comum]?**
[Resposta 40-60 palavras]
**2. [Pergunta comum]?**
[Resposta 40-60 palavras]
**3. [Pergunta comum]?**
[Resposta 40-60 palavras]
## Conclusao
[Resumir pontos principais - 80-100 palavras]
[CTA Final Forte: "Agendar demonstracao gratuita (15 min)"]
---
**Sobre o Autor:**
[Nome] e [Cargo] na [Empresa]. Com X anos de experiencia em [Area], ajudou X+ empresas a [Resultado].
**Leituras Relacionadas:**
- [Link interno 1]
- [Link interno 2]
- [Link interno 3]
```
---
## Template Email Promocional
```markdown
**Subject:** [Nome], esta oferta termina hoje as 23:59
Ola [Nome],
[Hook - Beneficio imediato em 1 frase]
**40% desconto em todos os planos. Hoje e o ultimo dia.**
O que consegues com [Produto]:
- [Beneficio 1 especifico]
- [Beneficio 2 especifico]
- [Beneficio 3 especifico]
[Social Proof - "125 empresas PT ja aderiram esta semana"]
**[CTA Button: "Activar desconto 40%"]**
Sem compromissos. Cancelas quando quiseres.
Garantia 30 dias dinheiro de volta.
Ate breve,
[Nome]
[Cargo] @ [Empresa]
P.S. Promocao termina hoje as 23:59. Nao percas.
[CTA Link: "Resgatar desconto"]
```
---
## Template Landing Page (Estrutura Testada)
```
1. Hero (Headline + Subheadline + CTA + Imagem)
2. Social Proof (Logos clientes / Testemunho)
3. Beneficios (3 principais com icones)
4. Como Funciona (3 passos simples)
5. Features (com screenshots/video)
6. Testemunhos (2-3 detalhados)
7. Objecoes / FAQ
8. CTA Final (urgencia + garantia)
```
| Elemento | Best Practice | Impacto Conversao |
|----------|---------------|-------------------|
| **Hero** | Beneficio claro em 5 segundos | +40% |
| **Social Proof** | Testemunhos (foto + nome + empresa) | +35% |
| **Above-the-fold CTA** | Visivel sem scroll | +25% |
| **Urgencia** | Countdown, stock limitado | +20% |
| **Garantia** | Money-back, teste gratuito | +15% |
| **Remover navegacao** | Foco no CTA unico | +10% |
marketing/skills/content-marketing-pt/references/vocabulario-br-pt.md
+22
View File
@@ -0,0 +1,22 @@
# Vocabulario BR -> PT-PT
Tabela de conversao de brasileirismos para portugues europeu.
| Brasileiro | Portugues Europeu | Contexto |
|------------|-------------------|----------|
| deletar | eliminar, apagar | Ficheiros |
| rodar | executar, correr | Programas |
| startar | iniciar, arrancar | Processos |
| printar | imprimir | Documentos |
| plugar | ligar, conectar | Dispositivos |
| baixar | descarregar | Download |
| upar | carregar | Upload |
| tela | ecra | Dispositivos |
| celular | telemovel | Telefone |
| arquivo | ficheiro | Documentos digitais |
| mouse | rato | Dispositivo |
| site | sitio web, site | Online (ambos OK) |
| voce | tu (informal), voce (formal) | Tratamento |
| tranquilo | esta bem, sem problema | Confirmacao |
| bacana | interessante, fixe | Qualidade |
| legal | bom, giro | Aprovacao |
marketing/skills/desk.project
+6
View File
@@ -0,0 +1,6 @@
{
"task_id": null,
"project_id": null,
"customer_id": null,
"gitea_repo": null
}
marketing/skills/index.md
+8
View File
@@ -0,0 +1,8 @@
# skills
## Documentação
- [README](README.md)
- [AGENTS](AGENTS.md)
- [STATUS](STATUS.md)
- [MEMORY](MEMORY.md)
marketing/skills/lead-approach/SKILL.md
+206
View File
@@ -0,0 +1,206 @@
---
name: lead-approach
description: Abordagem estratégica de leads com análise completa, estratégia de proposta e primeiro contacto. Lança agentes especializados em paralelo, consulta datasets Dify, cria proposta e actualiza CRM.
layer: wiki
---
# Skill /lead-approach - Abordagem Estratégica de Leads
Skill para analisar leads e criar estratégia de abordagem completa, usando agentes especializados e datasets Dify.
## Contexto NotebookLM
ANTES de executar, consultar notebooks para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Copywriting e Persuasão | `7b8fec17` | Sempre |
| Marketing Digital PT | `4c595973` | Para contexto do mercado PT |
```
mcp__notebooklm__notebook_query({
notebook_id: "7b8fec17-d34f-4e3f-a8c6-8231e51f6323",
query: "<adaptar ao contexto — ex: abordagem comercial, email primeiro contacto, persuasão>"
})
mcp__notebooklm__notebook_query({
notebook_id: "4c595973-ba10-420a-a3bf-e4389e424ad3",
query: "<adaptar — ex: mercado português, leads PME, estratégia digital PT>"
})
```
Integrar insights do NotebookLM nas recomendações e decisões.
---
## Quando Usar
- Novo lead para abordar
- Lead de abandono de formulário
- Lead que não respondeu (reactivação)
- Necessidade de estratégia comercial completa
- Preparar proposta de valor
## Quando NÃO Usar
- Para criar orçamento directo (usar /orcamento)
- Para operações CRM simples (usar /crm-ops)
- Para leads já qualificados com proposta pronta
---
## Protocolo
### Sintaxe
```
/lead-approach [lead_id]
/lead-approach [nome_empresa]
```
**Parâmetros:**
- `lead_id` - ID do lead no CRM (opcional)
- `nome_empresa` - Nome para pesquisar (opcional)
Se nenhum parâmetro fornecido, solicita informação ao utilizador.
## Fluxo de Execução
### Fase 1: Identificação do Lead
1. Se `lead_id` fornecido:
```javascript
mcp__desk-crm-v3__get_leads({ search: lead_id })
```
2. Se `nome_empresa` fornecido:
```javascript
mcp__desk-crm-v3__get_leads({ search: nome_empresa })
```
3. Verificar tickets associados:
```javascript
mcp__desk-crm-v3__get_tickets({ search: email_lead })
```
### Fase 2: Recolha de Dados
**Do CRM:**
- Nome, email, telefone
- Empresa, cargo
- Origem (source)
- Descrição/notas existentes
**Do Ticket (se existir):**
- Serviços pedidos
- Objectivo declarado
- Situação técnica (domínio, alojamento)
**Externa:**
- Website da empresa (WebFetch se existir)
- Redes sociais (Facebook, LinkedIn)
- Google My Business
### Fase 3: Análise Estratégica (Agentes)
**Lançar em paralelo:**
```javascript
// Agente 1: Estratégia de proposta
Task({
subagent_type: "marketing-planning-expert",
model: "sonnet",
prompt: `CONTEXTO DO LEAD:
- Empresa: ${empresa}
- Setor: ${setor}
- Localidade: ${localidade}
- Tamanho: ${colaboradores}
- Situação actual: ${situacao}
O QUE PEDIRAM: ${servicosPedidos}
OBJECTIVO: ${objectivo}
PERGUNTAS:
1. Que tipo de site/solução faz sentido?
2. Estratégia de conteúdo para o setor?
3. Como diferenciareçã de concorrentes?
4. Que pacotes propor? Que valores?
5. Quick wins imediatos?`
});
// Agente 2: Abordagem comercial
Task({
subagent_type: "sales-manager",
model: "sonnet",
prompt: `LEAD: ${nome} - ${cargo}
EMPRESA: ${empresa}
ORIGEM: ${origem}
EMAIL: ${email}
TELEFONE: ${telefone}
SERVIÇOS PEDIDOS: ${servicosPedidos}
OBJECTIVO: ${objectivo}
PERGUNTAS:
1. Como abordar? (canal, timing)
2. Que tom usar?
3. Template email primeiro contacto
4. Script telefónico se não responder
5. Perguntas de qualificação
6. Sequência follow-up`
});
```
### Fase 4: Consultar Datasets Dify
```javascript
// Estratégias de marketing do setor
mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24",
query: `${setor} lead generation estratégia`,
retrieval_mode: "hybrid_search",
top_k: 5
});
// Técnicas de venda
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "a7ba6005-517c-41ab-ac5e-da1c1a1c62ef",
query: "primeiro contacto lead quente abordagem",
retrieval_mode: "hybrid_search",
top_k: 5
});
```
### Fase 5: Compilar Resultados
Criar documento no vault:
```
01-Projectos/Profissional/PRJ-{Empresa}-Proposta.md
```
**Estrutura do documento:**
- Dados do cliente
- Diagnóstico
- Proposta de valor
- Pacotes/Preços
- ROI projectado
- Timeline
- Template email de abordagem
### Fase 6: Actualizar CRM
```javascript
mcp__desk-crm-v3__update_lead({
lead_id: id,
assigned: 1, // Emanuel
description: `[notas completas com dados recolhidos e estratégia]`
});
```
## Datasets Dify
| Dataset | ID | Usar Para |
|---------|----|-----------|
| Marketing Digital | `c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24` | Estratégias, funil, leads |
| Vendas | `a7ba6005-517c-41ab-ac5e-da1c1a1c62ef` | Técnicas fecho, objecções |
| Serviços Descomplicar | `bd65f36e-6004-4584-b478-129b2c21b4d2`
marketing/skills/log.md
+1
View File
@@ -0,0 +1 @@
## 2026-06-30 init | Estrutura padrão
marketing/skills/marketing-strategy/SKILL.md
+157
View File
@@ -0,0 +1,157 @@
---
name: marketing-strategy
description: Desenvolvimento de estrategia de marketing para PMEs portuguesas. Cria planos completos com mix de canais e alocacao de orcamento.
layer: wiki
---
# /marketing-strategy
Estrategia de marketing digital integrada com frameworks modernos 2026.
---
## Contexto NotebookLM
ANTES de executar, consultar notebooks para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Marketing Digital PT | `4c595973` | Sempre |
| Marketing Digital Avancado | `76647e0f` | Para estrategias complexas |
```
mcp__notebooklm__notebook_query({
notebook_id: "4c595973-ba10-420a-a3bf-e4389e424ad3",
query: "<adaptar ao contexto do pedido>"
})
mcp__notebooklm__notebook_query({
notebook_id: "76647e0f-3ae2-4c00-a0a8-f457aebf5655",
query: "<adaptar — ex: growth hacking, funil avancado, diferenciacao competitiva>"
})
```
---
## Quando Usar
- Estrategia marketing, plano marketing
- Growth, go-to-market, GTM
- Posicionamento, diferenciacao
- OKRs, KPIs marketing
- Analise mercado, concorrencia
---
## Framework Estrategico (5 Fases)
### Fase 1: Analise de Situacao (Research)
Analise completa com:
- **Analise de Mercado**: TAM/SAM/SOM, tendencias, barreiras entrada
- **Concorrencia (Porter's 5 Forces)**: Rivalidade, ameacas, poderes negociais
- **Analise Interna (SWOT)**: Forcas, fraquezas, oportunidades, ameacas
Detalhes e templates em `references/frameworks-estrategicos.md`.
### Fase 2: Definicao Estrategica
#### 2.1 Segmentacao e Targeting
- Identificar 3-5 segmentos maximo
- Priorizar por Reach/Revenue/Resources (matriz pontuacao)
- Definir ICP (Ideal Customer Profile) para segmento prioritario
#### 2.2 Posicionamento (Framework 4C)
```
Para [target audience especifico]
Que [tem este problema/necessidade]
O [produto/servico] e [categoria]
Que [beneficio principal unico]
Ao contrario de [alternativa/concorrente]
Nos [diferenciador unico e defensavel]
```
Definir 3 USPs (quantificavel, defensavel, relevante) + Elevator Pitch 30s.
### Fase 3: Objectivos (OKRs Framework)
Definir 3-4 Objectives com Key Results mensuraveis por trimestre.
**Metricas North Star:**
- MRR (Monthly Recurring Revenue)
- NPS (Net Promoter Score): > 50
- LTV/CAC: > 3x
### Fase 4: Marketing Mix Digital
Canais organizados por funnel stage:
| Fase | Canais Principais | % Budget |
|------|-------------------|----------|
| **Awareness (ToFu)** | SEO/Content, Social Organico, Paid Display | 80% |
| **Consideration (MoFu)** | Email Nurturing, Webinars, Retargeting | 20% |
| **Conversion (BoFu)** | Search Ads, Landing Pages, Sales Enablement | (incluso acima) |
| **Retention** | Customer Success, Email, Community, Referral | (organico) |
### Fase 5: Execucao e Optimizacao
**Roadmap Trimestral:**
- **Mes 1**: Fundacao -- Setup (Pixel, Analytics, CRM), Content pillar #1, Ads inicial
- **Mes 2**: Teste -- Content pillar #2, A/B test landing pages, Escalar winning ads
- **Mes 3**: Optimizacao -- Content pillar #3, guest posts, Webinar, Review + planeamento
**Dashboards:**
- **Semanal (Operacional)**: MQLs, CAC, traffic, ad spend, top channel
- **Mensal (Tactico)**: SQLs, customers novos, MRR, churn, LTV/CAC
- **Trimestral (Estrategico)**: OKRs progress, market share, brand awareness, NPS
---
## Ferramentas Recomendadas
### Pesquisa e Analise
- Google Trends, SimilarWeb, SparkToro, AnswerThePublic
### Planning e Colaboracao
- Notion, Miro, Asana/Monday
### Analytics e Reporting
- Google Analytics 4, Mixpanel, Looker Studio
---
## References (conteudo detalhado)
| Ficheiro | Conteudo |
|----------|----------|
| `references/frameworks-estrategicos.md` | Templates SWOT, Porter, Segmentacao, ICP, Posicionamento, OKRs |
| `references/marketing-mix-orcamento.md` | Canais por funil, orcamentos (startup/scale-up/enterprise), growth hacking, template plano executivo, KPIs |
---
## Anti-Patterns
- Estrategia sem dados de mercado reais
- Segmentacao demasiado generica (todos sao target)
- Objectivos sem metricas mensuraveis
- Budget sem priorizacao por canal
- Ignorar retention e advocacy (so focar aquisicao)
- Plano sem timeline e responsaveis
---
**Versao:** 2.1.0 | **Autor:** Descomplicar
---
## Healing Log
Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
```jsonl
{"date":"","issue":"","fix":"","source":"user|auto"}
```
*Adicionar nova linha após cada erro corrigido.*
marketing/skills/marketing-strategy/references/frameworks-estrategicos.md
+156
View File
@@ -0,0 +1,156 @@
# Frameworks Estrategicos
## Fase 1: Analise de Situacao (Research)
### 1.1 Analise de Mercado
```markdown
Tamanho e Crescimento:
- TAM (Total Addressable Market): XXXM EUR
- SAM (Serviceable Available Market): XXXM EUR
- SOM (Serviceable Obtainable Market): XXXM EUR
- CAGR (Taxa Crescimento): X%/ano
Tendencias:
- [Tendencia 1 relevante]
- [Tendencia 2 relevante]
- [Oportunidade/Ameaca]
Barreiras Entrada:
- Capital inicial: XX EUR
- Regulacao: [Licencas necessarias]
- Know-how tecnico: [Nivel complexidade]
```
### 1.2 Analise Concorrencia (Porter's 5 Forces)
```markdown
Rivalidade Actual:
- Principais players: [TOP 3 concorrentes]
- Market share: [% mercado]
- Posicionamento: [Como se posicionam]
Ameaca Novos Entrantes: BAIXA / MEDIA / ALTA
Poder Negocial Fornecedores: BAIXO / MEDIO / ALTO
Poder Negocial Clientes: BAIXO / MEDIO / ALTO
Ameaca Substitutos: BAIXA / MEDIA / ALTA
```
### 1.3 Analise Interna (SWOT)
```markdown
Strengths (Forcas):
- [Vantagem competitiva 1]
- [Recurso unico 2]
Weaknesses (Fraquezas):
- [Limitacao 1]
- [Gap recursos 2]
Opportunities (Oportunidades):
- [Tendencia mercado 1]
- [Nicho nao explorado 2]
Threats (Ameacas):
- [Concorrente novo 1]
- [Mudanca regulacao 2]
```
---
## Fase 2: Segmentacao e Targeting
```markdown
**Segmentos Mercado (3-5 maximo):**
Segmento A: [Nome Descritivo]
- Demografia: Idade, genero, localizacao, rendimento
- Psicografica: Valores, interesses, comportamentos
- Tamanho: X% mercado, XXXM EUR
- Dor principal: [Problema especifico]
- Solucao actual: [Como resolvem hoje]
- Willingness to pay: XX-YY EUR
**Priorizacao (Reach/Revenue/Resources):**
| Segmento | Reach | Revenue | Resources | Score | Prioridade |
|----------|-------|---------|-----------|-------|------------|
| A | 8/10 | 9/10 | 7/10 | 24/30 | 1o |
| B | 6/10 | 7/10 | 8/10 | 21/30 | 2o |
| C | 4/10 | 5/10 | 6/10 | 15/30 | 3o |
**ICP (Ideal Customer Profile) - Segmento prioritario:**
B2B:
- Industria: [Sector especifico]
- Tamanho empresa: [No colaboradores / receita]
- Localizacao: [Geografia]
- Decision makers: [Cargos que compram]
- Pain points: [3 principais dores]
- Budget: [Range investimento]
- Ciclo venda: [Tempo medio decisao]
B2C:
- Idade: [Range]
- Localizacao: [Cidades principais]
- Rendimento: [Range]
- Educacao: [Nivel]
- Interesses: [Hobbies, valores]
- Pain points: [3 principais dores]
- Budget: [Gasto tipico]
```
---
## Fase 2.2: Posicionamento (Framework 4C)
```markdown
**Positioning Statement:**
Para [target audience especifico]
Que [tem este problema/necessidade]
O [produto/servico] e [categoria]
Que [beneficio principal unico]
Ao contrario de [alternativa/concorrente]
Nos [diferenciador unico e defensavel]
**Diferenciadores (USPs):**
1. [USP #1 - Quantificavel]
2. [USP #2 - Defensavel]
3. [USP #3 - Relevante]
**Mensagem Core (Elevator Pitch - 30 segundos):**
[2 frases que captam atencao e comunicam valor unico]
```
---
## Fase 3: Objectivos (OKRs Framework)
```markdown
**Q1 2026 OKRs:**
Objective 1: Dominar Aquisicao de Clientes B2B
- KR1: 150 SQLs (Sales Qualified Leads) por mes
- KR2: CAC (Customer Acquisition Cost) < 800 EUR
- KR3: Conversion Rate SQL->Customer > 15%
- Owner: [Nome]
Objective 2: Estabelecer Lideranca de Pensamento
- KR1: 50K visitas organicas/mes (blog + SEO)
- KR2: 10K seguidores LinkedIn (empresa)
- KR3: 5 guest posts em media tier-1
- Owner: [Nome]
Objective 3: Optimizar Funil de Conversao
- KR1: Landing page CVR 8% (actual: 3.5%)
- KR2: Email nurturing open rate > 35%
- KR3: Demo show-up rate > 70%
- Owner: [Nome]
**Metricas North Star:**
- MRR (Monthly Recurring Revenue): XXK EUR
- NPS (Net Promoter Score): > 50
- LTV/CAC: > 3x
```
marketing/skills/marketing-strategy/references/marketing-mix-orcamento.md
+191
View File
@@ -0,0 +1,191 @@
# Marketing Mix e Orcamento
## Canais por Funnel Stage
```
AWARENESS (ToFu)
-- SEO / Content Marketing (40% budget)
- Blog posts (2x/semana)
- Guias/Ebooks (1x/mes)
- Videos YouTube (1x/semana)
-- Social Media Organico (20% budget)
- LinkedIn (5x/semana)
- Instagram (3x/semana)
- TikTok (experimental, 2x/semana)
-- Paid Ads - Display/Video (20% budget)
- Google Display
- YouTube Ads
- Meta Ads (Awareness)
CONSIDERATION (MoFu)
-- Email Nurturing (5% budget)
- Welcome series (5 emails)
- Educational series
- Case studies
-- Webinars/Lives (5% budget)
- 1x/mes tema especifico
- Recording -> lead magnet
-- Retargeting (10% budget)
- Google Ads Remarketing
- Meta Ads Retargeting
CONVERSION (BoFu)
-- Search Ads (High-intent keywords)
-- Landing Pages Optimizadas
-- Sales Enablement (Case studies, demos)
-- Free Trial/Demo (reduzir friccao)
RETENTION e ADVOCACY
-- Customer Success (Onboarding, training)
-- Email Marketing (Updates, tips, upsell)
-- Community (Grupo privado, eventos)
-- Referral Program (Incentivos)
```
## Orcamento por Canal
### Startup (< 5.000 EUR/mes)
```
40% Content/SEO -> 2.000 EUR
30% Paid Ads -> 1.500 EUR
20% Social Organico -> 1.000 EUR
10% Tools -> 500 EUR
```
### Scale-up (5.000-20.000 EUR/mes)
```
30% Paid Ads -> 6.000 EUR
25% Content/SEO -> 5.000 EUR
20% Social/Influencers -> 4.000 EUR
15% Email/Automation -> 3.000 EUR
10% Tools/Agency -> 2.000 EUR
```
### Enterprise (> 20.000 EUR/mes)
```
Full mix com especialistas dedicados por canal
Budget flexivel baseado em performance (ROAS > 3x manter/escalar)
```
---
## Growth Hacking Tactics 2026
### Quick Wins (Implementar 1a semana)
1. **Lead Magnet Irresistivel**
Template/Calculadora/Checklist gratis
-> Captura email -> Nurturing sequence
2. **Referral Program**
"Indica amigo, ambos ganham X% desconto"
-> Viral loop
3. **Content Upgrade**
CTA in-content: "Descarrega versao PDF completa"
-> Converte readers em leads
4. **Exit-Intent Popup**
"Antes de saires... 10% desconto primeira compra"
-> Recupera 2-5% abandonos
5. **Retargeting Agressivo**
Visitantes website ultimos 30 dias
-> Ads personalizados produto visualizado
### Growth Loops (Sustentaveis)
```
Loop 1: Content -> SEO -> Traffic -> Conversao -> Case Study -> Content
[Composto anual: 20-30% crescimento organico]
Loop 2: Customer -> Referral -> New Customer -> Repeat
[CAC reduz 40% com referrals]
Loop 3: User -> UGC (User Generated Content) -> Social Proof -> New User
[Trust aumenta CVR 15-25%]
```
---
## Template Plano Marketing Executivo
```markdown
# Plano Marketing [Empresa] - Q1 2026
## 1. Executive Summary (1 pagina)
- Situacao actual
- Objectivo principal
- Investimento necessario
- ROI esperado
## 2. Analise de Situacao (2-3 paginas)
### Mercado
- Tamanho: XXXM EUR
- Crescimento: X%/ano
- Tendencias: [3 principais]
### Concorrencia
- Player 1: [Posicionamento, forcas/fraquezas]
- Player 2: [...]
- Player 3: [...]
### SWOT
[Matriz 2x2 visual]
## 3. Estrategia (2 paginas)
### Segmentacao
[Segmentos identificados + priorizacao]
### Posicionamento
[Positioning statement + USPs]
### Mensagem Core
[Elevator pitch + mensagens secundarias]
## 4. Objectivos (1 pagina)
### OKRs Q1
[3-4 objectives com key results mensuraveis]
## 5. Tacticas (3-4 paginas)
### Canais Escolhidos
[Canal 1]: Objectivo, accoes, budget, KPIs
[Canal 2]: ...
[Canal 3]: ...
### Calendario Editorial
[Grid mes a mes com tipos conteudo]
## 6. Orcamento (1 pagina)
| Canal | Budget Mensal | % Total |
|-------|---------------|---------|
| SEO/Content | X EUR | 40% |
| Paid Ads | X EUR | 30% |
| Social | X EUR | 20% |
| Tools | X EUR | 10% |
| **TOTAL** | **X EUR** | **100%** |
## 7. Timeline e Milestones (1 pagina)
[Gantt chart trimestral]
## 8. Metricas e Reporting (1 pagina)
- Dashboard link
- Frequencia reports (semanal/mensal)
- Responsaveis por metrica
```
---
## KPIs por Objectivo
| Objectivo | KPIs | Target | Ferramenta |
|-----------|------|--------|------------|
| **Awareness** | Reach, Impressions, Brand Search | Crescer 20%/trim | Google Analytics, Google Trends |
| **Engagement** | Time on Site, Pages/Session, Social Engagement | ToS > 3min | GA, Social Analytics |
| **Lead Gen** | MQLs, SQLs, Cost per Lead | CPL < 50 EUR | CRM (HubSpot, Pipedrive) |
| **Conversion** | CVR, CAC, Revenue | CVR > 3%, CAC < 800 EUR | CRM + Analytics |
| **Retention** | Churn Rate, NPS, LTV | Churn < 5%, NPS > 50 | CRM, Surveys |
marketing/skills/seo-audit/SKILL.md
+175
View File
@@ -0,0 +1,175 @@
---
name: seo-audit
description: Auditoria SEO completa com recomendacoes de optimizacao. Analisa SEO tecnico, conteudo, backlinks e desempenho.
layer: wiki
---
# SEO Audit - Auditoria Completa
Skill para realizar auditorias SEO completas usando o stack de ferramentas instalado. Best practices 2026.
---
## Contexto NotebookLM
ANTES de executar, consultar notebook para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Marketing Digital PT | `4c595973` | Sempre |
```
mcp__notebooklm__notebook_query({
notebook_id: "4c595973-ba10-420a-a3bf-e4389e424ad3",
query: "<adaptar ao contexto — ex: auditoria SEO tecnico, Core Web Vitals, backlinks, E-E-A-T>"
})
```
**Procedimento relacionado:** `PROC-DMARC-Email-Entregabilidade.md` -- consultar quando a auditoria envolve email deliverability.
---
## Quando Usar
- Auditar um site completo (tecnico + conteudo + performance)
- Verificar Core Web Vitals e ranking factors
- Analisar backlinks e autoridade de dominio
- Obter dados reais do Google Search Console
- Identificar oportunidades de optimizacao
- Comparar com concorrencia
---
## Google Updates 2026
### Core Algorithm Updates
| Update | Data | Impacto |
|--------|------|---------|
| **Helpful Content Q1** | Jan 2026 | Penaliza conteudo AI de baixa qualidade |
| **Core Web Vitals 3.0** | Mar 2026 | INP substitui FID, thresholds mais rigorosos |
| **E-E-A-T Focus** | Q1-Q2 | Experiencia pratica obrigatoria |
| **Mobile-First Index** | Universal | 100% dos sites |
### Novos Ranking Factors 2026
1. **INP (Interaction to Next Paint)** -- Bom: < 200ms | Medio: 200-500ms | Mau: > 500ms
2. **E-E-A-T** -- Autor identificado com bio, credenciais verificaveis, experiencia real
3. **Page Experience Signals** -- HTTPS obrigatorio, intrusive interstitials penalizados
---
## Workflow de Auditoria Completa
### Passo 1: Analise Tecnica Basica (3 min)
```
1. SEO Tools API -> /seo-audit -> Meta tags, headings, estrutura HTML
2. SEO Tools API -> /page-speed-analyzer -> Velocidade, sugestoes
3. Lighthouse -> run_audit -> Performance, SEO, Accessibility scores
```
**Checklist Critico:**
- [ ] Meta title (50-60 chars)
- [ ] Meta description (150-160 chars)
- [ ] H1 unico com keyword
- [ ] Canonical URL definido
- [ ] Robots.txt acessivel
- [ ] Sitemap.xml presente
- [ ] HTTPS activo
- [ ] Mobile-friendly
### Passo 2: Core Web Vitals (2 min)
```
1. Lighthouse -> get_core_web_vitals -> LCP, INP, CLS (mobile + desktop)
2. Lighthouse -> compare_mobile_desktop -> Identificar gaps
3. Lighthouse -> get_lcp_opportunities -> Sugestoes optimizacao
```
**Thresholds 2026:**
| Metrica | Bom | Necessita Melhoria | Mau |
|---------|-----|-------------------|-----|
| **LCP** | < 2.5s | 2.5-4s | > 4s |
| **INP** | < 200ms | 200-500ms | > 500ms |
| **CLS** | < 0.1 | 0.1-0.25 | > 0.25 |
### Passo 3: Analise de Conteudo (3 min)
```
1. SEO Tools API -> /content-optimization -> On-page SEO, keyword density
2. SEO Tools API -> /internal-linking -> Estrutura links internos
3. SEO Ahrefs -> keyword_generator -> Keywords relacionadas, volume, KD
```
**Checklist E-E-A-T:**
- [ ] Autor identificado com bio
- [ ] Credenciais verificaveis
- [ ] Data publicacao/actualizacao
- [ ] Fontes citadas (links externos autoritativos)
- [ ] Experiencia real demonstrada
### Passo 4: Backlinks e Autoridade (2 min)
```
1. SEO Tools API -> /backlink-checker -> Backlinks basicos, DR/UR
2. SEO Ahrefs -> get_backlinks_list -> Lista detalhada (DR, anchor text)
3. SEO Ahrefs -> get_traffic -> Trafego estimado mensal
```
**Metricas Autoridade:**
- **DR (Domain Rating)**: 0-100 (forca backlink profile)
- **UR (URL Rating)**: 0-100 (forca pagina especifica)
- **Backlinks**: Quantidade + qualidade (DR > 30)
- **Referring Domains**: Numero de dominios unicos
### Passo 5: Dados Reais GSC (3 min)
```
1. GSC -> get_search_analytics -> Queries, impressoes, CTR real (ultimos 90 dias)
2. GSC -> check_indexing_issues -> Problemas de indexacao
3. GSC -> get_sitemaps -> Status sitemaps submetidos
```
**Metricas GSC a Analisar:**
- **Impressoes vs Cliques**: CTR medio > 2%
- **Posicao media**: Top 3 para keywords principais
- **Cobertura**: % paginas indexadas vs submetidas
- **Mobile Usability**: Erros especificos mobile
### Passo 6: Concorrencia (opcional, 2 min)
```
SEO Tools API -> /competitor-analysis -> Comparar com 2-3 concorrentes
- Keywords gap
- Backlinks gap
- Content gap
```
---
## Propriedades GSC Disponiveis
```
sc-domain:descomplicar.pt
https://emanuelalmeida.pt/
https://carstuff.pt/
https://solarfvengenharia.com/
https://aquisevende.pt/
https://alojadamaria.com/
https://e-commerce.descomplicar.pt/
```
---
## Notas Importantes
### Requisitos
- **SEO Tools API** deve estar a correr: `~/mcp-servers/seo-tools-api/start.sh`
- **GSC** requer autenticacao OAuth na primeira utilizacao
- **GA** requer ADC credentials configuradas
### Limitacoes
- Ahrefs API tem rate limiting (100 req/day free tier)
- GSC data maxi
marketing/skills/seo-audit/references/ferramentas-api.md
+94
View File
@@ -0,0 +1,94 @@
# Ferramentas e APIs - SEO Audit
## 1. SEO Tools API (http://localhost:3000)
```bash
# Auditoria basica
curl "http://localhost:3000/seo-audit?url=URL"
# Velocidade PageSpeed Insights style
curl "http://localhost:3000/page-speed-analyzer?url=URL"
# Backlinks + DR/UR
curl "http://localhost:3000/backlink-checker?url=URL"
# Rankings para keywords
curl "http://localhost:3000/rank-checker?url=URL&keywords=keyword1,keyword2"
# Optimizacao conteudo on-page
curl "http://localhost:3000/content-optimization?url=URL"
# Internal linking structure
curl "http://localhost:3000/internal-linking?url=URL"
# Sitemap XML generator
curl "http://localhost:3000/sitemap-generator?url=URL"
# Analise concorrencia
curl "http://localhost:3000/competitor-analysis?url=URL&competitors=site1.com,site2.com"
```
## 2. Lighthouse MCP
| Tool | Funcao | Output |
|------|--------|--------|
| `run_audit(url)` | Auditoria completa | Performance, SEO, A11y, Best Practices |
| `get_performance_score(url)` | Score performance | 0-100 |
| `get_core_web_vitals(url)` | LCP, INP, CLS | Mobile + Desktop |
| `get_accessibility_score(url)` | Acessibilidade | 0-100 + issues |
| `get_seo_analysis(url)` | Analise SEO tecnico | Meta, headings, indexabilidade |
| `get_security_audit(url)` | Seguranca | HTTPS, mixed content, headers |
| `compare_mobile_desktop(url)` | Comparacao | Diferencas performance |
| `get_lcp_opportunities(url)` | Optimizacoes LCP | Preload, lazy load |
| `find_unused_javascript(url)` | JS nao usado | Tamanhos, % savings |
## 3. SEO Ahrefs MCP (via API)
| Tool | Funcao | Dados |
|------|--------|-------|
| `get_backlinks_list(domain)` | Lista backlinks | DR, UR, anchor text |
| `keyword_generator(keyword, country)` | Ideias keywords | Volume, KD, CPC |
| `get_traffic(domain)` | Trafego estimado | Visitas mensais, keywords |
| `keyword_difficulty(keyword)` | Dificuldade keyword | 0-100 (KD score) |
## 4. Google Search Console MCP
| Tool | Funcao | Dados Reais |
|------|--------|-------------|
| `list_properties` | Listar sites verificados | URLs properties |
| `get_search_analytics(site, period)` | Queries, cliques, CTR | Ultimos 16 meses |
| `inspect_url_enhanced(site, url)` | Inspeccionar URL | Indexacao, mobile usability |
| `check_indexing_issues(site, urls)` | Problemas indexacao | Erros, avisos |
| `get_sitemaps(site)` | Listar sitemaps | Status, URLs submetidos |
## 5. Google Analytics MCP
| Tool | Funcao | Metricas |
|------|--------|----------|
| `get_account_summaries` | Listar contas | Properties disponiveis |
| `run_report(property, metrics, dimensions)` | Relatorio custom | Sessions, users, bounce rate |
| `run_realtime_report(property)` | Tempo real | Utilizadores activos now |
## Propriedades GSC Disponiveis
```
sc-domain:descomplicar.pt
https://emanuelalmeida.pt/
https://carstuff.pt/
https://solarfvengenharia.com/
https://aquisevende.pt/
https://alojadamaria.com/
https://e-commerce.descomplicar.pt/
```
## Requisitos
- **SEO Tools API** deve estar a correr: `~/mcp-servers/seo-tools-api/start.sh`
- **GSC** requer autenticacao OAuth na primeira utilizacao
- **GA** requer ADC credentials configuradas (`gcloud auth application-default login`)
## Limitacoes
- Ahrefs API tem rate limiting (100 req/day free tier)
- GSC data maximo: 16 meses historico
- Lighthouse scores variam +/- 5 pontos entre execucoes (network dependent)
marketing/skills/seo-audit/references/template-relatorio-auditoria.md
+195
View File
@@ -0,0 +1,195 @@
# Template Relatorio Auditoria SEO
```markdown
# Relatorio SEO - [DOMINIO]
**Data:** YYYY-MM-DD
**Versao:** 2.0 (2026 Standards)
---
## Resumo Executivo
| Metrica | Valor | Status |
|---------|-------|--------|
| **Score Geral** | X/100 | Bom / Medio / Critico |
| **Core Web Vitals** | LCP Xs | INP Xms | CLS X | OK / Aviso / Critico |
| **Backlinks** | X (DR: X) | Bom / Medio / Fraco |
| **Problemas Criticos** | X | Lista abaixo |
---
## 1. Analise Tecnica
### Meta Tags
- **Title**: [OK/NOK] - [Conteudo]
- **Description**: [OK/NOK] - [Conteudo]
- **Canonical**: [OK/NOK]
- **Open Graph**: [OK/NOK]
### Headings Structure
```
H1: [Texto] OK
H2: [Texto] OK
H3: [Texto] OK
H2: [Texto] Aviso (Sem keyword)
```
### Velocidade
- **Mobile**: X/100 - [LCP Xs | INP Xms | CLS X]
- **Desktop**: X/100 - [LCP Xs | INP Xms | CLS X]
- **Bloqueio Principal**: [JS/CSS/Imagens]
---
## 2. Core Web Vitals
### Comparacao Mobile vs Desktop
| Metrica | Mobile | Desktop | Diferenca |
|---------|--------|---------|-----------|
| LCP | X.Xs | X.Xs | +X.X% |
| INP | Xms | Xms | +X% |
| CLS | X | X | +X% |
### Oportunidades LCP
1. **Preload imagem hero** - Savings: X KB
2. **Lazy load below-fold** - Savings: X KB
3. **Optimizar servidor**: TTFB > 600ms
### Oportunidades INP
1. **Reduzir JS nao usado**: X KB (X% savings)
2. **Code splitting**: Carregar so necessario
3. **Web Workers**: Tarefas pesadas off main thread
---
## 3. Conteudo e E-E-A-T
### On-Page SEO
| Factor | Status | Nota |
|--------|--------|------|
| Keyword no title | OK / NOK | |
| Keyword no H1 | OK / NOK | |
| Keyword primeiros 100 chars | OK / NOK | |
| Alt text imagens | OK / Aviso / NOK | X/Y com alt |
| Internal linking | OK / Aviso / NOK | X links internos |
| External links | OK / Aviso / NOK | X links autoritativos |
### E-E-A-T Score
| Criterio | Status | Observacao |
|----------|--------|------------|
| Autor identificado | OK / NOK | |
| Bio com credenciais | OK / NOK | |
| Data publicacao | OK / NOK | |
| Experiencia demonstrada | OK / NOK | |
| Fontes citadas | OK / NOK | X links externos |
---
## 4. Backlinks e Autoridade
### Perfil de Links
| Metrica | Valor | Benchmark |
|---------|-------|-----------|
| **Domain Rating (DR)** | X | > 30 bom |
| **URL Rating (UR)** | X | > 20 bom |
| **Backlinks Totais** | X | |
| **Referring Domains** | X | > 50 bom |
| **DoFollow vs NoFollow** | X% / X% | > 60% DoFollow ideal |
### Top 5 Backlinks
| Dominio | DR | Anchor Text | DoFollow |
|---------|-----|-------------|----------|
| site1.com | 75 | [Texto] | Sim |
| ... | ... | ... | ... |
### Oportunidades
1. **Guest posts** em sites DR > 40
2. **Broken link building** (X links quebrados encontrados)
3. **Recuperar mencoes nao linkadas** (X mencoes)
---
## 5. Search Console (Dados Reais)
### Performance Ultimos 90 Dias
| Metrica | Valor | Variacao vs periodo anterior |
|---------|-------|------------------------------|
| **Cliques** | X | +X% / -X% |
| **Impressoes** | X | +X% / -X% |
| **CTR Medio** | X% | +X pp |
| **Posicao Media** | X | +X / -X |
### Top 10 Queries
| Query | Cliques | Impressoes | CTR | Posicao |
|-------|---------|------------|-----|---------|
| query1 | X | X | X% | X |
| ... | ... | ... | ... | ... |
### Oportunidades CTR
- **Posicao 4-10, CTR < 5%**: Optimizar meta description
- **Posicao 11-20**: Targets faceis para top 10
- **Alta impressao, baixo CTR**: Melhorar title/description
### Indexacao
| Estado | Paginas | Accao Necessaria |
|--------|---------|------------------|
| Indexadas | X | - |
| Excluidas | X | Investigar |
| Erros | X | Corrigir urgente |
---
## 6. Recomendacoes Prioritarias
### Critico (Fazer AGORA)
1. [ ] **[Problema]** - [Impacto] - [Solucao]
2. [ ] **[Problema]** - [Impacto] - [Solucao]
### Importante (Fazer esta semana)
1. [ ] **[Problema]** - [Impacto] - [Solucao]
2. [ ] **[Problema]** - [Impacto] - [Solucao]
### Melhoria (Fazer este mes)
1. [ ] **[Problema]** - [Impacto] - [Solucao]
2. [ ] **[Problema]** - [Impacto] - [Solucao]
---
## Roadmap Optimizacao (Q1-Q2 2026)
### Mes 1: Fundacao Tecnica
- [ ] Corrigir todos os problemas criticos
- [ ] Optimizar Core Web Vitals (target: All green)
- [ ] Implementar E-E-A-T basico (autor, datas, bio)
### Mes 2: Conteudo e Autoridade
- [ ] Actualizar conteudo underperforming (posicao 11-20)
- [ ] Criar conteudo para keywords gap vs concorrencia
- [ ] Campanha backlinks (target: +10 DR > 30)
### Mes 3: Consolidacao e Escala
- [ ] Monitorizar rankings e ajustar
- [ ] Expandir internal linking
- [ ] Criar cluster de conteudo para keywords principais
---
## Ferramentas Utilizadas
- SEO Tools API (localhost:3000)
- Lighthouse MCP
- SEO Ahrefs MCP
- Google Search Console MCP
- Google Analytics MCP (opcional)
---
**Proxima Auditoria**: [Data + 3 meses]
```
marketing/skills/seo-content-optimization/SKILL.md
+169
View File
@@ -0,0 +1,169 @@
---
name: seo-content-optimization
description: Optimizacao de conteudo para motores de busca. Melhora conteudo existente com palavras-chave, estrutura e legibilidade.
layer: wiki
---
# SEO Content Optimization
Skill para optimizacao SEO tecnico e de conteudo com standards Google 2026.
---
## Contexto NotebookLM
ANTES de executar, consultar notebook para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Marketing Digital PT | `4c595973` | Sempre |
```
mcp__notebooklm__notebook_query({
notebook_id: "4c595973-ba10-420a-a3bf-e4389e424ad3",
query: "<adaptar ao contexto — ex: SEO on-page, keyword research, E-E-A-T, Core Web Vitals>"
})
```
**Procedimento relacionado:** `PROC-DMARC-Email-Entregabilidade.md` -- consultar quando o contexto SEO envolve email deliverability.
---
## Quando Usar
- Optimizar paginas para motores de busca
- Implementar meta tags e structured data
- Melhorar Core Web Vitals
- Fazer keyword research
- Auditar SEO on-page
- Implementar E-E-A-T (Experience, Expertise, Authoritativeness, Trust)
---
## E-E-A-T 2026
| Factor | 2024-2025 | **2026 Standards** |
|--------|-----------|-----|
| **Experience** | Sugerido | **Obrigatorio** - Demonstracao de experiencia real |
| **Expertise** | Credenciais | Credenciais **verificaveis** (LinkedIn, certificacoes) |
| **Authoritativeness** | Backlinks | Backlinks + **mencoes media** + **citacoes academicas** |
| **Trust** | HTTPS | HTTPS + **About page completo** + **Contactos reais** |
**Impacto:** Sites sem E-E-A-T perderam -15% a -40% trafego organico Q1 2026.
### Helpful Content Update Q1 2026
**Penalizacoes Automaticas:**
- Conteudo AI sem edicao humana: -30% rankings
- Keyword stuffing (densidade > 3%): -50% rankings
- Thin content (< 300 palavras): Desindexacao
- Conteudo duplicado: Canibalizacao severa
**Boas Praticas:**
- Conteudo original, profundo (> 1200 palavras para topics competitivos)
- Multiplos formatos (texto + imagem + video)
- Actualizacao regular (timestamp visivel)
---
## Heading Structure (Hierarquia Correcta)
```html
<!-- CORRECTO: Hierarquia logica -->
<h1>Titulo Principal da Pagina (1 por pagina, keyword principal)</h1>
<h2>Seccao 1 (keyword secundaria)</h2>
<h3>Sub-seccao 1.1</h3>
<h3>Sub-seccao 1.2</h3>
<h2>Seccao 2 (keyword secundaria)</h2>
<!-- ERRADO: Saltar niveis -->
<h1>Titulo</h1>
<h4>Sub-titulo</h4> <!-- Saltou H2 e H3 -->
```
**Boas Praticas 2026:**
- H1: Unica, 60-70 chars, keyword principal
- H2: Keywords secundarias, variacoes LSI
- H3-H6: Long-tail keywords, questoes especificas
- Incluir numeros quando possivel ("7 Formas de...", "Top 10...")
---
## On-Page SEO Checklist 2026
### Conteudo
- [ ] Keyword no titulo (primeiros 60 chars)
- [ ] Keyword no H1 (unica vez)
- [ ] Keyword nos primeiros 100 caracteres
- [ ] Keywords secundarias em H2/H3
- [ ] LSI keywords distribuidas naturalmente
- [ ] Conteudo > 1200 palavras (topics competitivos)
- [ ] Keyword density 1-2% (nao > 3%)
### Autor e E-E-A-T
- [ ] **Autor identificado** (nome + foto)
- [ ] **Bio autor** (credenciais, experiencia)
- [ ] **Data publicacao + ultima actualizacao**
- [ ] **Experiencia real demonstrada** (exemplos, casos)
- [ ] Links para perfis autor (LinkedIn, Twitter)
### Media
- [ ] Alt text descritivo em TODAS as imagens
- [ ] Imagens optimizadas (WebP, < 200KB)
- [ ] Video embed (aumenta tempo na pagina)
- [ ] Infograficos (linkable assets)
### Links
- [ ] 3-5 internal links relevantes
- [ ] 1-3 external links para fontes autoritativas
- [ ] Anchor text descritivo (nao "clique aqui")
- [ ] Links abrem em nova tab (external)
### Tecnico
- [ ] URL amigavel (curto, keyword, sem parametros)
- [ ] Meta description unica (150-160 chars)
- [ ] Canonical URL definido
- [ ] Open Graph completo
- [ ] Schema.org implementado
- [ ] Mobile-friendly validado
- [ ] HTTPS activo
- [ ] Core Web Vitals green
### Engagement
- [ ] CTA claro (call-to-action)
- [ ] FAQ section (featured snippets)
- [ ] Formulario/contacto
- [ ] Social share buttons
---
## Anti-Patterns SEO 2026
| Anti-Pattern | Penalizacao 2026 | Solucao |
|--------------|------------------|---------|
| **Keyword stuffing** (> 3%) | -50% rankings | Escrita natural, 1-2% |
| **Conteudo duplicado** | Canibalizacao | Canonical, consolidar |
| **Meta descriptions iguais** | Menos impressoes | Unica por pagina |
| **Imagens sem alt** | -10% accessibility | Alt descritivo |
| **JavaScript-only content** | Nao indexado | SSR/SSG |
| **Redirect chains** | Timeout, bounce | Redirect directo |
| **Thin content** (< 300 palavras) | Desindexacao | Min 800 palavras |
| **Conteudo AI nao editado** | -30% rankings | Edicao humana |
| **Links comprados** | Penalizacao manual | Earn links, guest posts |
| **Hidden text** | Desindexacao | Texto visivel |
---
## Ferramentas Recomendadas
### Validacao
- **Google Search Console** - Monitorizacao, indexacao
- **PageSpeed Insights** - Core Web Vitals
- **Schema Validator**
marketing/skills/seo-content-optimization/references/structured-data.md
+270
View File
@@ -0,0 +1,270 @@
# /seo-content-optimization - Structured Data e Meta Tags
## Meta Tags Essenciais 2026
```html
<!-- Title tag (50-60 caracteres) -->
<title>Keyword Principal | Nome Marca 2026</title>
<!-- Meta description (150-160 caracteres, CTA claro) -->
<meta name="description" content="Descrição apelativa com keyword, benefício claro e CTA subtil. Actualizado 2026.">
<!-- Canonical URL -->
<link rel="canonical" href="https://site.pt/pagina/">
<!-- Open Graph -->
<meta property="og:title" content="Título para Social (60 chars)">
<meta property="og:description" content="Descrição social (65 palavras max)">
<meta property="og:image" content="https://site.pt/og-image.jpg">
<meta property="og:url" content="https://site.pt/pagina/">
<meta property="og:type" content="article">
<!-- Twitter Card -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Título Twitter">
<meta name="twitter:description" content="Descrição Twitter">
<meta name="twitter:image" content="https://site.pt/twitter-image.jpg">
<!-- 2026: Article metadata -->
<meta property="article:published_time" content="2026-02-03T10:00:00Z">
<meta property="article:modified_time" content="2026-02-03T15:30:00Z">
<meta property="article:author" content="Nome Autor">
```
---
## Structured Data (Schema.org) 2026
### Organization (Homepage)
```json
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Nome Empresa",
"url": "https://site.pt",
"logo": "https://site.pt/logo.png",
"sameAs": [
"https://linkedin.com/company/...",
"https://facebook.com/...",
"https://instagram.com/..."
],
"contactPoint": {
"@type": "ContactPoint",
"telephone": "+351-XXX-XXX-XXX",
"contactType": "Customer Service",
"areaServed": "PT",
"availableLanguage": ["pt", "en"]
}
}
```
### Article/BlogPosting (E-E-A-T compliant)
```json
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Título do Artigo",
"author": {
"@type": "Person",
"name": "Nome Autor",
"url": "https://site.pt/autor/nome",
"jobTitle": "Especialista em...",
"knowsAbout": ["Área 1", "Área 2"]
},
"publisher": {
"@type": "Organization",
"name": "Nome Empresa",
"logo": {
"@type": "ImageObject",
"url": "https://site.pt/logo.png"
}
},
"datePublished": "2026-02-03",
"dateModified": "2026-02-03",
"image": "https://site.pt/imagem.jpg",
"wordCount": 1500,
"inLanguage": "pt-PT"
}
```
### FAQPage (featured snippets)
```json
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "Pergunta completa?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Resposta completa e detalhada (min 40 palavras para snippets)."
}
}
]
}
```
### HowTo Schema (rich results 2026)
```json
{
"@context": "https://schema.org",
"@type": "HowTo",
"name": "Como fazer X",
"description": "Guia completo passo a passo",
"totalTime": "PT30M",
"step": [
{
"@type": "HowToStep",
"name": "Passo 1",
"text": "Descrição detalhada passo 1",
"image": "https://site.pt/passo1.jpg"
}
]
}
```
### Review/Rating Schema (produtos)
```json
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Nome Produto",
"brand": { "@type": "Brand", "name": "Nome Marca" },
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "4.8",
"reviewCount": "127"
},
"offers": {
"@type": "Offer",
"price": "95.00",
"priceCurrency": "EUR",
"availability": "https://schema.org/InStock"
}
}
```
---
## Core Web Vitals 2026
| Métrica | Bom | Necessita Melhoria | Mau | Mudança 2026 |
|---------|-----|-------------------|-----|--------------|
| **LCP** | < 2.5s | 2.5-4s | > 4s | Threshold < 2.0s Q2 |
| **INP** | < 200ms | 200-500ms | > 500ms | Substituiu FID em Jan 2026 |
| **CLS** | < 0.1 | 0.1-0.25 | > 0.25 | Sem mudanças |
### Optimizações LCP
```html
<!-- Preload imagem hero -->
<link rel="preload" as="image" href="/hero.jpg" fetchpriority="high">
<!-- Lazy loading imagens below-fold -->
<img src="image.jpg" loading="lazy" alt="Descrição">
<!-- Responsive images -->
<img srcset="small.jpg 480w, medium.jpg 800w, large.jpg 1200w"
sizes="(max-width: 600px) 480px, (max-width: 1000px) 800px, 1200px"
src="large.jpg" alt="Descrição">
<!-- WebP format -->
<picture>
<source srcset="image.webp" type="image/webp">
<img src="image.jpg" alt="Descrição">
</picture>
```
### Optimizações INP (novo 2026)
```javascript
// Debounce event handlers
function debounce(func, wait) {
let timeout;
return function executedFunction(...args) {
clearTimeout(timeout);
timeout = setTimeout(() => func(...args), wait);
};
}
// Code splitting
const component = () => import('./HeavyComponent.js');
// Web Workers para tarefas pesadas
const worker = new Worker('worker.js');
worker.postMessage({ task: 'heavy-computation', data });
```
### Optimizações CLS
```css
/* Definir width/height em imagens */
img {
width: 800px;
height: 600px;
aspect-ratio: 4 / 3;
}
/* Reservar espaço para ads */
.ad-container { min-height: 250px; }
/* Font loading */
@font-face {
font-family: 'Custom Font';
src: url('/font.woff2') format('woff2');
font-display: swap;
}
```
---
## URL Structure Best Practices
```
CORRECTO:
https://site.pt/categoria/keyword-principal/
https://site.pt/blog/como-fazer-energia-solar-2026/
ERRADO:
https://site.pt/p?id=123&cat=5&lang=pt
https://site.pt/este-url-e-muito-longo-com-muitas-palavras-desnecessarias/
```
**Regras 2026:**
- Máximo 60 caracteres
- Hífens (não underscores)
- Lowercase
- Keyword no início se possível
- Sem stop words quando possível
---
## Keyword Research
### Ferramentas
| Ferramenta | Uso | Métricas |
|------------|-----|----------|
| Google Keyword Planner | Volume, CPC | Volume mensal, competição |
| Ahrefs | KD, SERP analysis | Keyword Difficulty, DR necessário |
| Semrush | Concorrência | Gap analysis, trending |
| AnswerThePublic | Long-tail questions | Questões reais utilizadores |
| Google Trends | Sazonalidade | Tendência temporal |
### Keyword Difficulty Benchmarks
| KD | Dificuldade | DR Necessário |
|----|-------------|---------------|
| 0-20 | Muito Fácil | < 20 |
| 21-40 | Fácil | 20-35 |
| 41-60 | Médio | 35-50 |
| 61-80 | Difícil | 50-70 |
| 81-100 | Muito Difícil | > 70 |
**Estratégia:** Começar por KD 0-40, escalar para 41-60 após DR > 35.
marketing/skills/seo-report/SKILL.md
+159
View File
@@ -0,0 +1,159 @@
---
name: seo-report
description: Relatorio de auditoria SEO completo com Lighthouse, Google Search Console e exportacao para Google Docs. Analisa Core Web Vitals, desempenho, SEO on-page e gera recomendacoes accionaveis.
layer: wiki
---
# Skill: /seo-report
Gera relatorio SEO completo com dados de multiplas fontes e exporta automaticamente para Google Docs.
---
## Contexto NotebookLM
ANTES de executar, consultar notebook para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Marketing Digital PT | `4c595973` | Sempre |
```
mcp__notebooklm__notebook_query({
notebook_id: "4c595973-ba10-420a-a3bf-e4389e424ad3",
query: "<adaptar ao contexto — ex: auditoria SEO, relatorio performance, recomendacoes tecnicas>"
})
```
**Procedimento relacionado:** `PROC-DMARC-Email-Entregabilidade.md` -- consultar quando o relatorio envolve email deliverability.
---
## Trigger
`/seo-report <url>` ou `/seo-report <url> <email_destino>`
---
## Exemplos
```bash
# Relatorio basico (envia para emanuelalmeidaa@gmail.com)
/seo-report https://descomplicar.pt
# Relatorio para cliente especifico
/seo-report https://cliente.pt cliente@email.com
# Relatorio com analise concorrencia
/seo-report https://site.pt --competitors=concorrente1.pt,concorrente2.pt
```
---
## Fontes de Dados
| Fonte | Dados Recolhidos | Tempo |
|-------|------------------|-------|
| **Lighthouse (Desktop)** | Performance, SEO, Accessibility, Best Practices | ~30s |
| **Lighthouse (Mobile)** | Core Web Vitals, INP, comparacao mobile/desktop | ~30s |
| **Lighthouse (Optimizacoes)** | Oportunidades LCP, JS nao usado, images optimization | ~15s |
| **GSC** | Cliques, impressoes, CTR, posicao media, top queries, tendencia 90 dias | ~10s |
| **SEO Tools API** | Meta tags, imagens, alt text, links internos/externos, estrutura HTML | ~5s |
| **Ahrefs (opcional)** | DR, UR, backlinks, referring domains | ~10s |
**Tempo Total:** ~1m40s (sem concorrencia) | ~3m (com 2 concorrentes)
---
## Workflow
1. Validar URL de entrada
2. Verificar se site esta no GSC (skip se nao)
3. Executar auditorias em paralelo:
- Lighthouse Desktop + Mobile
- Core Web Vitals
- SEO Tools API
- GSC Analytics (se disponivel)
- Ahrefs (se habilitado)
4. Processar e formatar dados
5. Gerar relatorio Markdown
6. Criar Google Doc e partilhar
7. Retornar link do documento
---
## Estrutura do Relatorio
O relatorio final tem 8 seccoes:
1. **Sumario Executivo** -- Top 5 descobertas + accao imediata recomendada
2. **Pontuacoes Globais** -- Desktop vs Mobile (Performance, SEO, A11y, Best Practices)
3. **Core Web Vitals** -- LCP, INP, CLS com oportunidades de optimizacao
4. **GSC Analytics** -- Performance overview, top queries, oportunidades CTR (ultimos 90 dias)
5. **Analise On-Page** -- Meta tags, imagens SEO, internal linking
6. **Backlinks e Autoridade** -- DR, UR, top backlinks, estrategia
7. **Plano de Accao** -- Priorizado (critico/importante/melhoria) com impacto e esforco
8. **Roadmap Trimestral** -- Fundacao tecnica -> Conteudo e autoridade -> Consolidacao
---
## Propriedades GSC Disponiveis
```
sc-domain:descomplicar.pt
https://emanuelalmeida.pt/
https://carstuff.pt/
https://solarfvengenharia.com/
https://aquisevende.pt/
https://alojadamaria.com/
https://e-commerce.descomplicar.pt/
```
---
## Notas Tecnicas
### Requisitos
- SEO Tools API a correr: `~/mcp-servers/seo-tools-api/start.sh`
- Google Workspace MCP configurado
- GSC authentication (OAuth primeira vez)
### Erros Comuns
- **Site nao em GSC:** Relatorio gerado sem dados GSC (aviso incluido)
- **Lighthouse timeout:** Retry automatico (3x)
- **Ahrefs rate limit:** Skip backlinks, aviso no relatorio
---
## References (conteudo detalhado)
| Ficheiro | Conteudo |
|----------|----------|
| `references/template-relatorio.md` | Template completo do relatorio com todas as tabelas e seccoes |
| `references/implementacao-tecnica.md` | Workflow mermaid, codigo JS, funcoes GSC, notas tecnicas |
---
## Anti-Patterns
- Gerar relatorio sem dados reais (sempre usar MCPs)
- Ignorar gap mobile/desktop
- Nao priorizar recomendacoes (tudo parece igual)
- Esquecer de verificar se site esta no GSC antes de tentar recolher dados
- Relatorio sem accoes concretas e estimativas de impacto
---
**Versao:** 2.1.0 | **Autor:** Descomplicar
---
## Healing Log
Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
```jsonl
{"date":"","issue":"","fix":"","source":"user|auto"}
```
*Adicionar nova linha após cada erro corrigido.*
marketing/skills/seo-report/references/implementacao-tecnica.md
+144
View File
@@ -0,0 +1,144 @@
# Implementacao Tecnica - SEO Report
## Workflow Tecnico
```mermaid
graph LR
A[Input: URL] --> B{Site em GSC?}
B -->|Sim| C[Recolher dados GSC]
B -->|Nao| D[Skip GSC, aviso]
C --> E[Lighthouse Desktop]
D --> E
E --> F[Lighthouse Mobile]
F --> G[Core Web Vitals]
G --> H[SEO Tools API]
H --> I{Ahrefs habilitado?}
I -->|Sim| J[Recolher DR/UR]
I -->|Nao| K[Skip Ahrefs]
J --> L[Processar dados]
K --> L
L --> M[Gerar relatorio Markdown]
M --> N[Criar Google Doc]
N --> O[Partilhar com email]
O --> P[Retornar link]
```
## Implementacao
```javascript
async function generateSEOReport(url, options = {}) {
const {
email = 'emanuelalmeidaa@gmail.com',
competitors = [],
includeAhrefs = true
} = options;
// 1. Validar URL
if (!isValidURL(url)) {
throw new Error('URL invalido');
}
// 2. Recolher dados em paralelo (melhor performance)
const [
lighthouseDesktop,
lighthouseMobile,
coreWebVitals,
seoToolsData,
gscData,
ahrefsData
] = await Promise.allSettled([
mcp__lighthouse__run_audit(url, 'desktop'),
mcp__lighthouse__run_audit(url, 'mobile'),
mcp__lighthouse__get_core_web_vitals(url),
fetch(`http://localhost:3000/seo-audit?url=${url}`).then(r => r.json()),
getGSCData(url),
includeAhrefs ? getAhrefsData(url) : null
]);
// 3. Processar e formatar
const reportData = {
url,
date: new Date().toISOString().split('T')[0],
scores: extractScores(lighthouseDesktop, lighthouseMobile),
cwv: processCoreWebVitals(coreWebVitals),
gsc: processGSCData(gscData),
onPage: processOnPageData(seoToolsData),
backlinks: processBacklinks(ahrefsData),
recommendations: generateRecommendations(/* all data */)
};
// 4. Gerar documento Markdown
const markdown = generateReportMarkdown(reportData);
// 5. Criar Google Doc
const docResult = await mcp__google-workspace__create_doc({
title: `Relatorio SEO - ${extractDomain(url)} - ${reportData.date}`,
body_content: markdown,
user_google_email: email
});
// 6. Retornar link
return {
success: true,
doc_url: docResult.url,
summary: reportData.recommendations.slice(0, 5)
};
}
```
## Propriedades GSC Disponiveis
```javascript
const GSC_PROPERTIES = [
'sc-domain:descomplicar.pt',
'https://emanuelalmeida.pt/',
'https://carstuff.pt/',
'https://solarfvengenharia.com/',
'https://aquisevende.pt/',
'https://alojadamaria.com/',
'https://e-commerce.descomplicar.pt/'
];
async function getGSCData(url) {
const domain = extractDomain(url);
const property = GSC_PROPERTIES.find(p => p.includes(domain));
if (!property) {
console.warn(`Site ${domain} nao esta no GSC. Dados GSC nao disponiveis.`);
return null;
}
const analytics = await mcp__gsc__get_search_analytics({
site_url: property,
start_date: daysAgo(90),
end_date: 'today',
dimensions: ['query'],
row_limit: 100
});
return analytics;
}
```
## Notas Tecnicas
### Requisitos
- SEO Tools API a correr: `~/mcp-servers/seo-tools-api/start.sh`
- Google Workspace MCP configurado
- GSC authentication (OAuth primeira vez)
### Performance
- Execucao paralela de tools (1m40s total)
- Cache Lighthouse results (5 min TTL)
- Rate limiting Ahrefs API (100 req/day free)
### Erros Comuns
- **Site nao em GSC:** Relatorio gerado sem dados GSC
- **Lighthouse timeout:** Retry automatico (3x)
- **Ahrefs rate limit:** Skip backlinks, aviso no relatorio
marketing/skills/seo-report/references/template-relatorio.md
+220
View File
@@ -0,0 +1,220 @@
# Template Relatorio SEO
```markdown
# Relatorio SEO - [DOMINIO]
Data: YYYY-MM-DD | Versao 2.0 (2026 Standards)
---
## Sumario Executivo
**Principais Descobertas (Top 5):**
1. [Critico] Core Web Vitals - INP > 500ms (target < 200ms)
2. [Importante] E-E-A-T - Sem autor identificado em 80% dos artigos
3. [Melhoria] CTR GSC - Posicao 4-10 com CTR < 3%
4. [Oportunidade] 15 keywords posicao 11-20 (easy wins)
5. [Accao Imediata] 47 imagens sem alt text (SEO + A11y)
**Accao Imediata Recomendada:**
> Optimizar INP removendo 350KB JS nao usado (-40% bundle size)
> ROI esperado: Posicao media +2 ranks, CTR +0.8pp
---
## 1. Pontuacoes Globais
### Desktop vs Mobile
| Metrica | Desktop | Mobile | Gap | Target 2026 |
|---------|---------|--------|-----|-------------|
| **Performance** | 85/100 | 62/100 | -23 | > 90 |
| **SEO** | 92/100 | 88/100 | -4 | > 95 |
| **Accessibility** | 78/100 | 78/100 | 0 | > 90 |
| **Best Practices** | 95/100 | 92/100 | -3 | > 95 |
**Analise Gap Mobile:** Dispositivos moveis representam 75% do trafego. Gap de -23 pontos e critico.
---
## 2. Core Web Vitals
### Comparacao Mobile vs Desktop
| Metrica | Mobile | Desktop | Threshold 2026 | Status |
|---------|--------|---------|----------------|--------|
| **LCP** | 2.8s | 1.9s | < 2.5s | -- |
| **INP** | 520ms | 180ms | < 200ms | -- |
| **CLS** | 0.08 | 0.05 | < 0.1 | -- |
### Oportunidades LCP
| Oportunidade | Savings | Prioridade |
|--------------|---------|------------|
| Preload imagem hero | 1.2s | Critico |
| Lazy load below-fold (15 imagens) | 800ms | Alto |
| Optimizar TTFB (servidor response) | 400ms | Alto |
| Comprimir imagens WebP (85% quality) | 600ms | Medio |
### Oportunidades INP
| Oportunidade | Savings | Prioridade |
|--------------|---------|------------|
| Remover JS nao usado (350KB) | 280ms | Critico |
| Code splitting (carregar on-demand) | 180ms | Alto |
| Defer third-party scripts | 120ms | Alto |
| Optimizar event listeners | 80ms | Medio |
---
## 3. GSC Analytics (Ultimos 90 dias)
### Performance Overview
| Metrica | Valor | vs 90 dias anteriores | Tendencia |
|---------|-------|------------------------|-----------|
| **Cliques** | 12,450 | +18% (+1,890) | Subida |
| **Impressoes** | 245,800 | +22% (+44,300) | Subida |
| **CTR Medio** | 5.1% | -0.3pp | Descida |
| **Posicao Media** | 12.8 | +2.1 (pior) | Descida |
### Top 10 Queries
| Query | Cliques | Impr. | CTR | Pos. | Oportunidade |
|-------|---------|-------|-----|------|--------------|
| [keyword 1] | 850 | 15,200 | 5.6% | 8.2 | Optimizar para top 5 |
| [keyword 2] | 720 | 9,800 | 7.3% | 4.5 | Manter |
| [keyword 3] | 680 | 22,400 | 3.0% | 14.8 | Melhorar CTR + posicao |
| ... | ... | ... | ... | ... | ... |
---
## 4. Analise On-Page
### Meta Tags Audit
| Pagina | Title | Description | Issues |
|--------|-------|-------------|--------|
| Homepage | OK 58 chars | Longo 175 chars | Description > 160 chars |
| /servicos | OK 52 chars | OK 155 chars | - |
| /blog/[slug] | Curto 28 chars | Duplicado (5 paginas) | Title curto, description duplicada |
### Imagens SEO
| Metrica | Valor | Target | Status |
|---------|-------|--------|--------|
| **Total Imagens** | 127 | - | - |
| **Com Alt Text** | 80 (63%) | 100% | Critico |
| **Alt Text Descritivo** | 52 (41%) | 100% | Critico |
| **Formato WebP** | 15 (12%) | > 80% | Critico |
| **Lazy Loading** | 45 (35%) | 100% (below-fold) | Medio |
### Internal Linking
| Metrica | Valor | Benchmark |
|---------|-------|-----------|
| **Links Internos Medios/Pagina** | 8.5 | > 10 bom |
| **Orphan Pages** | 3 | 0 ideal |
| **Broken Internal Links** | 7 | 0 |
| **Anchor Text Optimizado** | 42% | > 70% |
---
## 5. Backlinks e Autoridade
### Perfil de Dominio
| Metrica | Valor | Benchmark | Status |
|---------|-------|-----------|--------|
| **Domain Rating (DR)** | 32 | > 40 bom | -- |
| **URL Rating (UR) Medio** | 18 | > 25 bom | -- |
| **Backlinks Totais** | 1,247 | - | - |
| **Referring Domains** | 87 | > 100 bom | -- |
| **DoFollow** | 68% | > 60% | OK |
### Top 10 Backlinks (por DR)
| Dominio | DR | Anchor Text | DoFollow | Tipo |
|---------|-----|-------------|----------|------|
| [site DR alto] | 58 | [anchor] | Sim | Editorial |
| ... | ... | ... | ... | ... |
---
## 6. Benchmarks vs Concorrencia
| Metrica | [Site] | Concorrente A | Concorrente B | Gap |
|---------|--------|---------------|---------------|-----|
| DR | 32 | 45 | 38 | -13 |
| Traffic Estimado | 12.5K/mes | 28K/mes | 18K/mes | -15.5K |
| Ranking Keywords | 450 | 820 | 610 | -370 |
| Backlinks | 1,247 | 3,200 | 2,100 | -1,953 |
---
## 7. Plano de Accao (Priorizado)
### Critico (Semana 1-2)
| Accao | Impacto Estimado | Esforco | ROI |
|-------|------------------|---------|-----|
| **Optimizar INP Mobile** | Posicao media +2, CTR +0.8pp | 8h | Alto |
| **Adicionar alt text imagens** | Acessibilidade +15 pontos, SEO +5% | 3h | Alto |
| **Corrigir links internos quebrados** | UX, crawl efficiency +10% | 1h | Medio |
| **Reescrever meta descriptions** (CTR baixo) | CTR +1.2pp estimado | 2h | Alto |
### Importante (Semana 3-4)
| Accao | Impacto Estimado | Esforco | ROI |
|-------|------------------|---------|-----|
| **Optimizar keywords posicao 11-20** | +1,200 cliques/mes | 12h | Medio |
| **Implementar E-E-A-T** | Trust signals, rankings +5% | 6h | Medio |
| **Internal linking orphan pages** | Indexabilidade, link equity | 2h | Medio |
| **Converter imagens WebP** | LCP -600ms | 4h | Medio |
### Melhoria (Mes 2-3)
| Accao | Impacto Estimado | Esforco | ROI |
|-------|------------------|---------|-----|
| **Criar conteudo keywords gap** (3 artigos) | +2K visitas/mes | 20h | Medio |
| **Campanha backlinks DR > 40** (6 guest posts) | DR +5, autoridade | 30h | Baixo |
| **Optimizar structured data** | Rich snippets, CTR +0.5pp | 6h | Baixo |
---
## 8. Roadmap Trimestral
### Mes 1: Fundacao Tecnica
- Semana 1-2: Criticos (INP, alt text, links quebrados, meta descriptions)
- Semana 3-4: Importantes (keywords 11-20, E-E-A-T, orphan pages)
### Mes 2: Conteudo e Autoridade
- Criar artigos keywords gap
- Guest posts DR > 40
- Optimizar artigos existentes (posicao 11-30)
### Mes 3: Consolidacao e Escala
- Monitorizar rankings e ajustar on-page
- Guest posts adicionais
- Expandir internal linking (cluster content)
- Actualizar conteudo underperforming
---
## Anexos
### A. Metodologia
- Lighthouse: 3 runs, mediana reportada
- GSC: Ultimos 90 dias completos
- Thresholds: Google 2026 Standards
### B. Glossario
- **DR**: Domain Rating (Ahrefs)
- **INP**: Interaction to Next Paint (substitui FID em 2026)
- **E-E-A-T**: Experience, Expertise, Authoritativeness, Trust
- **CTR**: Click-Through Rate
---
**Proxima Auditoria Recomendada:** [Data + 3 meses]
**Contacto Suporte:** recursos@descomplicar.pt
```
marketing/skills/social-media/SKILL.md
+165
View File
@@ -0,0 +1,165 @@
---
name: social-media
description: Estrategia e gestao de conteudo para redes sociais. Planeia publicacoes, calendario de conteudo e tacticas de engagement.
layer: wiki
---
# /social-media
Gestao completa e estrategia de redes sociais com best practices 2026.
---
## Contexto NotebookLM
ANTES de executar, consultar notebook para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Social Media e Branding | `9053d0e8` | Sempre |
```
mcp__notebooklm__notebook_query({
notebook_id: "9053d0e8-dd39-460b-b5ea-e67af3e9a675",
query: "<adaptar ao contexto — ex: estrategia Instagram, LinkedIn B2B, TikTok crescimento>"
})
```
---
## Quando Usar
- Redes sociais, social media
- Instagram, Facebook, LinkedIn, TikTok
- Posts, stories, reels, engagement
- Calendario editorial, content plan
---
## Plataformas - Resumo 2026
| Plataforma | Formato Prioritario | Alcance Organico | Melhor Para |
|------------|---------------------|------------------|-------------|
| **Instagram** | Reels (3-5x alcance) | 50-200% (Reels) | B2C, visual, crescimento |
| **LinkedIn** | Posts nativos + PDF | 2-5% impressoes | B2B, authority, leads |
| **Facebook** | Reels + Grupos | 2-5% fans (baixo) | Community, ads |
| **TikTok** | Video 21-34s | Muito alto (todos) | Viralidade, jovens |
Detalhes completos de dimensoes, algoritmos e formatos em `references/plataformas-formatos.md`.
---
## Calendario Editorial 2026
### Frequencia Recomendada
| Plataforma | Minimo | Ideal | Formato Prioritario |
|------------|--------|-------|---------------------|
| **Instagram** | 3x/semana feed + 5x stories | 5x/semana feed + diario stories | Reels (3x/semana) |
| **LinkedIn** | 2x/semana | 4x/semana | Posts nativos + 1 carrossel/semana |
| **Facebook** | 2x/semana | 3x/semana | Reels + Grupos activos |
| **TikTok** | 3x/semana | Diario | Videos curtos (21-34s) |
### Melhores Horarios Portugal (2026)
| Plataforma | B2C | B2B |
|------------|-----|-----|
| **Instagram** | 12h-13h, 19h-21h | 8h-9h, 12h-13h |
| **LinkedIn** | - | 8h-10h, 12h-13h, 17h-18h (Ter/Qua/Qui) |
| **Facebook** | 13h-14h, 16h-17h, 20h-21h | 9h-11h, 12h-14h |
| **TikTok** | 18h-22h (prime time) | 12h-14h, 18h-20h |
---
## Tipos de Conteudo (Regra 70/20/10)
```
70% VALOR (Educacao, Entretenimento, Inspiracao)
-- 40% Educativo: How-to, tips, insights, dados
-- 25% Entretenimento: Memes, trends, behind scenes
-- 5% Inspiracional: Quotes, success stories
20% ENGAGEMENT (Conversacao)
-- Perguntas abertas, polls, quizzes
-- User-generated content
-- Responder comentarios (conteudo)
10% PROMOCIONAL (Vendas)
-- Produtos/servicos, ofertas especiais
-- CTAs directos, testemunhos clientes
```
### Content Pillars (3-5 por marca)
Exemplo agencia marketing:
1. **Dicas Praticas** (40%) - "Como crescer no Instagram"
2. **Behind the Scenes** (25%) - Bastidores projectos
3. **Casos de Sucesso** (20%) - Resultados clientes
4. **Tendencias** (10%) - Novidades marketing
5. **Ofertas** (5%) - Servicos e promocoes
---
## Metricas Chave por Plataforma
### Instagram
| Metrica | Benchmark | Accao |
|---------|-----------|-------|
| **Reach** | > 2x followers | Aumentar Reels |
| **Engagement Rate** | > 5% | Melhorar conteudo |
| **Saves** | > 5% alcance | Conteudo save-worthy |
| **Shares** | > 3% alcance | Conteudo shareable |
| **Followers Growth** | +5-10%/mes | Consistencia |
### LinkedIn
| Metrica | Benchmark | Accao |
|---------|-----------|-------|
| **Impressions** | > 10x connections | Postar horarios optimos |
| **Engagement Rate** | > 3% impressoes | Conteudo provocativo/valioso |
| **Comments** | > 1% impressoes | Perguntas abertas |
| **Profile Views** | +10-20%/mes | Actividade consistente |
---
## Ferramentas Recomendadas 2026
| Categoria | Ferramentas |
|-----------|-------------|
| **Design** | Canva Pro, Adobe Express, CapCut, InShot |
| **Agendamento** | Buffer, Hootsuite, Later, Meta Business Suite |
| **Hashtags** | Display Purposes, All Hashtag, Hashtagify |
| **Analytics** | Iconosquare, Sprout Social, Phlanx |
---
## References (conteudo detalhado)
| Ficheiro | Conteudo |
|----------|----------|
| `references/plataformas-formatos.md` | Dimensoes, algoritmos e formatos detalhados por plataforma |
| `references/estrategias-crescimento.md` | Estrategias Instagram/LinkedIn/TikTok, hashtags, engagement hacks |
---
## Anti-Patterns
- Mesmo conteudo em todas as plataformas (sem adaptar formato)
- Postar sem consistencia (sporadic vs regular)
- Ignorar engagement nos primeiros 60 minutos
- Excesso de conteudo promocional (> 10%)
- Nao adaptar horarios ao publico-alvo
- Usar hashtags sem estrategia (ou excessivas no LinkedIn)
---
**Versao:** 2.1.0 | **Autor:** Descomplicar
---
## Media Bank (D7-MB-001)
**Quando consultar:** antes de criar posts Instagram, carrosséis, stories ou posts LinkedIn/Facebook que precisem de imagem ou vídeo curto. Reutiliza matéria-prima já curada em vez de gerar do zero.
**Workflow tentativa-p
marketing/skills/social-media/references/estrategias-crescimento.md
+180
View File
@@ -0,0 +1,180 @@
# Estrategias de Crescimento por Plataforma
## Instagram (Reels-First Strategy)
### Fase 1: 0-1K Followers (2-3 meses)
**Conteudo:**
- 5 Reels/semana (foco crescimento)
- 2 Posts carousel/semana (valor, save-worthy)
- Stories diario (engagement, polls, perguntas)
**Optimizacao:**
- Hook primeiros 1-2 segundos
- Legendas longas (SEO Instagram)
- 15-20 hashtags mix (grandes, medias, nicho)
- Geolocalizacao Portugal
- Trending audio (usar biblioteca Instagram)
**Engagement:**
- Comentar 20-30 posts nicho/dia (genuino)
- Responder 100% comentarios primeiros 60 min
- DM colaboracoes (contas 500-5K followers)
**KPIs:**
- Alcance > 2x followers
- Saves > 5% alcance
- Shares > 3% alcance
- 50-100 novos followers/semana
### Fase 2: 1K-10K Followers (3-6 meses)
**Conteudo:**
- Replicar top 10 Reels (formato + topic)
- Criar serie/formato signature
- Collaborations com contas similares (5-20K)
**Monetizacao Inicio:**
- Afiliados (Amazon, nicho especifico)
- Digital products (ebooks, templates)
- 1-1 services
**KPIs:**
- Alcance > 5x followers
- Engagement rate > 8%
- 200-500 novos followers/semana
---
## LinkedIn (Authority Building)
**Conteudo Alto Valor:**
1. **Personal Insights** (3x/semana)
- Experiencia real, licoes aprendidas
- Contrarian opinions (educadas)
- Dados/estudos com interpretacao
2. **Carrosseis PDF** (1x/semana)
- Guias, frameworks, checklists
- 5-10 slides, design clean
- Download gratuito (lead magnet)
3. **Engagement Posts** (1x/semana)
- Perguntas abertas audiencia
- Polls sobre tendencias industria
- Pedir opinioes/experiencias
**Optimizacao:**
- Primeira linha hook (cabe em preview)
- Espacamento paragrafos (legibilidade)
- Emojis estrategicos (nao excessivo B2B)
- Tag pessoas relevantes (nao spam)
**Network Growth:**
- Conectar 10-20 pessoas/dia (nicho)
- Comentar insights posts influencers
- Partilhar conteudo outros (com opiniao)
**KPIs:**
- Impressions > 10x connections
- Engagement rate > 5%
- 50-100 novos connections/semana
- 1-2 inbound leads/semana (>10K connections)
---
## TikTok (Viralidade)
**Formato Winning:**
1. **Hook Primeiro Segundo**
- Visual surpreendente
- Texto "Nao vais acreditar..."
- Jump cut imediato
2. **Duracao 21-34s**
- Sweet spot retention
- Rewatch provavel
3. **Trending Sounds**
- Usar audio viral (biblioteca TikTok)
- Adicionar twist original
4. **Legendas Completas**
- 80% views sem som
- Texto on-screen legivel
**Estrategia Posting:**
- 1-3x/dia (algoritmo favorece)
- Testar formatos diferentes
- Acompanhar TikTok Creative Center (trends)
**Cross-Promote:**
- Reutilizar TikToks como Reels Instagram
- Editar para cada plataforma (remover watermark)
**KPIs TikTok:**
- Completion rate > 80%
- Rewatches > 20%
- 1-3% viewers -> followers
---
## Hashtag Strategy 2026
### Instagram (15-20 Hashtags)
**Estrutura:**
- **Grandes (1M+ posts):** 2-3 -- alcance baixo, competicao alta
- **Medias (100K-1M posts):** 5-7 -- sweet spot
- **Nicho (10K-100K posts):** 5-7 -- alcance alto, target especifico
- **Branded (< 10K posts):** 2-3 -- branding
**Placement:** Primeiro comentario (nao caption) ou quebra linha caption.
**Rodar sets:** Criar 5-7 sets diferentes para evitar shadowban.
### LinkedIn (3-5 Hashtags MAX)
- 1 broad (#marketing)
- 2 especificas (#b2bmarketing, #leadgeneration)
- 1-2 trending (ver LinkedIn trending)
- Placement: Final do post
---
## Engagement Hacks 2026
### Formulas Comentarios que Convertem
1. **Pergunta Aberta** (fim caption)
"Qual destas estrategias ja testaste? Conta nos comentarios"
2. **Tag Amigo** (Instagram/Facebook)
"Tag alguem que precisa ver isto"
3. **Opiniao Controversial**
"80% das empresas fazem isto errado. Concordas?"
4. **Prompt Especifico**
"Comenta VAMOS se queres receber o template gratuito"
### Responder Comentarios (Aumenta Alcance)
SEMPRE responder primeiros 60 minutos.
**Tecnica:**
- Resposta com pergunta (continua conversa)
- Nao so "Obrigado" (engagement count)
- Tag autor se relevante
### Stories Engagement (Instagram)
**Ferramentas Interactivas:**
- Polls: "Qual preferes? A ou B?"
- Quiz: "Sabias que...? Verdadeiro ou Falso"
- Perguntas: "Qual a tua maior duvida em X?"
- Slider: "De 0 a 100, quanto concordas?"
- Link: Adesivo link
**Frequencia:** 5-10 stories/dia (mantem top-of-mind)
marketing/skills/social-media/references/plataformas-formatos.md
+62
View File
@@ -0,0 +1,62 @@
# Plataformas e Formatos 2026
## Instagram
| Formato | Dimensoes | Duracao | Uso | Alcance Medio |
|---------|-----------|---------|-----|---------------|
| **Feed** | 1080x1080 (1:1) ou 1080x1350 (4:5) | - | Conteudo evergreen | 10-20% followers |
| **Stories** | 1080x1920 (9:16) | 15s/slide | Daily engagement, polls | 5-10% followers |
| **Reels** | 1080x1920 (9:16) | 15-90s | Crescimento, viral | 50-200% followers |
| **Carrossel** | 1080x1080 cada | Ate 10 | Tutoriais, antes/depois | 15-25% followers |
| **IGTV/Video** | 1080x1920 ou 1080x1080 | Ate 60 min | Long-form conteudo | 5-15% followers |
**Algoritmo 2026:**
- Reels tem 3-5x mais alcance que posts estaticos
- Primeiros 30 minutos criticos (engagement boost)
- Shares > Saves > Comments > Likes (ordem importancia)
- Tempo visualizacao > numero likes
## LinkedIn
| Formato | Dimensoes | Extensao | Uso | Engagement B2B |
|---------|-----------|----------|-----|----------------|
| **Post Imagem** | 1200x627 ou 1080x1080 | - | Insights, dicas | 2-5% impressoes |
| **Carrossel PDF** | 1080x1080 | Ate 300 slides | Guias, infograficos | 3-8% impressoes |
| **Video** | 1920x1080 (16:9) | Ate 10 min | Tutoriais, interviews | 5-10% impressoes |
| **Article** | - | 1000-2000 palavras | Thought leadership | 1-3% impressoes |
| **Poll** | - | 2-4 opcoes | Engagement rapido | 10-20% impressoes |
**Algoritmo 2026:**
- Primeiros 60 minutos criticos (engage early)
- Comments com +10 palavras pesam 3x mais
- Posts nativos > links externos
- Dwell time (tempo leitura) factor chave
## Facebook
| Formato | Dimensoes | Uso | Alcance Organico 2026 |
|---------|-----------|-----|----------------------|
| **Post** | 1200x630 | Updates, promos | 2-5% fans (muito baixo) |
| **Stories** | 1080x1920 | Daily content | 5-10% fans |
| **Reels** | 1080x1920 | Crescimento | 20-50% fans |
| **Cover** | 820x312 (desktop), 640x360 (mobile) | Branding | - |
| **Grupos** | - | Community building | 50-80% membros |
**Alcance Organico 2026:**
- Posts normais: 2-5% fans (forcar ads)
- Reels: Unico formato com alcance organico decente
- Grupos: Melhor alternativa para engagement
## TikTok
| Formato | Dimensoes | Duracao | Uso | Potencial Viral |
|---------|-----------|---------|-----|-----------------|
| **Video** | 1080x1920 (9:16) | 15s a 10 min | Tudo | Muito Alto |
| **Duracao Ideal** | - | 21-34s | Max retention | - |
| **Lives** | 1080x1920 | Ate 60 min | Community | Alto engagement |
**Algoritmo TikTok 2026:**
- TODOS os videos testados (nao precisa seguidores)
- Completions > Likes (assistir ate final)
- Re-watches contam 2x
- Primeiras 3 horas criticas
marketing/skills/trend-signal/SKILL.md
+115
View File
@@ -0,0 +1,115 @@
---
name: trend-signal
category: marketing
description: "Obtem sinais de mercado em tempo real via X/Grok com scoring matrix. Trend intelligence sem APIs pagas. Usar quando 'tendencias', 'trend', 'sinais mercado', 'social listening', 'X grok', 'conteudo trending'."
version: "1.0.0"
created: 2026-04-07
tools: [mcp__claude-in-chrome__tabs_create_mcp, mcp__claude-in-chrome__read_page, mcp__claude-in-chrome__form_input, mcp__claude-in-chrome__computer]
layer: wiki
---
# Skill: /trend-signal
Obtem sinais de mercado em tempo real via X/Grok com scoring matrix. Baseado em #365 Jack Roberts.
---
## Pre-requisitos
- Utilizador autenticado no X (twitter.com) no Chrome
- Chrome acessivel via MCP (claude-in-chrome)
---
## Processo
### 1. Perguntar contexto
Antes de pesquisar, perguntar ao utilizador:
- **Sector/industria:** (ex: marketing digital, saude, e-commerce)
- **Palavras-chave especificas:** (ex: claude code, n8n, WordPress)
- **Objectivo:** (ex: ideias conteudo, inteligencia competitiva, tendencias tecnologia)
### 2. Abrir X e interagir com Grok
1. `mcp__claude-in-chrome__tabs_create_mcp` — abrir `https://x.com/i/grok`
2. Enviar prompt ao Grok via `form_input`:
```
Preciso de tendencias dos ultimos 7 dias sobre [SECTOR/KEYWORDS].
Para cada tendencia encontrada, indica:
1. Titulo/topico
2. Fonte (conta X, link)
3. Data de publicacao
4. Numero de interaccoes aproximado
5. Porque e relevante
Prioriza por:
- Recency (ultimos 7 dias)
- Authority (contas com mais seguidores)
- Velocity (crescimento rapido)
- Engagement (likes, retweets, replies)
Lista as top 10 tendencias.
```
3. Ler resposta via `read_page`
### 3. Scoring matrix
Para cada sinal retornado, calcular score:
| Factor | Peso | 1 | 3 | 5 |
|--------|------|---|---|---|
| **Premacy** | 25% | >7 dias | 3-7 dias | <3 dias |
| **Authority** | 25% | <1K followers | 1K-50K | >50K |
| **Velocity** | 25% | Estavel | Crescimento moderado | Viral |
| **Relevance** | 25% | Tangencial | Relacionado | Directamente relevante |
Score total = soma ponderada (max 20).
### 4. Output
Gerar tabela markdown:
```markdown
## Trend Signal Report — [DATA]
**Sector:** [sector]
**Keywords:** [keywords]
| # | Sinal | Score | Premacy | Authority | Velocity | Relevance | Fonte |
|---|-------|-------|---------|-----------|----------|-----------|-------|
| 1 | ... | 18/20 | 5 | 4 | 5 | 4 | @conta |
### Angulos de conteudo sugeridos
1. **[Titulo]** — [descricao breve, formato sugerido: artigo/video/post]
2. **[Titulo]** — [descricao]
3. **[Titulo]** — [descricao]
```
### 5. Opcoes pos-analise
Perguntar ao utilizador:
- Guardar relatorio no Hub? (`00-Inbox/trend-signal-YYYY-MM-DD.md`)
- Criar tarefas de conteudo no Desk CRM?
- Agendar proxima execucao via `/schedule`?
---
## Fallback (sem acesso ao X)
Se o Chrome nao tem sessao X activa:
1. Informar o utilizador
2. Oferecer alternativa: pesquisa web via `WebSearch` + `WebFetch` sobre as mesmas keywords
3. Scoring manual baseado em resultados web
---
## Healing Log
```jsonl
{"date":"","issue":"","fix":"","source":"user|auto"}
```
marketing/skills/video/SKILL.md
+209
View File
@@ -0,0 +1,209 @@
---
name: video
description: Criacao de videos profissionais com Remotion (React). Planeia conteudo, scripts e workflows de producao.
layer: wiki
---
# /video - Criacao de Videos com Remotion
Cria videos profissionais usando **Remotion** (React) a partir de descricoes em linguagem natural.
## Contexto NotebookLM
ANTES de executar, consultar notebooks para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Producao de Video e YouTube | `058a896e` | Para planeamento de video |
| Remotion Deep Research | `f2b75baa` | Para implementacao tecnica Remotion |
```
mcp__notebooklm__notebook_query({
notebook_id: "058a896e-6c9a-4e51-ae7d-9adb2738bc5f",
query: "<adaptar ao contexto>"
})
mcp__notebooklm__notebook_query({
notebook_id: "f2b75baa-1ab1-48d3-8f7c-a6a9e516934c",
query: "<adaptar ao contexto>"
})
```
---
## Arquitectura
```
Prompt Natural -> Claude Code -> Codigo React/Remotion -> Video MP4/GIF/WebM
```
| Componente | Funcao |
|------------|--------|
| **Remotion** | Framework React para videos programaticos |
| **Esta Skill** | Ensina Claude a gerar codigo Remotion correcto |
| **Output** | MP4, GIF, WebM em qualquer resolucao |
---
## Projecto Base
```
/media/ealmeida/Dados/Dev/remotion-demo/
```
Ja configurado com Remotion 4.x, Agent Skills, composicao de exemplo e scripts de renderizacao.
---
## Uso Rapido
```bash
# 1. Navegar ao projecto
cd /media/ealmeida/Dados/Dev/remotion-demo
# 2. Descrever o video pretendido ao Claude
"Cria um video de 10 segundos para [empresa] com logo animado e tagline"
# 3. Renderizar
npm run render
# ou
npx remotion render [CompositionName] out/video.mp4
```
### Comandos Disponiveis
| Comando | Descricao |
|---------|-----------|
| `npm run dev` | Abrir Remotion Studio (preview) |
| `npm run render` | Renderizar DemoVideo para MP4 |
| `npm run render:gif` | Renderizar para GIF |
---
## Estrutura de Prompt Recomendada
```
Cria um video de [duracao] segundos para [empresa/proposito] com:
- Resolucao: [1920x1080 / 1080x1920 / 1080x1080]
- FPS: [30 / 60]
- Fundo: [cor solida / gradiente / imagem]
- Sequencia de animacao:
1. [Elemento] [animacao] (frames X-Y)
2. [Elemento] [animacao] (frames X-Y)
- Texto: [titulo, subtitulo, CTA]
- Estilo: [minimalista / corporativo / energetico / elegante]
```
---
## Exemplos de Prompts
### Intro Corporativa
```
Cria um video intro de 5 segundos para "Descomplicar" com:
- Resolucao: 1920x1080, 30fps
- Fundo: gradiente de #1e3a8a para #7c3aed
- Animacao:
1. Logo fade in com bounce (0-45 frames)
2. Tagline "Crescimento Digital" slide up (45-90 frames)
3. Linha decorativa expande (60-120 frames)
- Estilo: profissional e moderno
```
### Reel/Short Vertical
```
Cria um video vertical de 15 segundos para Instagram Reels com:
- Resolucao: 1080x1920, 30fps
- Tema: "5 Dicas de SEO"
- Sequencia:
1. Titulo impactante com zoom (0-30 frames)
2. Dica 1 slide in (30-90 frames)
3. Dica 2 slide in (90-150 frames)
- CTA final: "Segue para mais!"
```
---
## Conceitos Remotion Essenciais
### Timing
- **Frames**: Unidade base (30fps = 30 frames/segundo)
- **useCurrentFrame()**: Frame actual da animacao
- **interpolate()**: Mapear frames para valores (opacity, position, scale)
- **spring()**: Animacoes com fisica (bounce, elastic)
### Componentes Core
```tsx
import {
AbsoluteFill, // Container full-screen
Sequence, // Sequenciar elementos no tempo
useCurrentFrame, // Frame actual
useVideoConfig, // fps, width, height, duration
interpolate, // Interpolacao linear
spring, // Animacao spring
Img, // Imagens
Audio, // Audio
Video, // Video embebido
} from "remotion";
```
### Estrutura de Composicao
```tsx
// src/Root.tsx
<Composition
id="NomeVideo"
component={MeuComponente}
durationInFrames={150} // 5s a 30fps
fps={30}
width={1920}
height={1080}
defaultProps={{ titulo: "Exemplo" }}
/>
```
---
## Opcoes de Renderizacao
### Qualidade
```bash
npx remotion render Video out.mp4 --crf=18 # Alta qualidade (lento)
npx remotion render Video out.mp4 --crf=23 # Qualidade media (rapido)
npx remotion render Video out.mp4 --crf=28 # Baixa qualidade (muito rapido)
```
### Formatos
```bash
npx remotion render Video out.mp4 # MP4 (H.264)
npx remotion render Video out.gif --codec=gif # GIF
npx remotion render Video out.webm --codec=vp8 # WebM
npx remotion render Video out.mov --codec=prores # ProRes
```
### Props Dinamicas
```bash
npx remotion render Video out.mp4 \
--props='{"titulo":"Descomplicar","cor":"#1e3a8a"}'
```
---
## Resolucoes Comuns
| Formato | Resolucao | Uso |
|---------|-----------|-----|
| 16:9 HD | 1920x1080 | YouTube, Website |
| 16:9 4K | 3840x2160 | YouTube 4K |
| 9:16 Vertical | 1080x1920 | Reels, TikTok, Shorts |
| 1:1 Quadrado | 1080x1080 | Instagram Feed |
| 4:5 Portrait | 1080x1350 | Instagram Feed optimal |
-
marketing/skills/video/references/components.md
+274
View File
@@ -0,0 +1,274 @@
# /video - Componentes e Templates Remotion
## Animações Prontas (Copy-Paste)
### Fade In com Scale
```tsx
import { interpolate, useCurrentFrame } from "remotion"
export function FadeInScale({ children }: { children: React.ReactNode }) {
const frame = useCurrentFrame()
const opacity = interpolate(frame, [0, 30], [0, 1], { extrapolateRight: "clamp" })
const scale = interpolate(frame, [0, 30], [0.8, 1], { extrapolateRight: "clamp" })
return (
<div style={{ opacity, transform: `scale(${scale})` }}>
{children}
</div>
)
}
```
### Slide Up
```tsx
export function SlideUp({ children, delay = 0 }: { children: React.ReactNode; delay?: number }) {
const frame = useCurrentFrame()
const y = interpolate(frame, [delay, delay + 20], [50, 0], { extrapolateRight: "clamp" })
const opacity = interpolate(frame, [delay, delay + 20], [0, 1], { extrapolateRight: "clamp" })
return (
<div style={{ opacity, transform: `translateY(${y}px)` }}>
{children}
</div>
)
}
```
### Bounce In (Spring)
```tsx
import { spring, useCurrentFrame, useVideoConfig } from "remotion"
export function BounceIn({ children }: { children: React.ReactNode }) {
const frame = useCurrentFrame()
const { fps } = useVideoConfig()
const scale = spring({
frame,
fps,
config: { damping: 10, stiffness: 200, mass: 0.5 },
})
return (
<div style={{ transform: `scale(${scale})` }}>
{children}
</div>
)
}
```
### Text Reveal (Linha por Linha)
```tsx
export function TextReveal({ lines }: { lines: string[] }) {
const frame = useCurrentFrame()
return (
<div className="space-y-2">
{lines.map((line, i) => {
const delay = i * 15
const opacity = interpolate(frame, [delay, delay + 10], [0, 1], { extrapolateRight: "clamp" })
return (
<div key={i} style={{ opacity }}>{line}</div>
)
})}
</div>
)
}
```
---
## Templates Prontos
### Logo Intro (5s)
```tsx
import { AbsoluteFill, Img, interpolate, spring, useCurrentFrame, useVideoConfig } from "remotion"
export function LogoIntro({ logoSrc }: { logoSrc: string }) {
const frame = useCurrentFrame()
const { fps } = useVideoConfig()
const logoScale = spring({
frame: frame - 10,
fps,
config: { damping: 12, stiffness: 200 }
})
const taglineY = interpolate(frame, [60, 90], [50, 0], { extrapolateRight: "clamp" })
const taglineOpacity = interpolate(frame, [60, 90], [0, 1], { extrapolateRight: "clamp" })
return (
<AbsoluteFill style={{ backgroundColor: "#0f172a", justifyContent: "center", alignItems: "center" }}>
<div style={{ transform: `scale(${logoScale})` }}>
<Img src={logoSrc} style={{ width: "300px" }} />
</div>
<div style={{
position: "absolute", bottom: "150px", fontSize: "48px",
color: "#f8fafc", fontWeight: 600,
transform: `translateY(${taglineY}px)`, opacity: taglineOpacity,
}}>
Crescimento Digital
</div>
</AbsoluteFill>
)
}
```
### Stats Highlight (3s)
```tsx
export function StatsHighlight({ stat, label }: { stat: string; label: string }) {
const frame = useCurrentFrame()
const { fps } = useVideoConfig()
const scale = spring({ frame, fps, config: { damping: 10, mass: 0.5, stiffness: 200 } })
const labelOpacity = interpolate(frame, [30, 45], [0, 1], { extrapolateRight: "clamp" })
return (
<AbsoluteFill style={{ backgroundColor: "#3b82f6", justifyContent: "center", alignItems: "center" }}>
<div style={{ fontSize: "180px", fontWeight: 900, color: "#ffffff", transform: `scale(${scale})` }}>
{stat}
</div>
<div style={{ fontSize: "40px", color: "#dbeafe", marginTop: "20px", opacity: labelOpacity }}>
{label}
</div>
</AbsoluteFill>
)
}
```
---
## Paletas de Cores
### Corporativo Profissional
```tsx
const colors = {
background: "#0f172a",
primary: "#3b82f6",
secondary: "#8b5cf6",
text: "#f8fafc",
accent: "#10b981",
}
```
### Energético/Marketing
```tsx
const colors = {
background: "#ff006e",
primary: "#ffbe0b",
secondary: "#fb5607",
text: "#ffffff",
accent: "#8338ec",
}
```
### Minimalista/Elegante
```tsx
const colors = {
background: "#fafafa",
primary: "#18181b",
secondary: "#71717a",
text: "#18181b",
accent: "#a855f7",
}
```
---
## Tipografia para Vídeo
### Hierarquia de Tamanhos
```tsx
// Remotion 1920x1080
const textSizes = {
hero: "120px",
h1: "80px",
h2: "60px",
h3: "40px",
body: "32px",
caption: "24px",
}
// Remotion 1080x1920 (Vertical)
const textSizesVertical = {
hero: "80px",
h1: "56px",
h2: "40px",
h3: "32px",
body: "24px",
caption: "18px",
}
```
### Font Pairings
```tsx
// Moderno Tech
<style>{`
@import url('https://fonts.googleapis.com/css2?family=Inter:wght@700;900&display=swap');
@import url('https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@500&display=swap');
`}</style>
// Editorial Elegante
<style>{`
@import url('https://fonts.googleapis.com/css2?family=Playfair+Display:wght@700;900&display=swap');
@import url('https://fonts.googleapis.com/css2?family=Source+Sans+Pro:wght@400;600&display=swap');
`}</style>
```
---
## Motion Design Guidelines
### Duração de Animações
| Tipo | Frames (30fps) | Duração |
|------|----------------|---------|
| Micro (hover, toggle) | 3-6 | 100-200ms |
| Rápida (fade, slide) | 12-18 | 400-600ms |
| Normal (entrada cena) | 24-30 | 800-1000ms |
| Lenta (transição cena) | 45-60 | 1.5-2s |
### Easing Curves
```tsx
import { Easing } from "remotion"
const easeOut = Easing.bezier(0, 0, 0.2, 1)
const easeIn = Easing.bezier(0.4, 0, 1, 1)
const easeInOut = Easing.bezier(0.4, 0, 0.2, 1)
const y = interpolate(frame, [0, 30], [100, 0], {
easing: easeOut,
extrapolateRight: "clamp"
})
```
### Princípios de Motion
1. **Staging** - Um movimento de cada vez
2. **Anticipation** - Preparação antes do movimento
3. **Follow Through** - Overshooting ligeiro
4. **Timing** - Velocidade comunica peso/importância
5. **Exaggeration** - Amplificar para ênfase
---
## Acessibilidade
```tsx
// Contraste mínimo 4.5:1
const good = { color: "#1f2937", background: "#ffffff" } // Ratio 15.8:1
// Tamanho mínimo de texto
const minSize1080p = "28px"
const minSize4k = "56px"
```
marketing/skills/video/rules/3d.md
+87
View File
@@ -0,0 +1,87 @@
---
name: 3d
description: 3D content in Remotion using Three.js and React Three Fiber.
metadata:
tags: 3d, three, threejs
layer: wiki
---
# Using Three.js and React Three Fiber in Remotion
Follow React Three Fiber and Three.js best practices.
Only the following Remotion-specific rules need to be followed:
## Prerequisites
First, the `@remotion/three` package needs to be installed.
If it is not, use the following command:
```bash
npx remotion add @remotion/three # If project uses npm
bunx remotion add @remotion/three # If project uses bun
yarn remotion add @remotion/three # If project uses yarn
pnpm exec remotion add @remotion/three # If project uses pnpm
```
## Using ThreeCanvas
You MUST wrap 3D content in `<ThreeCanvas>` and include proper lighting.
`<ThreeCanvas>` MUST have a `width` and `height` prop.
```tsx
import { ThreeCanvas } from "@remotion/three";
import { useVideoConfig } from "remotion";
const { width, height } = useVideoConfig();
<ThreeCanvas width={width} height={height}>
<ambientLight intensity={0.4} />
<directionalLight position={[5, 5, 5]} intensity={0.8} />
<mesh>
<sphereGeometry args={[1, 32, 32]} />
<meshStandardMaterial color="red" />
</mesh>
</ThreeCanvas>
```
## No animations not driven by `useCurrentFrame()`
Shaders, models etc MUST NOT animate by themselves.
No animations are allowed unless they are driven by `useCurrentFrame()`.
Otherwise, it will cause flickering during rendering.
Using `useFrame()` from `@react-three/fiber` is forbidden.
## Animate using `useCurrentFrame()`
Use `useCurrentFrame()` to perform animations.
```tsx
const frame = useCurrentFrame();
const rotationY = frame * 0.02;
<mesh rotation={[0, rotationY, 0]}>
<boxGeometry args={[2, 2, 2]} />
<meshStandardMaterial color="#4a9eff" />
</mesh>
```
## Using `<Sequence>` inside `<ThreeCanvas>`
The `layout` prop of any `<Sequence>` inside a `<ThreeCanvas>` must be set to `none`.
```tsx
import { Sequence } from "remotion";
import { ThreeCanvas } from "@remotion/three";
const { width, height } = useVideoConfig();
<ThreeCanvas width={width} height={height}>
<Sequence layout="none">
<mesh>
<boxGeometry args={[2, 2, 2]} />
<meshStandardMaterial color="#4a9eff" />
</mesh>
</Sequence>
</ThreeCanvas>
```
marketing/skills/video/rules/animations.md
+30
View File
@@ -0,0 +1,30 @@
---
name: animations
description: Fundamental animation skills for Remotion
metadata:
tags: animations, transitions, frames, useCurrentFrame
layer: wiki
---
All animations MUST be driven by the `useCurrentFrame()` hook.
Write animations in seconds and multiply them by the `fps` value from `useVideoConfig()`.
```tsx
import { useCurrentFrame } from "remotion";
export const FadeIn = () => {
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
extrapolateRight: 'clamp',
});
return (
<div style={{ opacity }}>Hello World!</div>
);
};
```
CSS transitions or animations are FORBIDDEN - they will not render correctly.
Tailwind animation class names are FORBIDDEN - they will not render correctly.
marketing/skills/video/rules/assets.md
+79
View File
@@ -0,0 +1,79 @@
---
name: assets
description: Importing images, videos, audio, and fonts into Remotion
metadata:
tags: assets, staticFile, images, fonts, public
layer: wiki
---
# Importing assets in Remotion
## The public folder
Place assets in the `public/` folder at your project root.
## Using staticFile()
You MUST use `staticFile()` to reference files from the `public/` folder:
```tsx
import {Img, staticFile} from 'remotion';
export const MyComposition = () => {
return <Img src={staticFile('logo.png')} />;
};
```
The function returns an encoded URL that works correctly when deploying to subdirectories.
## Using with components
**Images:**
```tsx
import {Img, staticFile} from 'remotion';
<Img src={staticFile('photo.png')} />;
```
**Videos:**
```tsx
import {Video} from '@remotion/media';
import {staticFile} from 'remotion';
<Video src={staticFile('clip.mp4')} />;
```
**Audio:**
```tsx
import {Audio} from '@remotion/media';
import {staticFile} from 'remotion';
<Audio src={staticFile('music.mp3')} />;
```
**Fonts:**
```tsx
import {staticFile} from 'remotion';
const fontFamily = new FontFace('MyFont', `url(${staticFile('font.woff2')})`);
await fontFamily.load();
document.fonts.add(fontFamily);
```
## Remote URLs
Remote URLs can be used directly without `staticFile()`:
```tsx
<Img src="https://example.com/image.png" />
<Video src="https://remotion.media/video.mp4" />
```
## Important notes
- Remotion components (`<Img>`, `<Video>`, `<Audio>`) ensure assets are fully loaded before rendering
- Special characters in filenames (`#`, `?`, `&`) are automatically encoded
marketing/skills/video/rules/audio.md
+173
View File
@@ -0,0 +1,173 @@
---
name: audio
description: Using audio and sound in Remotion - importing, trimming, volume, speed, pitch
metadata:
tags: audio, media, trim, volume, speed, loop, pitch, mute, sound, sfx
layer: wiki
---
# Using audio in Remotion
## Prerequisites
First, the @remotion/media package needs to be installed.
If it is not installed, use the following command:
```bash
npx remotion add @remotion/media # If project uses npm
bunx remotion add @remotion/media # If project uses bun
yarn remotion add @remotion/media # If project uses yarn
pnpm exec remotion add @remotion/media # If project uses pnpm
```
## Importing Audio
Use `<Audio>` from `@remotion/media` to add audio to your composition.
```tsx
import { Audio } from "@remotion/media";
import { staticFile } from "remotion";
export const MyComposition = () => {
return <Audio src={staticFile("audio.mp3")} />;
};
```
Remote URLs are also supported:
```tsx
<Audio src="https://remotion.media/audio.mp3" />
```
By default, audio plays from the start, at full volume and full length.
Multiple audio tracks can be layered by adding multiple `<Audio>` components.
## Trimming
Use `trimBefore` and `trimAfter` to remove portions of the audio. Values are in frames.
```tsx
const { fps } = useVideoConfig();
return (
<Audio
src={staticFile("audio.mp3")}
trimBefore={2 * fps} // Skip the first 2 seconds
trimAfter={10 * fps} // End at the 10 second mark
/>
);
```
The audio still starts playing at the beginning of the composition - only the specified portion is played.
## Delaying
Wrap the audio in a `<Sequence>` to delay when it starts:
```tsx
import { Sequence, staticFile } from "remotion";
import { Audio } from "@remotion/media";
const { fps } = useVideoConfig();
return (
<Sequence from={1 * fps}>
<Audio src={staticFile("audio.mp3")} />
</Sequence>
);
```
The audio will start playing after 1 second.
## Volume
Set a static volume (0 to 1):
```tsx
<Audio src={staticFile("audio.mp3")} volume={0.5} />
```
Or use a callback for dynamic volume based on the current frame:
```tsx
import { interpolate } from "remotion";
const { fps } = useVideoConfig();
return (
<Audio
src={staticFile("audio.mp3")}
volume={(f) =>
interpolate(f, [0, 1 * fps], [0, 1], { extrapolateRight: "clamp" })
}
/>
);
```
The value of `f` starts at 0 when the audio begins to play, not the composition frame.
## Muting
Use `muted` to silence the audio. It can be set dynamically:
```tsx
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
return (
<Audio
src={staticFile("audio.mp3")}
muted={frame >= 2 * fps && frame <= 4 * fps} // Mute between 2s and 4s
/>
);
```
## Speed
Use `playbackRate` to change the playback speed:
```tsx
<Audio src={staticFile("audio.mp3")} playbackRate={2} /> {/* 2x speed */}
<Audio src={staticFile("audio.mp3")} playbackRate={0.5} /> {/* Half speed */}
```
Reverse playback is not supported.
## Looping
Use `loop` to loop the audio indefinitely:
```tsx
<Audio src={staticFile("audio.mp3")} loop />
```
Use `loopVolumeCurveBehavior` to control how the frame count behaves when looping:
- `"repeat"`: Frame count resets to 0 each loop (default)
- `"extend"`: Frame count continues incrementing
```tsx
<Audio
src={staticFile("audio.mp3")}
loop
loopVolumeCurveBehavior="extend"
volume={(f) => interpolate(f, [0, 300], [1, 0])} // Fade out over multiple loops
/>
```
## Pitch
Use `toneFrequency` to adjust the pitch without affecting speed. Values range from 0.01 to 2:
```tsx
<Audio
src={staticFile("audio.mp3")}
toneFrequency={1.5} // Higher pitch
/>
<Audio
src={staticFile("audio.mp3")}
toneFrequency={0.8} // Lower pitch
/>
```
Pitch shifting only works during server-side rendering, not in the Remotion Studio preview or in the `<Player />`.
marketing/skills/video/rules/calculate-metadata.md
+105
View File
@@ -0,0 +1,105 @@
---
name: calculate-metadata
description: Dynamically set composition duration, dimensions, and props
metadata:
tags: calculateMetadata, duration, dimensions, props, dynamic
layer: wiki
---
# Using calculateMetadata
Use `calculateMetadata` on a `<Composition>` to dynamically set duration, dimensions, and transform props before rendering.
```tsx
<Composition id="MyComp" component={MyComponent} durationInFrames={300} fps={30} width={1920} height={1080} defaultProps={{videoSrc: 'https://remotion.media/video.mp4'}} calculateMetadata={calculateMetadata} />
```
## Setting duration based on a video
Use the `getMediaMetadata()` function from the mediabunny/metadata skill to get the video duration:
```tsx
import {CalculateMetadataFunction} from 'remotion';
import {getMediaMetadata} from '../get-media-metadata';
const calculateMetadata: CalculateMetadataFunction<Props> = async ({props}) => {
const {durationInSeconds} = await getMediaMetadata(props.videoSrc);
return {
durationInFrames: Math.ceil(durationInSeconds * 30),
};
};
```
## Matching dimensions of a video
```tsx
const calculateMetadata: CalculateMetadataFunction<Props> = async ({props}) => {
const {durationInSeconds, dimensions} = await getMediaMetadata(props.videoSrc);
return {
durationInFrames: Math.ceil(durationInSeconds * 30),
width: dimensions?.width ?? 1920,
height: dimensions?.height ?? 1080,
};
};
```
## Setting duration based on multiple videos
```tsx
const calculateMetadata: CalculateMetadataFunction<Props> = async ({props}) => {
const metadataPromises = props.videos.map((video) => getMediaMetadata(video.src));
const allMetadata = await Promise.all(metadataPromises);
const totalDuration = allMetadata.reduce((sum, meta) => sum + meta.durationInSeconds, 0);
return {
durationInFrames: Math.ceil(totalDuration * 30),
};
};
```
## Setting a default outName
Set the default output filename based on props:
```tsx
const calculateMetadata: CalculateMetadataFunction<Props> = async ({props}) => {
return {
defaultOutName: `video-${props.id}.mp4`,
};
};
```
## Transforming props
Fetch data or transform props before rendering:
```tsx
const calculateMetadata: CalculateMetadataFunction<Props> = async ({props, abortSignal}) => {
const response = await fetch(props.dataUrl, {signal: abortSignal});
const data = await response.json();
return {
props: {
...props,
fetchedData: data,
},
};
};
```
The `abortSignal` cancels stale requests when props change in the Studio.
## Return value
All fields are optional. Returned values override the `<Composition>` props:
- `durationInFrames`: Number of frames
- `width`: Composition width in pixels
- `height`: Composition height in pixels
- `fps`: Frames per second
- `props`: Transformed props passed to the component
- `defaultOutName`: Default output filename
- `defaultCodec`: Default codec for rendering
marketing/skills/video/rules/can-decode.md
+76
View File
@@ -0,0 +1,76 @@
---
name: can-decode
description: Check if a video can be decoded by the browser using Mediabunny
metadata:
tags: decode, validation, video, audio, compatibility, browser
layer: wiki
---
# Checking if a video can be decoded
Use Mediabunny to check if a video can be decoded by the browser before attempting to play it.
## The `canDecode()` function
This function can be copy-pasted into any project.
```tsx
import { Input, ALL_FORMATS, UrlSource } from "mediabunny";
export const canDecode = async (src: string) => {
const input = new Input({
formats: ALL_FORMATS,
source: new UrlSource(src, {
getRetryDelay: () => null,
}),
});
try {
await input.getFormat();
} catch {
return false;
}
const videoTrack = await input.getPrimaryVideoTrack();
if (videoTrack && !(await videoTrack.canDecode())) {
return false;
}
const audioTrack = await input.getPrimaryAudioTrack();
if (audioTrack && !(await audioTrack.canDecode())) {
return false;
}
return true;
};
```
## Usage
```tsx
const src = "https://remotion.media/video.mp4";
const isDecodable = await canDecode(src);
if (isDecodable) {
console.log("Video can be decoded");
} else {
console.log("Video cannot be decoded by this browser");
}
```
## Using with Blob
For file uploads or drag-and-drop, use `BlobSource`:
```tsx
import { Input, ALL_FORMATS, BlobSource } from "mediabunny";
export const canDecodeBlob = async (blob: Blob) => {
const input = new Input({
formats: ALL_FORMATS,
source: new BlobSource(blob),
});
// Same validation logic as above
};
```
marketing/skills/video/rules/charts.md
+59
View File
@@ -0,0 +1,59 @@
---
name: charts
description: Chart and data visualization patterns for Remotion. Use when creating bar charts, pie charts, histograms, progress bars, or any data-driven animations.
metadata:
tags: charts, data, visualization, bar-chart, pie-chart, graphs
layer: wiki
---
# Charts in Remotion
You can create bar charts in Remotion by using regular React code - HTML and SVG is allowed, as well as D3.js.
## No animations not powered by `useCurrentFrame()`
Disable all animations by third party libraries.
They will cause flickering during rendering.
Instead, drive all animations from `useCurrentFrame()`.
## Bar Chart Animations
See [Bar Chart Example](assets/charts/bar-chart.tsx) for a basic example implmentation.
### Staggered Bars
You can animate the height of the bars and stagger them like this:
```tsx
const STAGGER_DELAY = 5;
const frame = useCurrentFrame();
const {fps} = useVideoConfig();
const bars = data.map((item, i) => {
const delay = i * STAGGER_DELAY;
const height = spring({
frame,
fps,
delay,
config: {damping: 200},
});
return <div style={{height: height * item.value}} />;
});
```
## Pie Chart Animation
Animate segments using stroke-dashoffset, starting from 12 o'clock.
```tsx
const frame = useCurrentFrame();
const {fps} = useVideoConfig();
const progress = interpolate(frame, [0, 100], [0, 1]);
const circumference = 2 * Math.PI * radius;
const segmentLength = (value / total) * circumference;
const offset = interpolate(progress, [0, 1], [segmentLength, 0]);
<circle r={radius} cx={center} cy={center} fill="none" stroke={color} strokeWidth={strokeWidth} strokeDasharray={`${segmentLength} ${circumference}`} strokeDashoffset={offset} transform={`rotate(-90 ${center} ${center})`} />;
```
marketing/skills/video/rules/compositions.md
+142
View File
@@ -0,0 +1,142 @@
---
name: compositions
description: Defining compositions, stills, folders, default props and dynamic metadata
metadata:
tags: composition, still, folder, props, metadata
layer: wiki
---
A `<Composition>` defines the component, width, height, fps and duration of a renderable video.
It normally is placed in the `src/Root.tsx` file.
```tsx
import {Composition} from 'remotion';
import {MyComposition} from './MyComposition';
export const RemotionRoot = () => {
return <Composition id="MyComposition" component={MyComposition} durationInFrames={100} fps={30} width={1080} height={1080} />;
};
```
## Default Props
Pass `defaultProps` to provide initial values for your component.
Values must be JSON-serializable (`Date`, `Map`, `Set`, and `staticFile()` are supported).
```tsx
import {Composition} from 'remotion';
import {MyComposition, MyCompositionProps} from './MyComposition';
export const RemotionRoot = () => {
return (
<Composition
id="MyComposition"
component={MyComposition}
durationInFrames={100}
fps={30}
width={1080}
height={1080}
defaultProps={
{
title: 'Hello World',
color: '#ff0000',
} satisfies MyCompositionProps
}
/>
);
};
```
Use `type` declarations for props rather than `interface` to ensure `defaultProps` type safety.
## Folders
Use `<Folder>` to organize compositions in the sidebar.
Folder names can only contain letters, numbers, and hyphens.
```tsx
import {Composition, Folder} from 'remotion';
export const RemotionRoot = () => {
return (
<>
<Folder name="Marketing">
<Composition id="Promo" /* ... */ />
<Composition id="Ad" /* ... */ />
</Folder>
<Folder name="Social">
<Folder name="Instagram">
<Composition id="Story" /* ... */ />
<Composition id="Reel" /* ... */ />
</Folder>
</Folder>
</>
);
};
```
## Stills
Use `<Still>` for single-frame images. It does not require `durationInFrames` or `fps`.
```tsx
import {Still} from 'remotion';
import {Thumbnail} from './Thumbnail';
export const RemotionRoot = () => {
return <Still id="Thumbnail" component={Thumbnail} width={1280} height={720} />;
};
```
## Calculate Metadata
Use `calculateMetadata` to make dimensions, duration, or props dynamic based on data.
```tsx
import {Composition, CalculateMetadataFunction} from 'remotion';
import {MyComposition, MyCompositionProps} from './MyComposition';
const calculateMetadata: CalculateMetadataFunction<MyCompositionProps> = async ({props, abortSignal}) => {
const data = await fetch(`https://api.example.com/video/${props.videoId}`, {
signal: abortSignal,
}).then((res) => res.json());
return {
durationInFrames: Math.ceil(data.duration * 30),
props: {
...props,
videoUrl: data.url,
},
};
};
export const RemotionRoot = () => {
return (
<Composition
id="MyComposition"
component={MyComposition}
durationInFrames={100} // Placeholder, will be overridden
fps={30}
width={1080}
height={1080}
defaultProps={{videoId: 'abc123'}}
calculateMetadata={calculateMetadata}
/>
);
};
```
The function can return `props`, `durationInFrames`, `width`, `height`, `fps`, and codec-related defaults. It runs once before rendering begins.
## Nesting compositions within another
To add a composition within another composition, you can use the `<Sequence>` component with a `width` and `height` prop to specify the size of the composition.
```tsx
<AbsoluteFill>
<Sequence width={COMPOSITION_WIDTH} height={COMPOSITION_HEIGHT}>
<CompositionComponent />
</Sequence>
</AbsoluteFill>
```
marketing/skills/video/rules/descomplicar-brand.md
+160
View File
@@ -0,0 +1,160 @@
# Descomplicar Brand Guidelines para Vídeos
## Cores da Marca
```tsx
const DESCOMPLICAR_COLORS = {
primary: "#1e3a8a", // Azul escuro
secondary: "#7c3aed", // Roxo
accent: "#06b6d4", // Cyan
dark: "#0f172a", // Quase preto
light: "#f8fafc", // Quase branco
gradient: "linear-gradient(135deg, #1e3a8a 0%, #7c3aed 100%)",
};
```
## Tipografia
```tsx
// Google Fonts recomendadas
import { loadFont as loadInter } from "@remotion/google-fonts/Inter";
import { loadFont as loadPoppins } from "@remotion/google-fonts/Poppins";
const { fontFamily: inter } = loadInter();
const { fontFamily: poppins } = loadPoppins();
// Uso
const FONTS = {
heading: poppins, // Títulos
body: inter, // Texto corrido
};
```
## Estilos Padrão
### Título Principal
```tsx
const titleStyle = {
fontFamily: poppins,
fontSize: 80,
fontWeight: "bold",
color: "white",
textShadow: "0 4px 20px rgba(0,0,0,0.3)",
};
```
### Subtítulo
```tsx
const subtitleStyle = {
fontFamily: inter,
fontSize: 36,
fontWeight: 500,
color: "rgba(255,255,255,0.9)",
letterSpacing: 2,
};
```
### CTA (Call-to-Action)
```tsx
const ctaStyle = {
fontFamily: inter,
fontSize: 28,
fontWeight: 600,
color: "#06b6d4",
textTransform: "uppercase",
};
```
## Animações Recomendadas
### Entrada de Título
```tsx
const titleOpacity = interpolate(frame, [0, 30], [0, 1], {
extrapolateRight: "clamp",
});
const titleScale = spring({
frame,
fps,
config: { damping: 12, stiffness: 100, mass: 0.5 },
});
```
### Entrada de Subtítulo (após título)
```tsx
const subtitleOpacity = interpolate(frame, [30, 60], [0, 1], {
extrapolateLeft: "clamp",
extrapolateRight: "clamp",
});
const subtitleY = interpolate(frame, [30, 60], [20, 0], {
extrapolateLeft: "clamp",
extrapolateRight: "clamp",
});
```
### Linha Decorativa
```tsx
const lineWidth = interpolate(frame, [45, 90], [0, 300], {
extrapolateLeft: "clamp",
extrapolateRight: "clamp",
});
```
## Estrutura de Composição Padrão
```tsx
export const DescomplicarVideo: React.FC<Props> = ({ title, subtitle }) => {
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
return (
<AbsoluteFill
style={{
background: DESCOMPLICAR_COLORS.gradient,
justifyContent: "center",
alignItems: "center",
}}
>
{/* Logo/Título */}
<div style={{ ...titleStyle, opacity: titleOpacity }}>
{title}
</div>
{/* Subtítulo */}
<div style={{ ...subtitleStyle, opacity: subtitleOpacity }}>
{subtitle}
</div>
{/* Elemento decorativo */}
<div
style={{
position: "absolute",
bottom: 80,
width: lineWidth,
height: 3,
background: "rgba(255,255,255,0.7)",
borderRadius: 2,
}}
/>
</AbsoluteFill>
);
};
```
## Assinatura
Incluir no final de vídeos promocionais:
```
Descomplicar® - Crescimento Digital
descomplicar.pt
```
## Durações Recomendadas
| Tipo | Frames (30fps) | Segundos |
|------|----------------|----------|
| Logo intro | 90-150 | 3-5s |
| Social post | 150-450 | 5-15s |
| Promo curta | 450-900 | 15-30s |
| Explainer | 1800+ | 60s+ |
marketing/skills/video/rules/display-captions.md
+127
View File
@@ -0,0 +1,127 @@
---
name: display-captions
description: Displaying captions in Remotion with TikTok-style pages and word highlighting
metadata:
tags: captions, subtitles, display, tiktok, highlight
layer: wiki
---
# Displaying captions in Remotion
This guide explains how to display captions in Remotion, assuming you already have captions in the `Caption` format.
## Prerequisites
First, the @remotion/captions package needs to be installed.
If it is not installed, use the following command:
```bash
npx remotion add @remotion/captions # If project uses npm
bunx remotion add @remotion/captions # If project uses bun
yarn remotion add @remotion/captions # If project uses yarn
pnpm exec remotion add @remotion/captions # If project uses pnpm
```
## Creating pages
Use `createTikTokStyleCaptions()` to group captions into pages. The `combineTokensWithinMilliseconds` option controls how many words appear at once:
```tsx
import {useMemo} from 'react';
import {createTikTokStyleCaptions} from '@remotion/captions';
import type {Caption} from '@remotion/captions';
// How often captions should switch (in milliseconds)
// Higher values = more words per page
// Lower values = fewer words (more word-by-word)
const SWITCH_CAPTIONS_EVERY_MS = 1200;
const {pages} = useMemo(() => {
return createTikTokStyleCaptions({
captions,
combineTokensWithinMilliseconds: SWITCH_CAPTIONS_EVERY_MS,
});
}, [captions]);
```
## Rendering with Sequences
Map over the pages and render each one in a `<Sequence>`. Calculate the start frame and duration from the page timing:
```tsx
import {Sequence, useVideoConfig, AbsoluteFill} from 'remotion';
import type {TikTokPage} from '@remotion/captions';
const CaptionedContent: React.FC = () => {
const {fps} = useVideoConfig();
return (
<AbsoluteFill>
{pages.map((page, index) => {
const nextPage = pages[index + 1] ?? null;
const startFrame = (page.startMs / 1000) * fps;
const endFrame = Math.min(
nextPage ? (nextPage.startMs / 1000) * fps : Infinity,
startFrame + (SWITCH_CAPTIONS_EVERY_MS / 1000) * fps,
);
const durationInFrames = endFrame - startFrame;
if (durationInFrames <= 0) {
return null;
}
return (
<Sequence
key={index}
from={startFrame}
durationInFrames={durationInFrames}
>
<CaptionPage page={page} />
</Sequence>
);
})}
</AbsoluteFill>
);
};
```
## Word highlighting
A caption page contains `tokens` which you can use to highlight the currently spoken word:
```tsx
import {AbsoluteFill, useCurrentFrame, useVideoConfig} from 'remotion';
import type {TikTokPage} from '@remotion/captions';
const HIGHLIGHT_COLOR = '#39E508';
const CaptionPage: React.FC<{page: TikTokPage}> = ({page}) => {
const frame = useCurrentFrame();
const {fps} = useVideoConfig();
// Current time relative to the start of the sequence
const currentTimeMs = (frame / fps) * 1000;
// Convert to absolute time by adding the page start
const absoluteTimeMs = page.startMs + currentTimeMs;
return (
<AbsoluteFill style={{justifyContent: 'center', alignItems: 'center'}}>
<div style={{fontSize: 80, fontWeight: 'bold', whiteSpace: 'pre'}}>
{page.tokens.map((token) => {
const isActive =
token.fromMs <= absoluteTimeMs && token.toMs > absoluteTimeMs;
return (
<span
key={token.fromMs}
style={{color: isActive ? HIGHLIGHT_COLOR : 'white'}}
>
{token.text}
</span>
);
})}
</div>
</AbsoluteFill>
);
};
```
marketing/skills/video/rules/extract-frames.md
+213
View File
@@ -0,0 +1,213 @@
---
name: extract-frames
description: Extract frames from videos at specific timestamps using Mediabunny
metadata:
tags: frames, extract, video, thumbnail, filmstrip, canvas
layer: wiki
---
# Extracting frames from videos
Use Mediabunny to extract frames from videos at specific timestamps. This is useful for generating thumbnails, filmstrips, or processing individual frames.
## The `extractFrames()` function
This function can be copy-pasted into any project.
```tsx
import {
ALL_FORMATS,
Input,
UrlSource,
VideoSample,
VideoSampleSink,
} from "mediabunny";
type Options = {
track: { width: number; height: number };
container: string;
durationInSeconds: number | null;
};
export type ExtractFramesTimestampsInSecondsFn = (
options: Options
) => Promise<number[]> | number[];
export type ExtractFramesProps = {
src: string;
timestampsInSeconds: number[] | ExtractFramesTimestampsInSecondsFn;
onVideoSample: (sample: VideoSample) => void;
signal?: AbortSignal;
};
export async function extractFrames({
src,
timestampsInSeconds,
onVideoSample,
signal,
}: ExtractFramesProps): Promise<void> {
using input = new Input({
formats: ALL_FORMATS,
source: new UrlSource(src),
});
const [durationInSeconds, format, videoTrack] = await Promise.all([
input.computeDuration(),
input.getFormat(),
input.getPrimaryVideoTrack(),
]);
if (!videoTrack) {
throw new Error("No video track found in the input");
}
if (signal?.aborted) {
throw new Error("Aborted");
}
const timestamps =
typeof timestampsInSeconds === "function"
? await timestampsInSeconds({
track: {
width: videoTrack.displayWidth,
height: videoTrack.displayHeight,
},
container: format.name,
durationInSeconds,
})
: timestampsInSeconds;
if (timestamps.length === 0) {
return;
}
if (signal?.aborted) {
throw new Error("Aborted");
}
const sink = new VideoSampleSink(videoTrack);
for await (using videoSample of sink.samplesAtTimestamps(timestamps)) {
if (signal?.aborted) {
break;
}
if (!videoSample) {
continue;
}
onVideoSample(videoSample);
}
}
```
## Basic usage
Extract frames at specific timestamps:
```tsx
await extractFrames({
src: "https://remotion.media/video.mp4",
timestampsInSeconds: [0, 1, 2, 3, 4],
onVideoSample: (sample) => {
const canvas = document.createElement("canvas");
canvas.width = sample.displayWidth;
canvas.height = sample.displayHeight;
const ctx = canvas.getContext("2d");
sample.draw(ctx!, 0, 0);
},
});
```
## Creating a filmstrip
Use a callback function to dynamically calculate timestamps based on video metadata:
```tsx
const canvasWidth = 500;
const canvasHeight = 80;
const fromSeconds = 0;
const toSeconds = 10;
await extractFrames({
src: "https://remotion.media/video.mp4",
timestampsInSeconds: async ({ track, durationInSeconds }) => {
const aspectRatio = track.width / track.height;
const amountOfFramesFit = Math.ceil(
canvasWidth / (canvasHeight * aspectRatio)
);
const segmentDuration = toSeconds - fromSeconds;
const timestamps: number[] = [];
for (let i = 0; i < amountOfFramesFit; i++) {
timestamps.push(
fromSeconds + (segmentDuration / amountOfFramesFit) * (i + 0.5)
);
}
return timestamps;
},
onVideoSample: (sample) => {
console.log(`Frame at ${sample.timestamp}s`);
const canvas = document.createElement("canvas");
canvas.width = sample.displayWidth;
canvas.height = sample.displayHeight;
const ctx = canvas.getContext("2d");
sample.draw(ctx!, 0, 0);
},
});
```
## Cancellation with AbortSignal
Cancel frame extraction after a timeout:
```tsx
const controller = new AbortController();
setTimeout(() => controller.abort(), 5000);
try {
await extractFrames({
src: "https://remotion.media/video.mp4",
timestampsInSeconds: [0, 1, 2, 3, 4],
onVideoSample: (sample) => {
using frame = sample;
const canvas = document.createElement("canvas");
canvas.width = frame.displayWidth;
canvas.height = frame.displayHeight;
const ctx = canvas.getContext("2d");
frame.draw(ctx!, 0, 0);
},
signal: controller.signal,
});
console.log("Frame extraction complete!");
} catch (error) {
console.error("Frame extraction was aborted or failed:", error);
}
```
## Timeout with Promise.race
```tsx
const controller = new AbortController();
const timeoutPromise = new Promise<never>((_, reject) => {
const timeoutId = setTimeout(() => {
controller.abort();
reject(new Error("Frame extraction timed out after 10 seconds"));
}, 10000);
controller.signal.addEventListener("abort", () => clearTimeout(timeoutId), {
once: true,
});
});
try {
await Promise.race([
extractFrames({
src: "https://remotion.media/video.mp4",
timestampsInSeconds: [0, 1, 2, 3, 4],
marketing/skills/video/rules/fonts.md
+153
View File
@@ -0,0 +1,153 @@
---
name: fonts
description: Loading Google Fonts and local fonts in Remotion
metadata:
tags: fonts, google-fonts, typography, text
layer: wiki
---
# Using fonts in Remotion
## Google Fonts with @remotion/google-fonts
The recommended way to use Google Fonts. It's type-safe and automatically blocks rendering until the font is ready.
### Prerequisites
First, the @remotion/google-fonts package needs to be installed.
If it is not installed, use the following command:
```bash
npx remotion add @remotion/google-fonts # If project uses npm
bunx remotion add @remotion/google-fonts # If project uses bun
yarn remotion add @remotion/google-fonts # If project uses yarn
pnpm exec remotion add @remotion/google-fonts # If project uses pnpm
```
```tsx
import { loadFont } from "@remotion/google-fonts/Lobster";
const { fontFamily } = loadFont();
export const MyComposition = () => {
return <div style={{ fontFamily }}>Hello World</div>;
};
```
Preferrably, specify only needed weights and subsets to reduce file size:
```tsx
import { loadFont } from "@remotion/google-fonts/Roboto";
const { fontFamily } = loadFont("normal", {
weights: ["400", "700"],
subsets: ["latin"],
});
```
### Waiting for font to load
Use `waitUntilDone()` if you need to know when the font is ready:
```tsx
import { loadFont } from "@remotion/google-fonts/Lobster";
const { fontFamily, waitUntilDone } = loadFont();
await waitUntilDone();
```
## Local fonts with @remotion/fonts
For local font files, use the `@remotion/fonts` package.
### Prerequisites
First, install @remotion/fonts:
```bash
npx remotion add @remotion/fonts # If project uses npm
bunx remotion add @remotion/fonts # If project uses bun
yarn remotion add @remotion/fonts # If project uses yarn
pnpm exec remotion add @remotion/fonts # If project uses pnpm
```
### Loading a local font
Place your font file in the `public/` folder and use `loadFont()`:
```tsx
import { loadFont } from "@remotion/fonts";
import { staticFile } from "remotion";
await loadFont({
family: "MyFont",
url: staticFile("MyFont-Regular.woff2"),
});
export const MyComposition = () => {
return <div style={{ fontFamily: "MyFont" }}>Hello World</div>;
};
```
### Loading multiple weights
Load each weight separately with the same family name:
```tsx
import { loadFont } from "@remotion/fonts";
import { staticFile } from "remotion";
await Promise.all([
loadFont({
family: "Inter",
url: staticFile("Inter-Regular.woff2"),
weight: "400",
}),
loadFont({
family: "Inter",
url: staticFile("Inter-Bold.woff2"),
weight: "700",
}),
]);
```
### Available options
```tsx
loadFont({
family: "MyFont", // Required: name to use in CSS
url: staticFile("font.woff2"), // Required: font file URL
format: "woff2", // Optional: auto-detected from extension
weight: "400", // Optional: font weight
style: "normal", // Optional: normal or italic
display: "block", // Optional: font-display behavior
});
```
## Using in components
Call `loadFont()` at the top level of your component or in a separate file that's imported early:
```tsx
import { loadFont } from "@remotion/google-fonts/Montserrat";
const { fontFamily } = loadFont("normal", {
weights: ["400", "700"],
subsets: ["latin"],
});
export const Title: React.FC<{ text: string }> = ({ text }) => {
return (
<h1
style={{
fontFamily,
fontSize: 80,
fontWeight: "bold",
}}
>
{text}
</h1>
);
};
```
marketing/skills/video/rules/get-audio-duration.md
+59
View File
@@ -0,0 +1,59 @@
---
name: get-audio-duration
description: Getting the duration of an audio file in seconds with Mediabunny
metadata:
tags: duration, audio, length, time, seconds, mp3, wav
layer: wiki
---
# Getting audio duration with Mediabunny
Mediabunny can extract the duration of an audio file. It works in browser, Node.js, and Bun environments.
## Getting audio duration
```tsx
import { Input, ALL_FORMATS, UrlSource } from "mediabunny";
export const getAudioDuration = async (src: string) => {
const input = new Input({
formats: ALL_FORMATS,
source: new UrlSource(src, {
getRetryDelay: () => null,
}),
});
const durationInSeconds = await input.computeDuration();
return durationInSeconds;
};
```
## Usage
```tsx
const duration = await getAudioDuration("https://remotion.media/audio.mp3");
console.log(duration); // e.g. 180.5 (seconds)
```
## Using with local files
For local files, use `FileSource` instead of `UrlSource`:
```tsx
import { Input, ALL_FORMATS, FileSource } from "mediabunny";
const input = new Input({
formats: ALL_FORMATS,
source: new FileSource(file), // File object from input or drag-drop
});
const durationInSeconds = await input.computeDuration();
```
## Using with staticFile in Remotion
```tsx
import { staticFile } from "remotion";
const duration = await getAudioDuration(staticFile("audio.mp3"));
```
marketing/skills/video/rules/get-video-dimensions.md
+69
View File
@@ -0,0 +1,69 @@
---
name: get-video-dimensions
description: Getting the width and height of a video file with Mediabunny
metadata:
tags: dimensions, width, height, resolution, size, video
layer: wiki
---
# Getting video dimensions with Mediabunny
Mediabunny can extract the width and height of a video file. It works in browser, Node.js, and Bun environments.
## Getting video dimensions
```tsx
import { Input, ALL_FORMATS, UrlSource } from "mediabunny";
export const getVideoDimensions = async (src: string) => {
const input = new Input({
formats: ALL_FORMATS,
source: new UrlSource(src, {
getRetryDelay: () => null,
}),
});
const videoTrack = await input.getPrimaryVideoTrack();
if (!videoTrack) {
throw new Error("No video track found");
}
return {
width: videoTrack.displayWidth,
height: videoTrack.displayHeight,
};
};
```
## Usage
```tsx
const dimensions = await getVideoDimensions("https://remotion.media/video.mp4");
console.log(dimensions.width); // e.g. 1920
console.log(dimensions.height); // e.g. 1080
```
## Using with local files
For local files, use `FileSource` instead of `UrlSource`:
```tsx
import { Input, ALL_FORMATS, FileSource } from "mediabunny";
const input = new Input({
formats: ALL_FORMATS,
source: new FileSource(file), // File object from input or drag-drop
});
const videoTrack = await input.getPrimaryVideoTrack();
const width = videoTrack.displayWidth;
const height = videoTrack.displayHeight;
```
## Using with staticFile in Remotion
```tsx
import { staticFile } from "remotion";
const dimensions = await getVideoDimensions(staticFile("video.mp4"));
```
marketing/skills/video/rules/get-video-duration.md
+59
View File
@@ -0,0 +1,59 @@
---
name: get-video-duration
description: Getting the duration of a video file in seconds with Mediabunny
metadata:
tags: duration, video, length, time, seconds
layer: wiki
---
# Getting video duration with Mediabunny
Mediabunny can extract the duration of a video file. It works in browser, Node.js, and Bun environments.
## Getting video duration
```tsx
import { Input, ALL_FORMATS, UrlSource } from "mediabunny";
export const getVideoDuration = async (src: string) => {
const input = new Input({
formats: ALL_FORMATS,
source: new UrlSource(src, {
getRetryDelay: () => null,
}),
});
const durationInSeconds = await input.computeDuration();
return durationInSeconds;
};
```
## Usage
```tsx
const duration = await getVideoDuration("https://remotion.media/video.mp4");
console.log(duration); // e.g. 10.5 (seconds)
```
## Using with local files
For local files, use `FileSource` instead of `UrlSource`:
```tsx
import { Input, ALL_FORMATS, FileSource } from "mediabunny";
const input = new Input({
formats: ALL_FORMATS,
source: new FileSource(file), // File object from input or drag-drop
});
const durationInSeconds = await input.computeDuration();
```
## Using with staticFile in Remotion
```tsx
import { staticFile } from "remotion";
const duration = await getVideoDuration(staticFile("video.mp4"));
```
marketing/skills/video/rules/gifs.md
+139
View File
@@ -0,0 +1,139 @@
---
name: gif
description: Displaying GIFs, APNG, AVIF and WebP in Remotion
metadata:
tags: gif, animation, images, animated, apng, avif, webp
layer: wiki
---
# Using Animated images in Remotion
## Basic usage
Use `<AnimatedImage>` to display a GIF, APNG, AVIF or WebP image synchronized with Remotion's timeline:
```tsx
import {AnimatedImage, staticFile} from 'remotion';
export const MyComposition = () => {
return <AnimatedImage src={staticFile('animation.gif')} width={500} height={500} />;
};
```
Remote URLs are also supported (must have CORS enabled):
```tsx
<AnimatedImage src="https://example.com/animation.gif" width={500} height={500} />
```
## Sizing and fit
Control how the image fills its container with the `fit` prop:
```tsx
// Stretch to fill (default)
<AnimatedImage src={staticFile("animation.gif")} width={500} height={300} fit="fill" />
// Maintain aspect ratio, fit inside container
<AnimatedImage src={staticFile("animation.gif")} width={500} height={300} fit="contain" />
// Fill container, crop if needed
<AnimatedImage src={staticFile("animation.gif")} width={500} height={300} fit="cover" />
```
## Playback speed
Use `playbackRate` to control the animation speed:
```tsx
<AnimatedImage src={staticFile("animation.gif")} width={500} height={500} playbackRate={2} /> {/* 2x speed */}
<AnimatedImage src={staticFile("animation.gif")} width={500} height={500} playbackRate={0.5} /> {/* Half speed */}
```
## Looping behavior
Control what happens when the animation finishes:
```tsx
// Loop indefinitely (default)
<AnimatedImage src={staticFile("animation.gif")} width={500} height={500} loopBehavior="loop" />
// Play once, show final frame
<AnimatedImage src={staticFile("animation.gif")} width={500} height={500} loopBehavior="pause-after-finish" />
// Play once, then clear canvas
<AnimatedImage src={staticFile("animation.gif")} width={500} height={500} loopBehavior="clear-after-finish" />
```
## Styling
Use the `style` prop for additional CSS (use `width` and `height` props for sizing):
```tsx
<AnimatedImage
src={staticFile('animation.gif')}
width={500}
height={500}
style={{
borderRadius: 20,
position: 'absolute',
top: 100,
left: 50,
}}
/>
```
## Getting GIF duration
Use `getGifDurationInSeconds()` from `@remotion/gif` to get the duration of a GIF.
```bash
npx remotion add @remotion/gif # If project uses npm
bunx remotion add @remotion/gif # If project uses bun
yarn remotion add @remotion/gif # If project uses yarn
pnpm exec remotion add @remotion/gif # If project uses pnpm
```
```tsx
import {getGifDurationInSeconds} from '@remotion/gif';
import {staticFile} from 'remotion';
const duration = await getGifDurationInSeconds(staticFile('animation.gif'));
console.log(duration); // e.g. 2.5
```
This is useful for setting the composition duration to match the GIF:
```tsx
import {getGifDurationInSeconds} from '@remotion/gif';
import {staticFile, CalculateMetadataFunction} from 'remotion';
const calculateMetadata: CalculateMetadataFunction = async () => {
const duration = await getGifDurationInSeconds(staticFile('animation.gif'));
return {
durationInFrames: Math.ceil(duration * 30),
};
};
```
## Alternative
If `<AnimatedImage>` does not work (only supported in Chrome and Firefox), you can use `<Gif>` from `@remotion/gif` instead.
```bash
npx remotion add @remotion/gif # If project uses npm
bunx remotion add @remotion/gif # If project uses bun
yarn remotion add @remotion/gif # If project uses yarn
pnpm exec remotion add @remotion/gif # If project uses pnpm
```
```tsx
import {Gif} from '@remotion/gif';
import {staticFile} from 'remotion';
export const MyComposition = () => {
return <Gif src={staticFile('animation.gif')} width={500} height={500} />;
};
```
The `<Gif>` component has the same props as `<AnimatedImage>` but only supports GIF files.
marketing/skills/video/rules/images.md
+131
View File
@@ -0,0 +1,131 @@
---
name: images
description: Embedding images in Remotion using the <Img> component
metadata:
tags: images, img, staticFile, png, jpg, svg, webp
layer: wiki
---
# Using images in Remotion
## The `<Img>` component
Always use the `<Img>` component from `remotion` to display images:
```tsx
import { Img, staticFile } from "remotion";
export const MyComposition = () => {
return <Img src={staticFile("photo.png")} />;
};
```
## Important restrictions
**You MUST use the `<Img>` component from `remotion`.** Do not use:
- Native HTML `<img>` elements
- Next.js `<Image>` component
- CSS `background-image`
The `<Img>` component ensures images are fully loaded before rendering, preventing flickering and blank frames during video export.
## Local images with staticFile()
Place images in the `public/` folder and use `staticFile()` to reference them:
```
my-video/
├─ public/
│ ├─ logo.png
│ ├─ avatar.jpg
│ └─ icon.svg
├─ src/
├─ package.json
```
```tsx
import { Img, staticFile } from "remotion";
<Img src={staticFile("logo.png")} />
```
## Remote images
Remote URLs can be used directly without `staticFile()`:
```tsx
<Img src="https://example.com/image.png" />
```
Ensure remote images have CORS enabled.
For animated GIFs, use the `<Gif>` component from `@remotion/gif` instead.
## Sizing and positioning
Use the `style` prop to control size and position:
```tsx
<Img
src={staticFile("photo.png")}
style={{
width: 500,
height: 300,
position: "absolute",
top: 100,
left: 50,
objectFit: "cover",
}}
/>
```
## Dynamic image paths
Use template literals for dynamic file references:
```tsx
import { Img, staticFile, useCurrentFrame } from "remotion";
const frame = useCurrentFrame();
// Image sequence
<Img src={staticFile(`frames/frame${frame}.png`)} />
// Selecting based on props
<Img src={staticFile(`avatars/${props.userId}.png`)} />
// Conditional images
<Img src={staticFile(`icons/${isActive ? "active" : "inactive"}.svg`)} />
```
This pattern is useful for:
- Image sequences (frame-by-frame animations)
- User-specific avatars or profile images
- Theme-based icons
- State-dependent graphics
## Getting image dimensions
Use `getImageDimensions()` to get the dimensions of an image:
```tsx
import { getImageDimensions, staticFile } from "remotion";
const { width, height } = await getImageDimensions(staticFile("photo.png"));
```
This is useful for calculating aspect ratios or sizing compositions:
```tsx
import { getImageDimensions, staticFile, CalculateMetadataFunction } from "remotion";
const calculateMetadata: CalculateMetadataFunction = async () => {
const { width, height } = await getImageDimensions(staticFile("photo.png"));
return {
width,
height,
};
};
```
marketing/skills/video/rules/import-srt-captions.md
+68
View File
@@ -0,0 +1,68 @@
---
name: import-srt-captions
description: Importing .srt subtitle files into Remotion using @remotion/captions
metadata:
tags: captions, subtitles, srt, import, parse
layer: wiki
---
# Importing .srt subtitles into Remotion
If you have an existing `.srt` subtitle file, you can import it into Remotion using `parseSrt()` from `@remotion/captions`.
## Prerequisites
First, the @remotion/captions package needs to be installed.
If it is not installed, use the following command:
```bash
npx remotion add @remotion/captions # If project uses npm
bunx remotion add @remotion/captions # If project uses bun
yarn remotion add @remotion/captions # If project uses yarn
pnpm exec remotion add @remotion/captions # If project uses pnpm
```
## Reading an .srt file
Use `staticFile()` to reference an `.srt` file in your `public` folder, then fetch and parse it:
```tsx
import {useState, useEffect, useCallback} from 'react';
import {AbsoluteFill, staticFile, useDelayRender} from 'remotion';
import {parseSrt} from '@remotion/captions';
import type {Caption} from '@remotion/captions';
export const MyComponent: React.FC = () => {
const [captions, setCaptions] = useState<Caption[] | null>(null);
const {delayRender, continueRender, cancelRender} = useDelayRender();
const [handle] = useState(() => delayRender());
const fetchCaptions = useCallback(async () => {
try {
const response = await fetch(staticFile('subtitles.srt'));
const text = await response.text();
const {captions: parsed} = parseSrt({input: text});
setCaptions(parsed);
continueRender(handle);
} catch (e) {
cancelRender(e);
}
}, [continueRender, cancelRender, handle]);
useEffect(() => {
fetchCaptions();
}, [fetchCaptions]);
if (!captions) {
return null;
}
return <AbsoluteFill>{/* Use captions here */}</AbsoluteFill>;
};
```
Remote URLs are also supported - you can `fetch()` a remote file via URL instead of using `staticFile()`.
## Using imported captions
Once parsed, the captions are in the `Caption` format and can be used with all `@remotion/captions` utilities.
marketing/skills/video/rules/lottie.md
+69
View File
@@ -0,0 +1,69 @@
---
name: lottie
description: Embedding Lottie animations in Remotion.
metadata:
category: Animation
layer: wiki
---
# Using Lottie Animations in Remotion
## Prerequisites
First, the @remotion/lottie package needs to be installed.
If it is not, use the following command:
```bash
npx remotion add @remotion/lottie # If project uses npm
bunx remotion add @remotion/lottie # If project uses bun
yarn remotion add @remotion/lottie # If project uses yarn
pnpm exec remotion add @remotion/lottie # If project uses pnpm
```
## Displaying a Lottie file
To import a Lottie animation:
- Fetch the Lottie asset
- Wrap the loading process in `delayRender()` and `continueRender()`
- Save the animation data in a state
- Render the Lottie animation using the `Lottie` component from the `@remotion/lottie` package
```tsx
import {Lottie, LottieAnimationData} from '@remotion/lottie';
import {useEffect, useState} from 'react';
import {cancelRender, continueRender, delayRender} from 'remotion';
export const MyAnimation = () => {
const [handle] = useState(() => delayRender('Loading Lottie animation'));
const [animationData, setAnimationData] = useState<LottieAnimationData | null>(null);
useEffect(() => {
fetch('https://assets4.lottiefiles.com/packages/lf20_zyquagfl.json')
.then((data) => data.json())
.then((json) => {
setAnimationData(json);
continueRender(handle);
})
.catch((err) => {
cancelRender(err);
});
}, [handle]);
if (!animationData) {
return null;
}
return <Lottie animationData={animationData} />;
};
```
## Styling and animating
Lottie supports the `style` prop to allow styles and animations:
```tsx
return <Lottie animationData={animationData} style={{width: 400, height: 400}} />;
```
marketing/skills/video/rules/maps.md
+175
View File
@@ -0,0 +1,175 @@
---
name: maps
description: Make map animations with Mapbox
metadata:
tags: map, map animation, mapbox
layer: wiki
---
Maps can be added to a Remotion video with Mapbox.
The [Mapbox documentation](https://docs.mapbox.com/mapbox-gl-js/api/) has the API reference.
## Prerequisites
Mapbox and `@turf/turf` need to be installed.
Search the project for lockfiles and run the correct command depending on the package manager:
If `package-lock.json` is found, use the following command:
```bash
npm i mapbox-gl @turf/turf @types/mapbox-gl
```
If `bun.lock` is found, use the following command:
```bash
bun i mapbox-gl @turf/turf @types/mapbox-gl
```
If `yarn.lock` is found, use the following command:
```bash
yarn add mapbox-gl @turf/turf @types/mapbox-gl
```
If `pnpm-lock.yaml` is found, use the following command:
```bash
pnpm i mapbox-gl @turf/turf @types/mapbox-gl
```
The user needs to create a free Mapbox account and create an access token by visiting https://console.mapbox.com/account/access-tokens/.
The mapbox token needs to be added to the `.env` file:
```txt title=".env"
REMOTION_MAPBOX_TOKEN==pk.your-mapbox-access-token
```
## Adding a map
Here is a basic example of a map in Remotion.
```tsx
import {useEffect, useMemo, useRef, useState} from 'react';
import {AbsoluteFill, useDelayRender, useVideoConfig} from 'remotion';
import mapboxgl, {Map} from 'mapbox-gl';
export const lineCoordinates = [
[6.56158447265625, 46.059891147620725],
[6.5691375732421875, 46.05679376154153],
[6.5842437744140625, 46.05059898938315],
[6.594886779785156, 46.04702502069337],
[6.601066589355469, 46.0460718554722],
[6.6089630126953125, 46.0365370783104],
[6.6185760498046875, 46.018420689207964],
];
mapboxgl.accessToken = process.env.REMOTION_MAPBOX_TOKEN as string;
export const MyComposition = () => {
const ref = useRef<HTMLDivElement>(null);
const {delayRender, continueRender} = useDelayRender();
const {width, height} = useVideoConfig();
const [handle] = useState(() => delayRender('Loading map...'));
const [map, setMap] = useState<Map | null>(null);
useEffect(() => {
const _map = new Map({
container: ref.current!,
zoom: 11.53,
center: [6.5615, 46.0598],
pitch: 65,
bearing: 0,
style: '⁠mapbox://styles/mapbox/standard',
interactive: false,
fadeDuration: 0,
});
_map.on('style.load', () => {
// Hide all features from the Mapbox Standard style
const hideFeatures = [
'showRoadsAndTransit',
'showRoads',
'showTransit',
'showPedestrianRoads',
'showRoadLabels',
'showTransitLabels',
'showPlaceLabels',
'showPointOfInterestLabels',
'showPointsOfInterest',
'showAdminBoundaries',
'showLandmarkIcons',
'showLandmarkIconLabels',
'show3dObjects',
'show3dBuildings',
'show3dTrees',
'show3dLandmarks',
'show3dFacades',
];
for (const feature of hideFeatures) {
_map.setConfigProperty('basemap', feature, false);
}
_map.setConfigProperty('basemap', 'colorMotorways', 'rgba(0, 0, 0, 0)');
_map.setConfigProperty('basemap', 'colorRoads', 'rgba(0, 0, 0, 0)');
_map.setConfigProperty('basemap', 'colorTrunks', 'rgba(0, 0, 0, 0)');
_map.addSource('trace', {
type: 'geojson',
data: {
type: 'Feature',
properties: {},
geometry: {
type: 'LineString',
coordinates: lineCoordinates,
},
},
});
_map.addLayer({
type: 'line',
source: 'trace',
id: 'line',
paint: {
'line-color': 'black',
'line-width': 5,
},
layout: {
'line-cap': 'round',
'line-join': 'round',
},
});
});
_map.on('load', () => {
continueRender(handle);
setMap(_map);
});
}, [handle, lineCoordinates]);
const style: React.CSSProperties = useMemo(() => ({width, height, position: 'absolute'}), [width, height]);
return <AbsoluteFill ref={ref} style={style} />;
};
```
The following is important in Remotion:
- Animations must be driven by `useCurrentFrame()` and animations that Mapbox brings itself should be disabled. For example, the `fadeDuration` prop should be set to `0`, `interactive` should be set to `false`, etc.
- Loading the map should be delayed using `useDelayRender()` and the map should be set to `null` until it is loaded.
- The element containing the ref MUST have an explicit width and height and `position: "absolute"`.
- Do not add a `_map.remove();` cleanup function.
## Drawing lines
Unless I request it, do not add a glow effect to the lines.
Unless I request it, do not add additional points to the lines.
## Map style
By default, use the `mapbox://styles/mapbox/standard` style.
Hide the labels from the base map style.
Unless I request otherwise, remove all features from the Mapbo
marketing/skills/video/rules/measuring-dom-nodes.md
+36
View File
@@ -0,0 +1,36 @@
---
name: measuring-dom-nodes
description: Measuring DOM element dimensions in Remotion
metadata:
tags: measure, layout, dimensions, getBoundingClientRect, scale
layer: wiki
---
# Measuring DOM nodes in Remotion
Remotion applies a `scale()` transform to the video container, which affects values from `getBoundingClientRect()`. Use `useCurrentScale()` to get correct measurements.
## Measuring element dimensions
```tsx
import { useCurrentScale } from "remotion";
import { useRef, useEffect, useState } from "react";
export const MyComponent = () => {
const ref = useRef<HTMLDivElement>(null);
const scale = useCurrentScale();
const [dimensions, setDimensions] = useState({ width: 0, height: 0 });
useEffect(() => {
if (!ref.current) return;
const rect = ref.current.getBoundingClientRect();
setDimensions({
width: rect.width / scale,
height: rect.height / scale,
});
}, [scale]);
return <div ref={ref}>Content to measure</div>;
};
```
marketing/skills/video/rules/measuring-text.md
+144
View File
@@ -0,0 +1,144 @@
---
name: measuring-text
description: Measuring text dimensions, fitting text to containers, and checking overflow
metadata:
tags: measure, text, layout, dimensions, fitText, fillTextBox
layer: wiki
---
# Measuring text in Remotion
## Prerequisites
Install @remotion/layout-utils if it is not already installed:
```bash
npx remotion add @remotion/layout-utils # If project uses npm
bunx remotion add @remotion/layout-utils # If project uses bun
yarn remotion add @remotion/layout-utils # If project uses yarn
pnpm exec remotion add @remotion/layout-utils # If project uses pnpm
```
## Measuring text dimensions
Use `measureText()` to calculate the width and height of text:
```tsx
import { measureText } from "@remotion/layout-utils";
const { width, height } = measureText({
text: "Hello World",
fontFamily: "Arial",
fontSize: 32,
fontWeight: "bold",
});
```
Results are cached - duplicate calls return the cached result.
## Fitting text to a width
Use `fitText()` to find the optimal font size for a container:
```tsx
import { fitText } from "@remotion/layout-utils";
const { fontSize } = fitText({
text: "Hello World",
withinWidth: 600,
fontFamily: "Inter",
fontWeight: "bold",
});
return (
<div
style={{
fontSize: Math.min(fontSize, 80), // Cap at 80px
fontFamily: "Inter",
fontWeight: "bold",
}}
>
Hello World
</div>
);
```
## Checking text overflow
Use `fillTextBox()` to check if text exceeds a box:
```tsx
import { fillTextBox } from "@remotion/layout-utils";
const box = fillTextBox({ maxBoxWidth: 400, maxLines: 3 });
const words = ["Hello", "World", "This", "is", "a", "test"];
for (const word of words) {
const { exceedsBox } = box.add({
text: word + " ",
fontFamily: "Arial",
fontSize: 24,
});
if (exceedsBox) {
// Text would overflow, handle accordingly
break;
}
}
```
## Best practices
**Load fonts first:** Only call measurement functions after fonts are loaded.
```tsx
import { loadFont } from "@remotion/google-fonts/Inter";
const { fontFamily, waitUntilDone } = loadFont("normal", {
weights: ["400"],
subsets: ["latin"],
});
waitUntilDone().then(() => {
// Now safe to measure
const { width } = measureText({
text: "Hello",
fontFamily,
fontSize: 32,
});
})
```
**Use validateFontIsLoaded:** Catch font loading issues early:
```tsx
measureText({
text: "Hello",
fontFamily: "MyCustomFont",
fontSize: 32,
validateFontIsLoaded: true, // Throws if font not loaded
});
```
**Match font properties:** Use the same properties for measurement and rendering:
```tsx
const fontStyle = {
fontFamily: "Inter",
fontSize: 32,
fontWeight: "bold" as const,
letterSpacing: "0.5px",
};
const { width } = measureText({
text: "Hello",
...fontStyle,
});
return <div style={fontStyle}>Hello</div>;
```
**Avoid padding and border:** Use `outline` instead of `border` to prevent layout differences:
```tsx
<div style={{ outline: "2px solid red" }}>Text</div>
```
marketing/skills/video/rules/parameters.md
+99
View File
@@ -0,0 +1,99 @@
---
name: parameters
description: Make a video parametrizable by adding a Zod schema
metadata:
tags: parameters, zod, schema
layer: wiki
---
To make a video parametrizable, a Zod schema can be added to a composition.
First, `zod` must be installed - it must be exactly version `3.22.3`.
Search the project for lockfiles and run the correct command depending on the package manager:
If `package-lock.json` is found, use the following command:
```bash
npm i zod@3.22.3
```
If `bun.lockb` is found, use the following command:
```bash
bun i zod@3.22.3
```
If `yarn.lock` is found, use the following command:
```bash
yarn add zod@3.22.3
```
If `pnpm-lock.yaml` is found, use the following command:
```bash
pnpm i zod@3.22.3
```
Then, a Zod schema can be defined alongside the component:
```tsx title="src/MyComposition.tsx"
import {z} from 'zod';
export const MyCompositionSchema = z.object({
title: z.string(),
});
const MyComponent: React.FC<z.infer<typeof MyCompositionSchema>> = () => {
return (
<div>
<h1>{props.title}</h1>
</div>
);
};
```
In the root file, the schema can be passed to the composition:
```tsx title="src/Root.tsx"
import {Composition} from 'remotion';
import {MycComponent, MyCompositionSchema} from './MyComposition';
export const RemotionRoot = () => {
return <Composition id="MyComposition" component={MyComponent} durationInFrames={100} fps={30} width={1080} height={1080} defaultProps={{title: 'Hello World'}} schema={MyCompositionSchema} />;
};
```
Now, the user can edit the parameter visually in the sidebar.
All schemas that are supported by Zod are supported by Remotion.
Remotion requires that the top-level type is a z.object(), because the collection of props of a React component is always an object.
## Color picker
For adding a color picker, use `zColor()` from `@remotion/zod-types`.
If it is not installed, use the following command:
```bash
npx remotion add @remotion/zod-types # If project uses npm
bunx remotion add @remotion/zod-types # If project uses bun
yarn remotion add @remotion/zod-types # If project uses yarn
pnpm exec remotion add @remotion/zod-types # If project uses pnpm
```
Then import `zColor` from `@remotion/zod-types`:
```tsx
import {zColor} from '@remotion/zod-types';
```
Then use it in the schema:
```tsx
export const MyCompositionSchema = z.object({
color: zColor(),
});
```
marketing/skills/video/rules/sequencing.md
+119
View File
@@ -0,0 +1,119 @@
---
name: sequencing
description: Sequencing patterns for Remotion - delay, trim, limit duration of items
metadata:
tags: sequence, series, timing, delay, trim
layer: wiki
---
Use `<Sequence>` to delay when an element appears in the timeline.
```tsx
import { Sequence } from "remotion";
const {fps} = useVideoConfig();
<Sequence from={1 * fps} durationInFrames={2 * fps} premountFor={1 * fps}>
<Title />
</Sequence>
<Sequence from={2 * fps} durationInFrames={2 * fps} premountFor={1 * fps}>
<Subtitle />
</Sequence>
```
This will by default wrap the component in an absolute fill element.
If the items should not be wrapped, use the `layout` prop:
```tsx
<Sequence layout="none">
<Title />
</Sequence>
```
## Premounting
This loads the component in the timeline before it is actually played.
Always premount any `<Sequence>`!
```tsx
<Sequence premountFor={1 * fps}>
<Title />
</Sequence>
```
## Series
Use `<Series>` when elements should play one after another without overlap.
```tsx
import {Series} from 'remotion';
<Series>
<Series.Sequence durationInFrames={45}>
<Intro />
</Series.Sequence>
<Series.Sequence durationInFrames={60}>
<MainContent />
</Series.Sequence>
<Series.Sequence durationInFrames={30}>
<Outro />
</Series.Sequence>
</Series>;
```
Same as with `<Sequence>`, the items will be wrapped in an absolute fill element by default when using `<Series.Sequence>`, unless the `layout` prop is set to `none`.
### Series with overlaps
Use negative offset for overlapping sequences:
```tsx
<Series>
<Series.Sequence durationInFrames={60}>
<SceneA />
</Series.Sequence>
<Series.Sequence offset={-15} durationInFrames={60}>
{/* Starts 15 frames before SceneA ends */}
<SceneB />
</Series.Sequence>
</Series>
```
## Frame References Inside Sequences
Inside a Sequence, `useCurrentFrame()` returns the local frame (starting from 0):
```tsx
<Sequence from={60} durationInFrames={30}>
<MyComponent />
{/* Inside MyComponent, useCurrentFrame() returns 0-29, not 60-89 */}
</Sequence>
```
## Nested Sequences
Sequences can be nested for complex timing:
```tsx
<Sequence from={0} durationInFrames={120}>
<Background />
<Sequence from={15} durationInFrames={90} layout="none">
<Title />
</Sequence>
<Sequence from={45} durationInFrames={60} layout="none">
<Subtitle />
</Sequence>
</Sequence>
```
## Nesting compositions within another
To add a composition within another composition, you can use the `<Sequence>` component with a `width` and `height` prop to specify the size of the composition.
```tsx
<AbsoluteFill>
<Sequence width={COMPOSITION_WIDTH} height={COMPOSITION_HEIGHT}>
<CompositionComponent />
</Sequence>
</AbsoluteFill>
```
marketing/skills/video/rules/tailwind.md
+12
View File
@@ -0,0 +1,12 @@
---
name: tailwind
description: Using TailwindCSS in Remotion.
metadata:
layer: wiki
---
You can and should use TailwindCSS in Remotion, if TailwindCSS is installed in the project.
Don't use `transition-*` or `animate-*` classes - always animate using the `useCurrentFrame()` hook.
Tailwind must be installed and enabled first in a Remotion project - fetch https://www.remotion.dev/docs/tailwind using WebFetch for instructions.
marketing/skills/video/rules/text-animations.md
+21
View File
@@ -0,0 +1,21 @@
---
name: text-animations
description: Typography and text animation patterns for Remotion.
metadata:
tags: typography, text, typewriter, highlighter ken
layer: wiki
---
## Text animations
Based on `useCurrentFrame()`, reduce the string character by character to create a typewriter effect.
## Typewriter Effect
See [Typewriter](assets/text-animations-typewriter.tsx) for an advanced example with a blinking cursor and a pause after the first sentence.
Always use string slicing for typewriter effects. Never use per-character opacity.
## Word Highlighting
See [Word Highlight](assets/text-animations-word-highlight.tsx) for an example for how a word highlight is animated, like with a highlighter pen.
marketing/skills/video/rules/timing.md
+180
View File
@@ -0,0 +1,180 @@
---
name: timing
description: Interpolation curves in Remotion - linear, easing, spring animations
metadata:
tags: spring, bounce, easing, interpolation
layer: wiki
---
A simple linear interpolation is done using the `interpolate` function.
```ts title="Going from 0 to 1 over 100 frames"
import {interpolate} from 'remotion';
const opacity = interpolate(frame, [0, 100], [0, 1]);
```
By default, the values are not clamped, so the value can go outside the range [0, 1].
Here is how they can be clamped:
```ts title="Going from 0 to 1 over 100 frames with extrapolation"
const opacity = interpolate(frame, [0, 100], [0, 1], {
extrapolateRight: 'clamp',
extrapolateLeft: 'clamp',
});
```
## Spring animations
Spring animations have a more natural motion.
They go from 0 to 1 over time.
```ts title="Spring animation from 0 to 1 over 100 frames"
import {spring, useCurrentFrame, useVideoConfig} from 'remotion';
const frame = useCurrentFrame();
const {fps} = useVideoConfig();
const scale = spring({
frame,
fps,
});
```
### Physical properties
The default configuration is: `mass: 1, damping: 10, stiffness: 100`.
This leads to the animation having a bit of bounce before it settles.
The config can be overwritten like this:
```ts
const scale = spring({
frame,
fps,
config: {damping: 200},
});
```
The recommended configuration for a natural motion without a bounce is: `{ damping: 200 }`.
Here are some common configurations:
```tsx
const smooth = {damping: 200}; // Smooth, no bounce (subtle reveals)
const snappy = {damping: 20, stiffness: 200}; // Snappy, minimal bounce (UI elements)
const bouncy = {damping: 8}; // Bouncy entrance (playful animations)
const heavy = {damping: 15, stiffness: 80, mass: 2}; // Heavy, slow, small bounce
```
### Delay
The animation starts immediately by default.
Use the `delay` parameter to delay the animation by a number of frames.
```tsx
const entrance = spring({
frame: frame - ENTRANCE_DELAY,
fps,
delay: 20,
});
```
### Duration
A `spring()` has a natural duration based on the physical properties.
To stretch the animation to a specific duration, use the `durationInFrames` parameter.
```tsx
const spring = spring({
frame,
fps,
durationInFrames: 40,
});
```
### Combining spring() with interpolate()
Map spring output (0-1) to custom ranges:
```tsx
const springProgress = spring({
frame,
fps,
});
// Map to rotation
const rotation = interpolate(springProgress, [0, 1], [0, 360]);
<div style={{rotate: rotation + 'deg'}} />;
```
### Adding springs
Springs return just numbers, so math can be performed:
```tsx
const frame = useCurrentFrame();
const {fps, durationInFrames} = useVideoConfig();
const inAnimation = spring({
frame,
fps,
});
const outAnimation = spring({
frame,
fps,
durationInFrames: 1 * fps,
delay: durationInFrames - 1 * fps,
});
const scale = inAnimation - outAnimation;
```
## Easing
Easing can be added to the `interpolate` function:
```ts
import {interpolate, Easing} from 'remotion';
const value1 = interpolate(frame, [0, 100], [0, 1], {
easing: Easing.inOut(Easing.quad),
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
});
```
The default easing is `Easing.linear`.
There are various other convexities:
- `Easing.in` for starting slow and accelerating
- `Easing.out` for starting fast and slowing down
- `Easing.inOut`
and curves (sorted from most linear to most curved):
- `Easing.quad`
- `Easing.sin`
- `Easing.exp`
- `Easing.circle`
Convexities and curves need be combined for an easing function:
```ts
const value1 = interpolate(frame, [0, 100], [0, 1], {
easing: Easing.inOut(Easing.quad),
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
});
```
Cubic bezier curves are also supported:
```ts
const value1 = interpolate(frame, [0, 100], [0, 1], {
easing: Easing.bezier(0.8, 0.22, 0.96, 0.65),
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
});
```
marketing/skills/video/rules/transcribe-captions.md
+20
View File
@@ -0,0 +1,20 @@
---
name: transcribe-captions
description: Transcribing audio to generate captions in Remotion
metadata:
tags: captions, transcribe, whisper, audio, speech-to-text
layer: wiki
---
# Transcribing audio
Remotion provides several built-in options for transcribing audio to generate captions:
- `@remotion/install-whisper-cpp` - Transcribe locally on a server using Whisper.cpp. Fast and free, but requires server infrastructure.
https://remotion.dev/docs/install-whisper-cpp
- `@remotion/whisper-web` - Transcribe in the browser using WebAssembly. No server needed and free, but slower due to WASM overhead.
https://remotion.dev/docs/whisper-web
- `@remotion/openai-whisper` - Use OpenAI Whisper API for cloud-based transcription. Fast and no server needed, but requires payment.
https://remotion.dev/docs/openai-whisper/openai-whisper-api-to-captions
marketing/skills/video/rules/transitions.md
+123
View File
@@ -0,0 +1,123 @@
---
name: transitions
description: Fullscreen scene transitions for Remotion.
metadata:
tags: transitions, fade, slide, wipe, scenes
layer: wiki
---
## Fullscreen transitions
Using `<TransitionSeries>` to animate between multiple scenes or clips.
This will absolutely position the children.
## Prerequisites
First, the @remotion/transitions package needs to be installed.
If it is not, use the following command:
```bash
npx remotion add @remotion/transitions # If project uses npm
bunx remotion add @remotion/transitions # If project uses bun
yarn remotion add @remotion/transitions # If project uses yarn
pnpm exec remotion add @remotion/transitions # If project uses pnpm
```
## Example usage
```tsx
import {TransitionSeries, linearTiming} from '@remotion/transitions';
import {fade} from '@remotion/transitions/fade';
<TransitionSeries>
<TransitionSeries.Sequence durationInFrames={60}>
<SceneA />
</TransitionSeries.Sequence>
<TransitionSeries.Transition presentation={fade()} timing={linearTiming({durationInFrames: 15})} />
<TransitionSeries.Sequence durationInFrames={60}>
<SceneB />
</TransitionSeries.Sequence>
</TransitionSeries>;
```
## Available Transition Types
Import transitions from their respective modules:
```tsx
import {fade} from '@remotion/transitions/fade';
import {slide} from '@remotion/transitions/slide';
import {wipe} from '@remotion/transitions/wipe';
import {flip} from '@remotion/transitions/flip';
import {clockWipe} from '@remotion/transitions/clock-wipe';
```
## Slide Transition with Direction
Specify slide direction for enter/exit animations.
```tsx
import {slide} from '@remotion/transitions/slide';
<TransitionSeries.Transition presentation={slide({direction: 'from-left'})} timing={linearTiming({durationInFrames: 20})} />;
```
Directions: `"from-left"`, `"from-right"`, `"from-top"`, `"from-bottom"`
## Timing Options
```tsx
import {linearTiming, springTiming} from '@remotion/transitions';
// Linear timing - constant speed
linearTiming({durationInFrames: 20});
// Spring timing - organic motion
springTiming({config: {damping: 200}, durationInFrames: 25});
```
## Duration calculation
Transitions overlap adjacent scenes, so the total composition length is **shorter** than the sum of all sequence durations.
For example, with two 60-frame sequences and a 15-frame transition:
- Without transitions: `60 + 60 = 120` frames
- With transition: `60 + 60 - 15 = 105` frames
The transition duration is subtracted because both scenes play simultaneously during the transition.
### Getting the duration of a transition
Use the `getDurationInFrames()` method on the timing object:
```tsx
import {linearTiming, springTiming} from '@remotion/transitions';
const linearDuration = linearTiming({durationInFrames: 20}).getDurationInFrames({fps: 30});
// Returns 20
const springDuration = springTiming({config: {damping: 200}}).getDurationInFrames({fps: 30});
// Returns calculated duration based on spring physics
```
For `springTiming` without an explicit `durationInFrames`, the duration depends on `fps` because it calculates when the spring animation settles.
### Calculating total composition duration
```tsx
import {linearTiming} from '@remotion/transitions';
const scene1Duration = 60;
const scene2Duration = 60;
const scene3Duration = 60;
const timing1 = linearTiming({durationInFrames: 15});
const timing2 = linearTiming({durationInFrames: 20});
const transition1Duration = timing1.getDurationInFrames({fps: 30});
const transition2Duration = timing2.getDurationInFrames({fps: 30});
const totalDuration = scene1Duration + scene2Duration + scene3Duration - transition1Duration - transition2Duration;
// 60 + 60 + 60 - 15 - 20 = 145 frames
```
marketing/skills/video/rules/trimming.md
+54
View File
@@ -0,0 +1,54 @@
---
name: trimming
description: Trimming patterns for Remotion - cut the beginning or end of animations
metadata:
tags: sequence, trim, clip, cut, offset
layer: wiki
---
Use `<Sequence>` with a negative `from` value to trim the start of an animation.
## Trim the Beginning
A negative `from` value shifts time backwards, making the animation start partway through:
```tsx
import { Sequence, useVideoConfig } from "remotion";
const fps = useVideoConfig();
<Sequence from={-0.5 * fps}>
<MyAnimation />
</Sequence>
```
The animation appears 15 frames into its progress - the first 15 frames are trimmed off.
Inside `<MyAnimation>`, `useCurrentFrame()` starts at 15 instead of 0.
## Trim the End
Use `durationInFrames` to unmount content after a specified duration:
```tsx
<Sequence durationInFrames={1.5 * fps}>
<MyAnimation />
</Sequence>
```
The animation plays for 45 frames, then the component unmounts.
## Trim and Delay
Nest sequences to both trim the beginning and delay when it appears:
```tsx
<Sequence from={30}>
<Sequence from={-15}>
<MyAnimation />
</Sequence>
</Sequence>
```
The inner sequence trims 15 frames from the start, and the outer sequence delays the result by 30 frames.
marketing/skills/video/rules/videos.md
+172
View File
@@ -0,0 +1,172 @@
---
name: videos
description: Embedding videos in Remotion - trimming, volume, speed, looping, pitch
metadata:
tags: video, media, trim, volume, speed, loop, pitch
layer: wiki
---
# Using videos in Remotion
## Prerequisites
First, the @remotion/media package needs to be installed.
If it is not, use the following command:
```bash
npx remotion add @remotion/media # If project uses npm
bunx remotion add @remotion/media # If project uses bun
yarn remotion add @remotion/media # If project uses yarn
pnpm exec remotion add @remotion/media # If project uses pnpm
```
Use `<Video>` from `@remotion/media` to embed videos into your composition.
```tsx
import { Video } from "@remotion/media";
import { staticFile } from "remotion";
export const MyComposition = () => {
return <Video src={staticFile("video.mp4")} />;
};
```
Remote URLs are also supported:
```tsx
<Video src="https://remotion.media/video.mp4" />
```
## Trimming
Use `trimBefore` and `trimAfter` to remove portions of the video. Values are in seconds.
```tsx
const { fps } = useVideoConfig();
return (
<Video
src={staticFile("video.mp4")}
trimBefore={2 * fps} // Skip the first 2 seconds
trimAfter={10 * fps} // End at the 10 second mark
/>
);
```
## Delaying
Wrap the video in a `<Sequence>` to delay when it appears:
```tsx
import { Sequence, staticFile } from "remotion";
import { Video } from "@remotion/media";
const { fps } = useVideoConfig();
return (
<Sequence from={1 * fps}>
<Video src={staticFile("video.mp4")} />
</Sequence>
);
```
The video will appear after 1 second.
## Sizing and Position
Use the `style` prop to control size and position:
```tsx
<Video
src={staticFile("video.mp4")}
style={{
width: 500,
height: 300,
position: "absolute",
top: 100,
left: 50,
objectFit: "cover",
}}
/>
```
## Volume
Set a static volume (0 to 1):
```tsx
<Video src={staticFile("video.mp4")} volume={0.5} />
```
Or use a callback for dynamic volume based on the current frame:
```tsx
import { interpolate } from "remotion";
const { fps } = useVideoConfig();
return (
<Video
src={staticFile("video.mp4")}
volume={(f) =>
interpolate(f, [0, 1 * fps], [0, 1], { extrapolateRight: "clamp" })
}
/>
);
```
Use `muted` to silence the video entirely:
```tsx
<Video src={staticFile("video.mp4")} muted />
```
## Speed
Use `playbackRate` to change the playback speed:
```tsx
<Video src={staticFile("video.mp4")} playbackRate={2} /> {/* 2x speed */}
<Video src={staticFile("video.mp4")} playbackRate={0.5} /> {/* Half speed */}
```
Reverse playback is not supported.
## Looping
Use `loop` to loop the video indefinitely:
```tsx
<Video src={staticFile("video.mp4")} loop />
```
Use `loopVolumeCurveBehavior` to control how the frame count behaves when looping:
- `"repeat"`: Frame count resets to 0 each loop (for `volume` callback)
- `"extend"`: Frame count continues incrementing
```tsx
<Video
src={staticFile("video.mp4")}
loop
loopVolumeCurveBehavior="extend"
volume={(f) => interpolate(f, [0, 300], [1, 0])} // Fade out over multiple loops
/>
```
## Pitch
Use `toneFrequency` to adjust the pitch without affecting speed. Values range from 0.01 to 2:
```tsx
<Video
src={staticFile("video.mp4")}
toneFrequency={1.5} // Higher pitch
/>
<Video
src={staticFile("video.mp4")}
toneFrequency={0.8} // Lower pitch
/>
```
Pitch shifting only works during server-side rendering, not in the Remotion Studio preview or in the `<Player />`.
marketing/skills/youtube/SKILL.md
+175
View File
@@ -0,0 +1,175 @@
---
name: youtube
description: Gestao e optimizacao de canais YouTube. Estrategia de conteudo, SEO, thumbnails e analytics.
layer: wiki
---
# /youtube - YouTube Complete Toolkit
Comando para extrair transcricoes, metadados e estrategia de crescimento de canais YouTube. Best practices 2026.
---
## Contexto NotebookLM
ANTES de executar, consultar notebooks para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Producao de Video e YouTube | `058a896e` | Sempre |
| YouTube Monetizacao e Compliance | `60a209a7` | Para questoes de monetizacao |
```
mcp__notebooklm__notebook_query({
notebook_id: "058a896e-6c9a-4e51-ae7d-9adb2738bc5f",
query: "<adaptar ao contexto>"
})
mcp__notebooklm__notebook_query({
notebook_id: "60a209a7-e205-4d57-a6f3-fef3de61e87a",
query: "<adaptar ao contexto>"
})
```
---
## Arquitectura v3.0.0
| Funcionalidade | Metodo | Estado | Notas |
|----------------|--------|--------|-------|
| **Pesquisa** | MCP youtube-research | OK | Filtros avancados, regiao, legendas |
| **Estatisticas** | MCP youtube-research | OK | Videos, canais, comparacoes |
| **Comentarios** | MCP youtube-research | OK | Com replies e likes |
| **Trending** | MCP youtube-research | OK | Por regiao e categoria |
| **Transcricoes** | Script local | OK | `youtube_extractor.py` (MCP nao funciona) |
| **Upload** | MCP youtube-uploader | Requer Auth | OAuth necessario |
| **Estrategia Crescimento** | Skill internal | OK | Analise algoritmo, optimizacoes |
---
## MCP youtube-research (8/12 funcionais)
### Ferramentas Funcionais
| Ferramenta | Funcao | Parametros |
|------------|--------|------------|
| `search-videos` | Pesquisa avancada | query*, maxResults, regionCode, order, videoDuration |
| `get-video-stats` | Estatisticas video | videoId* |
| `get-video-comments` | Comentarios + replies | videoId*, maxResults, order, includeReplies |
| `get-channel-stats` | Estatisticas canal | channelId* |
| `analyze-channel-videos` | Analise performance | channelId*, maxResults, sortBy |
| `get-trending-videos` | Trending por regiao | regionCode, maxResults, categoryId |
| `get-video-categories` | Categorias disponiveis | regionCode |
| `compare-videos` | Comparar multiplos | videoIds[]* (2-10 videos) |
### Ferramentas com Problemas (nao usar)
| Ferramenta | Problema |
|------------|----------|
| `get-video-transcript` | Nao devolve output |
| `enhanced-transcript` | Transcricao vazia |
| `get-key-moments` | Depende de transcricao |
| `get-segmented-transcript` | Depende de transcricao |
> **Aviso:** As ferramentas de transcricao do MCP youtube-research nao funcionam. Usar sempre o script local.
---
## Transcricoes (Script Local)
```
/media/ealmeida/Dados/Dev/ClaudeDev/Claude-Scripts/youtube-transcript/youtube_extractor.py
```
### Uso
```bash
cd /media/ealmeida/Dados/Dev/ClaudeDev/Claude-Scripts/youtube-transcript/
source venv/bin/activate
python youtube_extractor.py "https://youtube.com/watch?v=xxx"
```
Ou via skill: `/youtube https://youtube.com/watch?v=xxx`
---
## Casos de Uso
### 1. Analise Concorrencia
```javascript
// Pesquisar top videos nicho
mcp__youtube-research__search-videos({
query: "marketing digital portugal",
maxResults: 50,
order: "viewCount",
regionCode: "PT",
videoDuration: "medium"
})
// Analisar canal concorrente
mcp__youtube-research__analyze-channel-videos({
channelId: "UCxxx...",
maxResults: 50,
sortBy: "viewCount"
})
```
### 2. Keyword Research
```javascript
mcp__youtube-research__search-videos({
query: "ganhar dinheiro online",
maxResults: 100,
order: "relevance"
})
// Analisar: titulos mais usados, CTR estimado, competicao
```
### 3. Trending Topics Portugal
```javascript
mcp__youtube-research__get-trending-videos({
regionCode: "PT",
maxResults: 50,
categoryId: "22"
})
```
---
## Metricas Chave (YouTube Studio)
| Metrica | Benchmark | Accao se < Benchmark |
|---------|-----------|----------------------|
| **AVD** (Average View Duration) | > 50% | Melhorar hook, cortar partes fracas |
| **CTR** (Click-Through Rate) | > 8% | Testar thumbnail/titulo |
| **Impressions** | Subir mes a mes | SEO, consistencia uploads |
| **Subscribers Rate** | > 1% views | CTAs mais claros |
| **Likes/Views** | > 5% | Pedir likes com razao |
| **Comments/Views** | > 0.5% | Perguntas no video |
---
## SEO YouTube Rapido
### Titulo (Peso: 40%)
```
[Keyword Principal] + [Beneficio/Curiosidade] + [Trigger]
BOM: "Como Ganhar Dinheiro no YouTube 2026 (5000EUR/Mes)"
BOM: "10 Erros FATAIS em Marketing Digital (Evita #7)"
MAU: "Vlog #247" (sem keyword)
MAU: "INCRIVEL!!! TENS QUE VER ISTO!!!" (clickbait spam)
```
**Regras:** < 60 caracteres, keyword primeiros 5 palavras, numeros especificos.
### Descricao (Peso: 30%)
Estrutura: Resumo + keyword (1a linha) -> Timestamps -> Descricao expandida (min 200 palavras) -> CTAs -> Links -> Hashtags (3-5) -> Contacto
### Tags (Peso: 10%)
10-15 tags total: 1-2 exact keyword + 3-5 variacoes
marketing/skills/youtube/references/strategy-guide.md
+215
View File
@@ -0,0 +1,215 @@
# /youtube - Estratégia de Crescimento e Optimização
## Estratégia Crescimento Canal 2026
### Fase 1: Fundação (0-1K Subscribers)
**Conteúdo:**
- 10-15 vídeos qualidade antes de esperar crescimento
- Foco: Resolver problemas específicos (long-tail keywords)
- Duração: 8-12 minutos (sweet spot retention)
- Frequência: 1-2x/semana consistente
**Optimizações:**
- Thumbnails contrastantes, texto legível mobile
- Títulos: Keyword + benefício (< 60 chars)
- Primeiros 30 segundos: Hook forte
- Descrição: 200+ palavras, keyword-rich
- Tags: 10-15 (variações keyword)
**KPIs:**
- AVD (Average View Duration) > 45%
- CTR > 5%
- 50-100 subs/mês
### Fase 2: Aceleração (1K-10K Subscribers)
**Conteúdo:**
- Analisar top 10 vídeos: Replicar formato/topic
- Criar série (playlist temática, aumenta session time)
- Mix: 70% comprovado, 30% experimental
- Duração: 10-15 minutos
**Optimizações YouTube Studio:**
- End screens (25% boost em views)
- Cards (links vídeos relacionados)
- Playlists organizadas (aumenta binge-watching)
- Community tab (engagement entre vídeos)
- Shorts (teasers vídeos longos)
**KPIs:**
- AVD > 50% | CTR > 8%
- 200-500 subs/mês | 10K+ views/mês
### Fase 3: Escala (10K-100K+ Subscribers)
**Monetização:**
- AdSense (4K watch hours + 1K subs)
- Afiliados/Sponsors
- Produtos próprios (cursos, consultoria)
- Memberships/Super Chat
**KPIs:**
- AVD > 55% | CTR > 10%
- 1K+ subs/mês | 100K+ views/mês
- RPM > 3EUR
---
## Algoritmo YouTube 2026
| Métrica | Peso | Benchmark |
|---------|------|-----------|
| Average View Duration | 40% | > 50% duração vídeo |
| CTR (Click-Through Rate) | 30% | > 8% (home/search) |
| Engagement (likes, comments, shares) | 20% | > 5% views |
| Session Time | 10% | Manter utilizador no YouTube |
**Factores Ranking Pesquisa:**
1. Relevância (title, description, tags match query)
2. Engagement (CTR, tempo visualização, likes)
3. Qualidade (histórico canal, consistência)
4. Frescura (vídeos novos boost temporário 48h)
---
## Optimização Títulos e Thumbnails
### Fórmulas de Títulos que Convertem
| Padrão | Exemplo | CTR Médio |
|--------|---------|-----------|
| Número + Benefício | "7 Truques Para Duplicar Views" | 9-12% |
| Como Fazer | "Como Crescer no YouTube em 2026" | 8-11% |
| Erro Comum | "NUNCA Faças Isto no YouTube" | 10-13% |
| Resultado Surpreendente | "Ganhei 10K Subs em 30 Dias (Como)" | 11-14% |
| Desafio/Experiência | "30 Dias Publicando TODOS os Dias" | 9-12% |
**Regras:**
- < 60 caracteres (não corta em mobile)
- Keyword primeiros 5 palavras (SEO YouTube)
- Maiúsculas estratégicas (1-2 palavras, não spam)
- Números específicos (não "muitos", mas "127")
### Thumbnails que Destacam
**Elementos Críticos:**
1. Rosto/Expressão (70% thumbnails top performers)
2. Texto Legível (3-5 palavras MAX, font grande)
3. Cores Contrastantes (amarelo, laranja, vermelho destacam)
4. Regra dos Terços (rosto/objecto num terço)
**Ferramentas:**
- Canva (templates YouTube)
- Photopea (Photoshop online gratuito)
- Remove.bg (remover backgrounds)
---
## SEO YouTube
### Descrição Optimizada
```markdown
[Primeira linha: Resumo + keyword]
Aprende como ganhar dinheiro no YouTube em 2026.
[Timestamp links]
0:00 Introdução
2:15 Passo 1: Nicho
5:30 Passo 2: Conteúdo
[Descrição expandida - min 200 palavras, keyword 3-5x]
[CTAs]
Subscreve: [URL canal]
Newsletter: [URL]
[Links relacionados]
Vídeo anterior: [URL]
[Hashtags - 3-5 relevantes]
#YouTubeMarketing #GanharDinheiro
[Contacto/Social]
Instagram: @handle
```
### Tags (Estratégia)
```
1. Exact keyword (1-2)
2. Variações (3-5)
3. Long-tail (3-5)
4. Genéricas nicho (2-3)
Total: 10-15 tags
```
---
## Hook Perfeito (Primeiros 30 Segundos)
```
[0-5s] Pattern Interrupt
Imagem/som surpreendente, statement bold
"Ganhei €50K com este canal em 90 dias."
[5-15s] Promessa + Preview
"Neste vídeo, mostro exactamente o método passo a passo."
[15-30s] Credibilidade + CTA Suave
"Faço YouTube há 5 anos. Subscreve para não perder."
[30s+] Conteúdo prometido
Entregar valor IMEDIATAMENTE
```
**Anti-Patterns:**
- Logo intro longa (> 5s)
- "Olá pessoal, tudo bem?" - tempo perdido
- Pedir subscrição ANTES de dar valor
---
## Métricas Chave
| Métrica | Benchmark | Acção se < Benchmark |
|---------|-----------|----------------------|
| AVD | > 50% | Melhorar hook, cortar partes fracas |
| CTR | > 8% | Testar thumbnail/título |
| Subscribers Rate | > 1% views | CTAs mais claros |
| Likes/Views | > 5% | Pedir likes com razão |
---
## Upload com MCP youtube-uploader
```javascript
mcp__youtube-uploader__upload_video({
file_path: "/caminho/completo/video.mp4",
channel_id: "UCxxx...",
title: "Título Optimizado SEO (< 100 chars)",
description: "Descrição completa com timestamps, links, keywords (min 200 palavras)",
tags: "tag1, tag2, tag3",
status: "public",
category_id: "22", // 22 = People & Blogs, 28 = Science & Technology
publish_at: "2026-02-05T18:00:00Z"
})
```
### Configuração Inicial OAuth (uma vez)
1. `mcp__youtube-uploader__authenticate` → URL OAuth2
2. Abrir URL no browser → Login Google → Autorizar
3. Copiar código do redirect → `mcp__youtube-uploader__accesstoken`
---
## Categorias YouTube
| ID | Nome | Uso |
|----|------|-----|
| 22 | People & Blogs | Vlogs, lifestyle |
| 24 | Entertainment | Entretenimento geral |
| 27 | Education | Tutoriais, cursos |
| 28 | Science & Technology | Tech, ciência |