feat: refactor 30+ skills to Anthropic progressive disclosure pattern

- All SKILL.md files now <500 lines (avg reduction 69%) - Detailed content extracted to references/ subdirectories - Frontmatter standardised: only name + description (Anthropic standard) - New skills: brand-guidelines, spec-coauthor, report-templates, skill-creator - Design skills: anti-slop guidelines, premium-proposals reference - Removed non-standard frontmatter fields (triggers, version, author, category) Plugins affected: infraestrutura, marketing, dev-tools, crm-ops, gestao, core-tools, negocio, perfex-dev, wordpress, design-media Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 15:05:03 +00:00
parent 9404af7ac9
commit 6b3a6f2698
397 changed files with 67154 additions and 17257 deletions
--- a/marketing/skills/youtube/SKILL.md
+++ b/marketing/skills/youtube/SKILL.md
@@ -1,464 +1,109 @@
 ---
 name: youtube
-description: YouTube channel management and optimization. Content strategy, SEO, thumbnails,
-  and analytics. Use when user mentions "youtube", "canal youtube", "youtube seo",
-  "video optimization", "youtube analytics".
-author: Descomplicar® Crescimento Digital
-version: 3.0.0
-quality_score: 75
-user_invocable: true
-desk_task: 1490
-allowed-tools: Edit, Task
+description: Gestao e optimizacao de canais YouTube. Estrategia de conteudo, SEO, thumbnails e analytics.
 ---

 # /youtube - YouTube Complete Toolkit

-Comando para extrair transcrições, metadados E estratégia de crescimento de canais YouTube. Best practices 2026.
+Comando para extrair transcricoes, metadados e estrategia de crescimento de canais YouTube. Best practices 2026.

 ---

-## 🎯 Arquitectura v3.0.0
+## Contexto NotebookLM

-| Funcionalidade | Método | Estado | Notas |
+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 avançados, região, legendas |
-| **Estatísticas** | MCP youtube-research | ✅ OK | Vídeos, canais, comparações |
-| **Comentários** | MCP youtube-research | ✅ OK | Com replies e likes |
-| **Trending** | MCP youtube-research | ✅ OK | Por região e categoria |
-| **Transcrições** | Script local | ✅ OK | `youtube_extractor.py` (MCP não funciona) |
-| **Upload** | MCP youtube-uploader | ⚠️ Requer Auth | OAuth necessário |
-| **Estratégia Crescimento** | 🆕 Skill internal | ✅ OK | Análise algoritmo, optimizações |
+| **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 |

 ---

