Skill: Criar Curso a partir de Vídeo

Guia Flexível para Usuários Finais

Versão: 2.0.0 Última Atualização: 2025-11-24 Público-Alvo: Clientes/Criadores de Conteúdo Abordagem: Diagnóstico Interativo + Estrutura Adaptativa

Índice

1. Filosofia da Skill
2. Fluxo de Diagnóstico
3. Tipos de Input Suportados
4. Processo Interativo
5. Etapas de Execução
6. Padrões de Transformação
7. Exemplos por Cenário
8. Troubleshooting
9. Referências

Filosofia da Skill

Princípios Fundamentais

┌─────────────────────────────────────────────────────────────────────┐
│                    ESTRUTURA = f(CONTEÚDO)                          │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  ❌ ERRADO: "Todo curso tem 4 seções e 16 módulos"                  │
│                                                                     │
│  ✅ CORRETO: "A estrutura emerge do diagnóstico do conteúdo"        │
│                                                                     │
│  • Vídeo de 30min → Pode ser 1 módulo único                        │
│  • Playlist de 50 vídeos → Pode ser 5 seções com 10 módulos cada   │
│  • Curso de 100h → Pode precisar de hierarquia adicional           │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

O que NÃO é fixo:

• 4 seções → Número de seções definido pelo conteúdo
• 16 módulos → Número de módulos definido pela análise
• 32 horas → Duração real do material
• Flashcards obrigatórios → Opcional conforme necessidade

O que É consistente:

• Processo de diagnóstico interativo
• Padrões de código React/Tailwind
• Nomenclatura UX (Seção, Aula, Curso)
• Integração com sistema existente

Fluxo de Diagnóstico

Etapa 0: Coleta de Informações (OBRIGATÓRIA)

Antes de qualquer ação, Claude deve coletar:

┌─────────────────────────────────────────────────────────────────────┐
│                    DIAGNÓSTICO INICIAL                              │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  1. TIPO DE INPUT                                                   │
│     □ Vídeo único (URL)                                            │
│     □ Playlist YouTube (URL)                                        │
│     □ Múltiplos vídeos avulsos (lista de URLs)                     │
│     □ Série/curso existente (descrição)                            │
│                                                                     │
│  2. CARACTERÍSTICAS DO CONTEÚDO                                     │
│     • Duração total estimada: ___                                  │
│     • Quantidade de vídeos: ___                                    │
│     • Tema/assunto principal: ___                                  │
│     • Público-alvo: ___                                            │
│     • Idioma: ___                                                  │
│                                                                     │
│  3. OBJETIVO DO CURSO                                               │
│     □ Introdução/overview rápido                                   │
│     □ Curso completo estruturado                                   │
│     □ Material de referência/consulta                              │
│     □ Treinamento corporativo                                      │
│                                                                     │
│  4. RECURSOS DESEJADOS                                              │
│     □ Navegação por seções                                         │
│     □ Checkboxes de progresso                                      │
│     □ Flashcards                                                   │
│     □ Exercícios práticos                                          │
│     □ Caderno de notas                                             │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

Perguntas de Diagnóstico (Claude deve fazer)

## Diagnóstico: Criação de Curso

Antes de começarmos, preciso entender melhor seu conteúdo:

1. **Qual é o input?**
   - URL de vídeo único?
   - URL de playlist?
   - Lista de vídeos separados?

2. **Qual a duração aproximada do conteúdo total?**
   - Menos de 1 hora
   - 1-5 horas
   - 5-20 horas
   - Mais de 20 horas

3. **Como você imagina a estrutura do curso?**
   - Um módulo único (conteúdo curto)
   - Poucos módulos (2-5)
   - Estrutura completa com seções
   - Ainda não sei, preciso de sugestão

4. **Quais recursos são importantes?**
   - Progresso com checkboxes
   - Flashcards para revisão
   - Apenas navegação simples

Tipos de Input Suportados

Matriz de Formatos

Decisões Automáticas vs. Interativas

AUTOMÁTICO (Claude decide):
├── Padrão de código (React/Tailwind)
├── Estrutura de arquivos
├── Nomenclatura de componentes
└── Integração técnica

INTERATIVO (Usuário valida):
├── Número de seções
├── Agrupamento de módulos
├── Nomes/títulos
├── Recursos opcionais (flashcards, etc.)
└── Nível de detalhamento

Processo Interativo