-## 📊 Algoritmo YouTube 2026 - Como Funciona
-
-### Watch Time é Rei
-
-| Métrica | Peso | Impacto | Benchmark |
-|---------|------|---------|-----------|
-| **Average View Duration** | 40% | Muito Alto | > 50% duração vídeo |
-| **CTR (Click-Through Rate)** | 30% | Alto | > 8% (home/search) |
-| **Engagement (likes, comments, shares)** | 20% | Médio-Alto | > 5% views |
-| **Session Time** | 10% | Médio | 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)
-
-### Factores Recomendações (Home/Sidebar)
-
-1. **Histórico utilizador** (vídeos similares assistidos)
-2. **Session time** (vídeos que mantêm utilizador na plataforma)
-3. **CTR + Retention** (thumbnail + primeiros 30 segundos)
-4. **Canal performance** (consistência uploads, engagement médio)
-
---
-
-## 🚀 Estratégia Crescimento Canal 2026
-
-### Fase 1: Fundação (0-1K Subscribers)
-
-**Objectivo:** Encontrar nicho e provar conceito
-
-```markdown
-**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)
-
-**Promoção:**
- Reddit, Quora, fóruns nicho
- Colaborar com canais similares (500-5K subs)
- Partilhar em grupos Facebook/LinkedIn
-```
-
-**KPIs:**
- AVD (Average View Duration) > 45%
- CTR > 5%
- 50-100 subs/mês
-
-### Fase 2: Aceleração (1K-10K Subscribers)
-
-**Objectivo:** Escalar o que funciona, construir audiência
-
-```markdown
-**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 (mais anúncios, melhor revenue)
-
-**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, crescimento rápido)
-
-**Promoção:**
- Email list (converter viewers em subscribers)
- Cross-promote Instagram/TikTok
- Guest appearances podcasts
-```
-
-**KPIs:**
- AVD > 50%
- CTR > 8%
- 200-500 subs/mês
- 10K+ views/mês
-
-### Fase 3: Escala (10K-100K+ Subscribers)
-
-**Objectivo:** Monetizar e profissionalizar
-
-```markdown
-**Conteúdo:**
- 2-3x/semana upload schedule
- Vídeos mais longos (15-20 min) se retention mantém
- Invest em produção (lighting, áudio, edição)
- Série flagship (identidade canal)
-
-**Monetização:**
- AdSense (4K watch hours + 1K subs)
- Afiliados/Sponsors (produtos relevantes)
- Produtos próprios (cursos, consultoria)
- Memberships/Super Chat
-
-**Team:**
- Editor vídeo (libertar tempo para conteúdo)
- Thumbnail designer (crítico para CTR)
- Community manager (responder comentários)
-```
-
-**KPIs:**
- AVD > 55%
- CTR > 10%
- 1K+ subs/mês
- 100K+ views/mês
- RPM (Revenue Per Mille) > €3
-
---
-
-## 🎨 Optimização Títulos e Thumbnails
-
-### Títulos que Convertem (CTR > 10%)
-
-**Fórmulas Testadas:**
-
-| 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")
- **Trigger curiosidade** (sem clickbait excessivo)
-
-### Thumbnails que Destacam (CTR > 10%)
-
-```markdown
-**Elementos Críticos:**
-
-1. **Rosto/Expressão** (70% thumbnails top performers)
-   - Close-up rosto
-   - Expressão exagerada (surpresa, choque, alegria)
-   - Contraste alto (destaca em feed)
-
-2. **Texto Legível** (3-5 palavras MAX)
-   - Font grande (Montserrat Bold, Impact)
-   - Contraste cores (amarelo/preto, branco/vermelho)
-   - Legível em mobile (90% views)
-
-3. **Cores Contrastantes**
-   - Amarelo, laranja, vermelho (destacam)
-   - Evitar verde, azul (funde com YouTube UI)
-   - Background simples (não cluttered)
-
-4. **Regra dos Terços**
-   - Rosto/objecto principal num terço
-   - Espaço negativo equilibrado
-   - Não centrar tudo
-```
-
-**Ferramentas:**
- Canva (templates YouTube)
- Photopea (Photoshop online gratuito)
- Remove.bg (remover backgrounds)
-
-**A/B Testing:**
- YouTube permite trocar thumbnail DEPOIS upload
- Testar 2-3 variações primeiras 48h
- Manter versão com melhor CTR
-
---
-
-## 📝 Optimização SEO YouTube
-
-### Título (Peso: 40%)
-
-```
-[Keyword Principal] + [Benefício/Curiosidade] + [Trigger]
-
-✅ "Como Ganhar Dinheiro no YouTube 2026 (€5K/Mês)"
-✅ "Photoshop para Iniciantes - Tutorial Completo PT"
-✅ "10 Erros FATAIS em Marketing Digital (Evita #7)"
-
-❌ "Vlog #247" (sem keyword)
-❌ "INCRÍVEL!!! TENS QUE VER ISTO!!!" (clickbait spam)
-```
-
-### Descrição (Peso: 30%)
-
-```markdown
-**Estrutura Optimizada:**
-
-[Primeira linha: Resumo + keyword - aparece em pesquisa]
-Aprende como ganhar dinheiro no YouTube em 2026. Estratégia completa para iniciantes.
-
-[Timestamp links - aumenta retention]
-0:00 Introdução
-2:15 Passo 1: Nicho
-5:30 Passo 2: Conteúdo
-10:45 Passo 3: Monetização
-
-[Descrição expandida - min 200 palavras, keyword 3-5x]
-Neste vídeo, mostro exactamente como ganhar dinheiro no YouTube...
-
-[CTAs]
-🔔 Subscreve: [URL canal]
-📧 Newsletter: [URL]
-💬 Discord: [URL]
-
-[Links relacionados]
-👉 Vídeo anterior: [URL]
-👉 Playlist: [URL]
-
-[Hashtags - 3-5 relevantes]
-#YouTubeMarketing #GanharDinheiro #YouTubePortugues
-
-[Contacto/Social]
-Instagram: @handle
-Email: email@domain.pt
-```
-
-### Tags (Peso: 10%)
-
-```
-**Estratégia Tags:**
-
-1. **Exact keyword** (1-2)
-   - "ganhar dinheiro youtube"
-   - "youtube portugal"
-
-2. **Variações** (3-5)
-   - "como ganhar dinheiro no youtube"
-   - "monetizar canal youtube"
-   - "youtube para iniciantes"
-
-3. **Long-tail** (3-5)
-   - "ganhar dinheiro youtube 2026"
-   - "monetizar youtube portugal"
-
-4. **Genéricas nicho** (2-3)
-   - "marketing digital"
-   - "empreendedorismo online"
-
-**Total: 10-15 tags**
-```
-
---
-
-## 🎬 Hook Perfeito (Primeiros 30 Segundos)
-
-**80% viewers decide ficar ou sair nos primeiros 30 segundos.**
-
-### Framework Hook
-
-```
-[0-5s] **Pattern Interrupt**
-Imagem/som surpreendente, statement bold
-"Ganhei €50K com este canal em 90 dias."
-
-[5-15s] **Promessa + Preview**
-O que vão aprender + teaser resultado
-"Neste vídeo, mostro exactamente o método passo a passo. Incluindo screenshots das minhas receitas."
-
-[15-30s] **Credibilidade + CTA Suave**
-Porque confiar + pedir subscrição
-"Faço YouTube há 5 anos, 3 canais crescidos. Se queres crescer também, subscreve para não perder novos vídeos."
-
-[30s+] **Conteúdo prometido**
-Entregar valor IMEDIATAMENTE
-```
-
-**Anti-Patterns:**
- ❌ Logo intro longa (> 5s) - viewers saem
- ❌ "Olá pessoal, tudo bem?" - tempo perdido
- ❌ Pedir subscrição ANTES de dar valor
- ❌ Música intro sem valor
-
---
-
-## 📊 Métricas Chave (YouTube Studio)
-
-### Dashboard Essenciais
-
-| Métrica | Fórmula | Benchmark | Acção se < Benchmark |
-|---------|---------|-----------|----------------------|
-| **AVD** | Tempo médio visualização / Duração vídeo | > 50% | Melhorar hook, cortar partes fracas |
-| **CTR** | Cliques / Impressões | > 8% | Testar thumbnail/título |
-| **Impressions** | Vezes thumbnail mostrado | Subir mês a mês | SEO, consistência uploads |
-| **Subscribers Rate** | Novos subs / Views | > 1% | CTAs mais claros, conteúdo mais valioso |
-| **Likes/Views** | Likes / Views | > 5% | Engagement, pedir likes (com razão) |
-| **Comments/Views** | Comments / Views | > 0.5% | Perguntas no vídeo, responder comments |
-
-### Análise Audiência
-
-```markdown
-**Demografia:** Ajustar conteúdo para maioria
- Idade: 25-34 (60%) → Tom informal, memes
- Género: 70% masculino → Topics, exemplos
- Geografia: 80% Portugal → PT-PT, contextos locais
-
-**Quando Assistem:** Optimizar schedule uploads
- Pico: Terça/Quinta 19h-21h → Upload 18h
-
-**Dispositivos:** 85% mobile → Testar tudo em telemóvel
-```
-
---
-
-## 🛠️ MCP youtube-research (8/12 funcionais)
+## MCP youtube-research (8/12 funcionais)

 ### Ferramentas Funcionais

-| Ferramenta | Função | Parâmetros |
+| Ferramenta | Funcao | Parametros |
 |------------|--------|------------|
-| `search-videos` | Pesquisa avançada | query*, maxResults, regionCode, order, videoDuration |
-| `get-video-stats` | Estatísticas vídeo | videoId* |
-| `get-video-comments` | Comentários + replies | videoId*, maxResults, order, includeReplies |
-| `get-channel-stats` | Estatísticas canal | channelId* |
-| `analyze-channel-videos` | Análise performance | channelId*, maxResults, sortBy |
-| `get-trending-videos` | Trending por região | regionCode, maxResults, categoryId |
-| `get-video-categories` | Categorias disponíveis | regionCode |
-| `compare-videos` | Comparar múltiplos | videoIds[]* (2-10 vídeos) |
+| `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 (NÃO USAR)
+### Ferramentas com Problemas (nao usar)

-| Ferramenta | Estado | Problema |
-|------------|--------|----------|
-| `get-video-transcript` | ❌ | Não devolve output |
-| `enhanced-transcript` | ❌ | Transcrição vazia |
-| `get-key-moments` | ❌ | Depende de transcrição |
-| `get-segmented-transcript` | ❌ | Depende de transcrição |
+| Ferramenta | Problema |
+|------------|----------|
+| `get-video-transcript` | Nao devolve output |
+| `enhanced-transcript` | Transcricao vazia |
+| `get-key-moments` | Depende de transcricao |
+| `get-segmented-transcript` | Depende de transcricao |

-> [!warning] Transcrições via MCP
-> As ferramentas de transcrição do MCP youtube-research **NÃO FUNCIONAM**.
-> Usar sempre o script local `youtube_extractor.py` para transcrições.
+> **Aviso:** As ferramentas de transcricao do MCP youtube-research nao funcionam. Usar sempre o script local.

 ---

-## 📜 Transcrições (Script Local)
+## Transcricoes (Script Local)

-**As transcrições via MCP não funcionam. Usar sempre o script local.**
-
-### Localização
 ```
 /media/ealmeida/Dados/Dev/ClaudeDev/Claude-Scripts/youtube-transcript/youtube_extractor.py
 ```

-### Uso Directo
+### 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"
 ```