Fluxo de Comunicação

┌─────────────────────────────────────────────────────────────────────┐
│                    CICLO DE ALINHAMENTO                             │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  USUÁRIO                          CLAUDE                            │
│     │                                │                              │
│     │──── "Quero criar curso" ──────▶│                              │
│     │                                │                              │
│     │◀─── Perguntas diagnóstico ────│                              │
│     │                                │                              │
│     │──── Respostas ────────────────▶│                              │
│     │                                │                              │
│     │◀─── Proposta de estrutura ────│                              │
│     │     "Baseado no seu input,    │                              │
│     │      sugiro X seções com      │                              │
│     │      Y módulos. Concorda?"    │                              │
│     │                                │                              │
│     │──── Ajustes/Aprovação ────────▶│                              │
│     │                                │                              │
│     │◀─── Execução ─────────────────│                              │
│     │                                │                              │
└─────────────────────────────────────────────────────────────────────┘

Template de Proposta de Estrutura

## Proposta de Estrutura

Baseado na análise do seu conteúdo, sugiro:

### Visão Geral
- **Duração total:** [X horas]
- **Formato:** [descrição]

### Estrutura Proposta

**Opção A: [Nome descritivo]**
- [N] seções
- [M] módulos no total
- Recursos: [lista]

**Opção B: [Nome descritivo]**
- [N'] seções
- [M'] módulos no total
- Recursos: [lista]

### Perguntas de Refinamento
1. Qual opção prefere?
2. Algum ajuste nos agrupamentos?
3. Quer adicionar/remover recursos?

Aguardo sua validação antes de prosseguir.

Etapas de Execução

Etapa 1: Extração de Transcrições

Adaptável conforme input:

# Vídeo único
python youtube_transcript.py "URL_VIDEO"

# Playlist (extrair lista primeiro)
# Claude analisa playlist e propõe agrupamentos

# Múltiplos vídeos
python youtube_transcript.py --batch lista_videos.txt

Etapa 2: Análise e Proposta

Claude analisa e propõe (não executa ainda):

Analisei as transcrições e identifiquei:

- [X] tópicos principais
- [Y] subtópicos
- Duração: [Z] horas

Proposta de organização:
[estrutura sugerida]

Posso prosseguir com essa estrutura?

Etapa 3: Criação de Dados (após aprovação)

Estrutura adaptativa:

// Exemplo: curso CURTO (1 vídeo, 2h)
export const fases[Nome] = [
  { id: 1, nome: "Conteúdo Completo", ... }
];

export const modulos[Nome] = [
  { id: '1.1', nome: 'Introdução', ... },
  { id: '1.2', nome: 'Conceitos', ... },
  { id: '1.3', nome: 'Prática', ... }
];

// Exemplo: curso EXTENSO (playlist 50 vídeos)
export const fases[Nome] = [
  { id: 1, nome: "Fundamentos", ... },
  { id: 2, nome: "Intermediário", ... },
  { id: 3, nome: "Avançado", ... },
  { id: 4, nome: "Especialização", ... },
  { id: 5, nome: "Projetos", ... }
];

export const modulos[Nome] = [
  // 50 módulos organizados nas 5 seções
];

Etapa 4: Transformação de Conteúdo

Nível de detalhamento conforme necessidade:

Etapa 5: Integração

Sempre necessário:

• Atualizar

  studyAreas.js

• Atualizar

  SistemaEducacionalCompleto.jsx

Opcional conforme escopo:

• Criar NotesView para cada módulo
• Criar flashcards
• Criar exercícios

Padrões de Transformação

Transformação Básica (qualquer curso)

<h2 className="text-2xl font-bold">

<p className="text-gray-700">

<ul className="list-disc">

Transformação Intermediária (cursos médios+)

<CodeBlock code={...}>

<div className="bg-yellow-50 border">

<div className="bg-[cor]-100 p-4 rounded">

Transformação Avançada (cursos extensos)

Exemplos por Cenário

Cenário 1: Vídeo Curto (45 min)

INPUT: "Tenho um vídeo de 45 min sobre Git básico"

DIAGNÓSTICO:
- Tipo: Vídeo único curto
- Duração: < 1h
- Objetivo: Introdução

PROPOSTA:
- 1 seção única
- 3-4 módulos (Intro, Comandos, Branches, Prática)
- Sem flashcards (opcional)
- Progresso simples

RESULTADO:
├── gitLearningData.js (1 fase, 4 módulos)
└── GitLearningSystem.jsx (componente simples)

Cenário 2: Playlist Média (20 vídeos, 15h)

INPUT: "Playlist de Docker com 20 vídeos"

DIAGNÓSTICO:
- Tipo: Playlist média
- Duração: ~15h
- Objetivo: Curso completo

PROPOSTA:
- 4 seções (Básico, Imagens, Compose, Produção)
- 20 módulos (1 por vídeo)
- Flashcards por seção
- Progresso detalhado

RESULTADO:
├── dockerLearningData.js (4 fases, 20 módulos)
├── DockerLearningSystem.jsx
├── DockerNotesView.jsx (4 arquivos, 1 por seção)
└── Flashcards integrados

Cenário 3: Mega-Playlist (100+ vídeos)

INPUT: "Curso completo de Python, 150 vídeos"

DIAGNÓSTICO:
- Tipo: Playlist muito grande
- Duração: 80h+
- Objetivo: Formação completa

PROPOSTA INTERATIVA:
"Este é um curso extenso. Sugiro dividir em TRILHAS:

Trilha 1: Python Básico (30 vídeos)
Trilha 2: Python Intermediário (40 vídeos)
Trilha 3: Python Avançado (40 vídeos)
Trilha 4: Projetos (40 vídeos)

Cada trilha seria um 'curso' separado no sistema.
Concorda com essa abordagem?"

RESULTADO (após aprovação):
├── pythonBasicoLearningData.js
├── pythonIntermedLearningData.js
├── pythonAvancadoLearningData.js
├── pythonProjetosLearningData.js
└── Componentes correspondentes

Troubleshooting

Problema: Não sei quantas seções criar

Solução: Claude analisa e propõe baseado em:

• Mudanças de tema na transcrição
• Duração relativa dos blocos
• Complexidade do conteúdo

Problema: Vídeos da playlist são muito heterogêneos

Solução: Claude sugere agrupamentos e pede validação:

"Identifiquei 3 temas diferentes na playlist:
- Vídeos 1-8: Fundamentos
- Vídeos 9-15: Aplicações
- Vídeos 16-20: Avançado

Posso agrupar assim ou prefere outra organização?"

Problema: Conteúdo muito curto para estrutura completa

Solução: Claude sugere estrutura mínima:

"Com apenas 30 minutos de conteúdo, sugiro:
- 1 módulo único com 3-4 seções internas
- Sem necessidade de NotesView separado
- Progresso simples (completo/não completo)

Prefere essa abordagem simplificada?"

Problema: Transcrição não disponível

Solução: Claude oferece alternativas:

"O vídeo não tem transcrição automática. Opções:

1. Transcrever manualmente (você fornece texto)
2. Usar serviço externo de transcrição
3. Criar estrutura baseada em títulos/descrições
4. Assistir e anotar tópicos principais

Qual prefere?"

Referências

Arquivos de Referência

src/data/bashLearningData.js

src/components/BashNotesView.jsx

docs/TEMPLATE-CURSO-PADRAO.md

docs/GUIA-TRANSCRICAO-PARA-CURSO.md

Skills Relacionadas

• platform-architecture - Arquitetura do sistema
• learning-path-patterns - Padrões de trilhas
• component-refactor - Refatoração de componentes

Agent Relacionado

• learning-path-architect - Extração de transcrições

Checklist Adaptativo

Sempre obrigatório:

• Diagnóstico inicial realizado
• Estrutura proposta e aprovada pelo usuário
• Arquivo de dados criado
• Integração com sistema principal
• Build passa sem erros

Conforme necessidade:

• NotesView criado (se curso médio+)
• Flashcards criados (se solicitado)
• Múltiplas seções (se conteúdo extenso)
• Trilhas separadas (se mega-curso)

Resumo: Fluxo Completo

1. USUÁRIO fornece input (URL, playlist, descrição)
           ↓
2. CLAUDE faz perguntas de diagnóstico
           ↓
3. USUÁRIO responde características
           ↓
4. CLAUDE propõe estrutura adaptada
           ↓
5. USUÁRIO valida/ajusta proposta
           ↓
6. CLAUDE executa criação
           ↓
7. USUÁRIO testa e aprova

Princípio Central: A estrutura serve o conteúdo, não o contrário.

Você está em:

.claude/skills/cliente:criar-a-partir-video/SKILL.md