-### Via Skill
-```
-/youtube https://youtube.com/watch?v=xxx
-```
+Ou via skill: `/youtube https://youtube.com/watch?v=xxx`

 ---

-## 📤 Upload de Vídeos (MCP youtube-uploader)
+## Casos de Uso

-### Configuração Inicial (uma vez)
-
-```
-1. mcp__youtube-uploader__authenticate
-   → Devolve URL OAuth2
-
-2. Abrir URL no browser → Login Google → Autorizar
-
-3. Copiar código do redirect (?code=xxx)
-
-4. mcp__youtube-uploader__accesstoken
-   → Parâmetro: code (só o código, não URL completo)
-
-5. Guardar channel_id devolvido
-```
-
-### Upload Completo
+### 1. Analise Concorrencia

 ```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, tag4, tag5",
-  status: "public", // ou "private", "unlisted"
-  category_id: "22", // 22 = People & Blogs, 28 = Science & Technology
-  publish_at: "2026-02-05T18:00:00Z" // Opcional, agendamento
-})
-```
-
-### Categorias Principais
-
-| ID | Nome | Uso |
-|----|------|-----|
-| 1 | Film & Animation | Vídeos cinematográficos |
-| 10 | Music | Música, covers |
-| 20 | Gaming | Gameplays, reviews jogos |
-| 22 | People & Blogs | Vlogs, lifestyle |
-| 24 | Entertainment | Entretenimento geral |
-| 25 | News & Politics | Notícias, análise política |
-| 27 | Education | Tutoriais, cursos |
-| 28 | Science & Technology | Tech, ciência |
-
---
-
-## 💡 Casos de Uso
-
-### 1. Análise Concorrência
-
-```javascript
-// Pesquisar top vídeos nicho
+// Pesquisar top videos nicho
 mcp__youtube-research__search-videos({
  query: "marketing digital portugal",
  maxResults: 50,
  order: "viewCount",
  regionCode: "PT",
-  videoDuration: "medium" // 4-20 min
+  videoDuration: "medium"
 })

 // Analisar canal concorrente
@@ -467,28 +112,17 @@ mcp__youtube-research__analyze-channel-videos({
  maxResults: 50,
  sortBy: "viewCount"
 })
-
-// Insights:
-// - Topics mais populares
-// - Duração média top performers
-// - Frequência uploads
-// - Engagement médio
 ```

 ### 2. Keyword Research

 ```javascript
-// Pesquisar variações keyword
 mcp__youtube-research__search-videos({
  query: "ganhar dinheiro online",
  maxResults: 100,
  order: "relevance"
 })
-
-// Analisar:
-// - Títulos mais usados
-// - CTR estimado (views / idade vídeo)
-// - Competição (quantos vídeos topic)
+// Analisar: titulos mais usados, CTR estimado, competicao
 ```

 ### 3. Trending Topics Portugal
@@ -497,101 +131,99 @@ mcp__youtube-research__search-videos({
 mcp__youtube-research__get-trending-videos({
  regionCode: "PT",
  maxResults: 50,
-  categoryId: "22" // People & Blogs
+  categoryId: "22"
 })
-
-// Criar conteúdo relacionado com trending
 ```

 ---

-## 📚 Datasets Dify (Consulta Obrigatória)
+## Metricas Chave (YouTube Studio)

-| Dataset | ID | Prioridade | Uso |
-|---------|----|-----------:|-----|
-| **Youtube Marketing** | `baa1b3e6-ebf0-4413-84b2-63d1164867ea` | 1 | Crescimento canal, algoritmo |
-| **Marketing Redes Sociais** | `66117552-348f-455d-9aca-2da722567693` | 2 | Estratégia vídeo, engagement |
-| **Marketing Digital** | `c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24` | 3 | Estratégia geral, métricas |
+| 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 |

-### Como Consultar
+---
+
+## 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 + 3-5 long-tail + 2-3 genericas nicho.
+
+---
+
+## Upload de Videos (MCP youtube-uploader)
+
+### Configuracao Inicial (uma vez)
+
+1. `mcp__youtube-uploader__authenticate` -> URL OAuth2
+2. Abrir URL no browser -> Login Google -> Autorizar
+3. Copiar codigo do redirect -> `mcp__youtube-uploader__accesstoken`
+
+### Upload Completo

 ```javascript
-// Estratégias crescimento YouTube
-mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
-  dataset_id: "baa1b3e6-ebf0-4413-84b2-63d1164867ea",
-  query: "algoritmo youtube crescimento subscribers 2026"
-})
-
-// Optimização vídeos
-mcp__dify-kb__dify_kb_retrieve_segments({
-  dataset_id: "baa1b3e6-ebf0-4413-84b2-63d1164867ea",
-  query: "seo youtube tags thumbnails títulos CTR"
-})
-
-// Estratégia conteúdo vídeo
-mcp__dify-kb__dify_kb_retrieve_segments({
-  dataset_id: "66117552-348f-455d-9aca-2da722567693",
-  query: "video marketing engagement retention hook"
+mcp__youtube-uploader__upload_video({
+  file_path: "/caminho/completo/video.mp4",
+  channel_id: "UCxxx...",
+  title: "Titulo Optimizado SEO (< 100 chars)",
+  description: "Descricao completa com timestamps, links, keywords (min 200 palavras)",
+  tags: "tag1, tag2, tag3",
+  status: "public",
+  category_id: "22",
+  publish_at: "2026-02-05T18:00:00Z"
 })
 ```

-### Quando Consultar
- **Estratégia crescimento canal** (0-100K subs)
- **Optimização títulos/thumbnails** (CTR < 8%)
- **Análise concorrência** (pesquisa keywords)
- **Melhores práticas upload** (SEO YouTube)
- **Monetização** (AdSense, sponsors, produtos)
+### Categorias Principais
+
+| ID | Nome | Uso |
+|----|------|-----|
+| 22 | People & Blogs | Vlogs, lifestyle |
+| 24 | Entertainment | Entretenimento geral |
+| 27 | Education | Tutoriais, cursos |
+| 28 | Science & Technology | Tech, ciencia |

 ---

-## 📈 Instrumentação Automática
+## Referencias Detalhadas

-```sql
-INSERT INTO tblskill_agent_metrics (
-  type, name, duration_ms, status, staff_id,
-  kb_consulted, kb_cache_hit, tool_calls, project_id
-) VALUES (
-  'skill', '/youtube', {DURACAO_MS}, '{STATUS}', 25,
-  {KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
-);
-```
+Para conteudo detalhado, consultar:
+
+- [references/strategy-guide.md](references/strategy-guide.md) - Estrategia crescimento (3 fases: 0-1K, 1K-10K, 10K-100K+), algoritmo YouTube 2026, optimizacao titulos/thumbnails, SEO YouTube completo, hook framework, metricas detalhadas, upload com MCP

 ---

-**Versão**: 3.0.0 | **Data**: 2026-02-03 | **Autor**: Descomplicar®
-**Desk Task:** #1490 | **Standards:** Algoritmo YouTube 2026, Crescimento Orgânico
-**Script transcrições**: `/media/ealmeida/Dados/Dev/ClaudeDev/Claude-Scripts/youtube-transcript/youtube_extractor.py`
+## Anti-Patterns
+
+- Nao usar para tarefas fora do dominio YouTube
+- Nao usar MCPs de transcricao (usar script local)
+- Nao prometer uploads sem OAuth configurado
+
+---
+
+**Script transcricoes**: `/media/ealmeida/Dados/Dev/ClaudeDev/Claude-Scripts/youtube-transcript/youtube_extractor.py`
 **MCPs**: youtube-research (8/12 OK), youtube-uploader (requer auth)
-
---
-
-
-## Quando NÃO Usar
-
- Para tarefas fora do domínio de especialização desta skill
- Quando outra skill mais específica está disponível
- Para operações que requerem confirmação manual do utilizador
-
-
-## Protocolo
-
-1. Analisar requisitos da tarefa
-2. Verificar disponibilidade de ferramentas necessárias
-3. Executar operações de forma incremental
-4. Validar resultados antes de concluir
-5. Reportar status e próximos passos
-
-
-## Exemplos
-
-### Exemplo 1: Uso Básico
-```
-Input: [descrição da tarefa]
-Output: [resultado esperado]
-```
-
-### Exemplo 2: Uso Avançado
-```
-Input: [caso complexo]
-Output: [resultado detalhado]
-```
--- a/marketing/skills/youtube/references/strategy-guide.md
+++ b/marketing/skills/youtube/references/strategy-guide.md
@@ -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 |