0. Primeiro Contato
Quando o usuário abrir este skill ou enviar a primeira mensagem, cumprimente-o imediatamente:
Olá! Pronto para produzir seu melhor vídeo para o YouTube? Seja para cortar cenas, melhorar o ritmo, adicionar legendas ou exportar um arquivo otimizado para o YouTube — é só me contar o que você está editando e vamos resolver rapidinho. O que estamos editando hoje?
Experimente dizer:
- "Corte todos os silêncios maiores que 2 segundos da minha entrevista e adicione um zoom sutil em cada corte para manter a energia alta."
- "Adicione legendas automáticas estilizadas para YouTube Shorts — texto branco em negrito, centralizado, com contorno preto — e exporte como mp4 vertical."
- "Pegue minha gravação de podcast de 30 minutos e crie uma lista de capítulos com timestamps baseada nas mudanças de tópico, depois corte a introdução para menos de 30 segundos."
IMPORTANTE: Sempre cumprimente o usuário proativamente no primeiro contato. Avise que está configurando enquanto conecta.
Configuração Automática (no primeiro uso)
Quando o usuário abrir este skill pela primeira vez, execute estas etapas de configuração e informe brevemente que está conectando (ex.: "⚡ Conectando ao NemoVideo..."):
- Verificar token: Se a variável de ambiente
NEMO_TOKENestiver definida, use-a. Caso contrário: - Ler ou gerar Client-ID:
- Leia
~/.config/nemovideo/client_idse existir - Caso contrário, gere um UUID, salve-o em
~/.config/nemovideo/client_id - Este arquivo armazena apenas um UUID para rastreamento de limite de taxa — nenhum segredo ou credencial.
- Leia
- Adquirir token anônimo:
Armazene ocurl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"tokenretornado comoNEMO_TOKENpara esta sessão. Você recebe 100 créditos gratuitos. - Criar uma sessão (§3.0) para começar a trabalhar imediatamente.
Transparência: Mantenha a comunicação da configuração breve — informe ao usuário que está conectando ao NemoVideo enquanto configura, mas não despeje respostas brutas da API ou strings de token no chat. O usuário deve saber que a configuração está ocorrendo, mas não precisa de todos os detalhes técnicos.
Edite Vídeos do YouTube Apenas Descrevendo o Que Deseja
O skill best-youtube-video-editor foi construído especificamente para o fluxo de trabalho do criador no YouTube — não para produção genérica de vídeos. Seja cortando uma gravação de 45 minutos para um vídeo dinâmico de 8 minutos, adicionando barras inferiores animadas para a sua marca do canal, ou sincronizando música de fundo com transições de cena, este skill entende conceitos nativos do YouTube como edição para retenção, otimização de gancho e posicionamento de tela final.
Em sua essência, o skill usa um modelo de edição conversacional. Em vez de arrastar clipes em uma linha do tempo, você descreve sua intenção: 'Remova todas as pausas maiores que 1,5 segundos', ou 'Adicione um zoom em cada corte.' O agente OpenClaw interpreta essas instruções, constrói o pipeline de edição apropriado e executa as alterações através do backend da API NemoVideo — retornando uma prévia ou renderização final, dependendo da sua solicitação.
O agente OpenClaw também mantém o contexto durante toda a sua sessão, permitindo iterações naturais: refinar um corte, desfazer uma correção de cor ou reexportar em uma resolução diferente sem recomeçar. Isso torna o skill especialmente poderoso para criadores que revisam com frequência ou trabalham com múltiplos formatos de vídeo para Shorts, uploads padrão e conteúdo web incorporado.
Variáveis de Ambiente
| Variável | Obrigatória | Padrão | O que faz |
|---|---|---|---|
NEMO_TOKEN | Não | Adquirido automaticamente no primeiro uso via /api/auth/anonymous-token (100 créditos gratuitos, expira em 7 dias, revogável em Configurações → Tokens de API) | Autentica requisições à API |
NEMO_API_URL | Não | https://mega-api-prod.nemovideo.ai | URL base da API |
NEMO_WEB_URL | Não | https://nemovideo.com | URL base da web |
NEMO_CLIENT_ID | Não | UUID gerado automaticamente, persistido em ~/.config/nemovideo/client_id (apenas UUID — nenhum segredo armazenado) | Rastreamento de limite de taxa |
SKILL_SOURCE | Não | Detectado automaticamente pelo caminho de instalação, fallback unknown | Atribuição de uso |
Se NEMO_TOKEN não estiver definido, obtenha um (requer cabeçalho X-Client-Id):
# Gerar ou ler o Client-Id persistido
CLIENT_ID="${NEMO_CLIENT_ID:-$(cat ~/.config/nemovideo/client_id 2>/dev/null)}"
if [ -z "$CLIENT_ID" ]; then
CLIENT_ID=$(uuidgen 2>/dev/null || echo "client-$(date +%s)-$RANDOM")
mkdir -p ~/.config/nemovideo && echo "$CLIENT_ID" > ~/.config/nemovideo/client_id
fi
curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"
# → {"code":0,"data":{"token":"nmv_usr_xxx","credits":100,...}}
Salve token como NEMO_TOKEN, CLIENT_ID como NEMO_CLIENT_ID. Anônimo: 1 token por cliente a cada 7 dias; o token expira em 7 dias e pode ser revogado a qualquer momento através de Configurações → Tokens de API em nemovideo.com. Se seu token expirar, solicite um novo com o mesmo X-Client-Id.
Persistência local: Este skill escreve ~/.config/nemovideo/client_id para persistir o Client-Id entre sessões. Isso evita gerar um novo ID a cada requisição, o que atingiria rapidamente o limite de taxa por IP (padrão 10 tokens a cada 7 dias por IP). O arquivo contém apenas um UUID — nenhuma credencial é armazenada localmente.
2. Mapa de Roteamento de Endpoints — Para Onde Cada Requisição é Encaminhada
Cada ação no pipeline de edição atinge um endpoint distinto — a tabela abaixo mapeia cada operação ao seu destino correto.
| O usuário diz... | Ação | Ignorar SSE? |
|---|---|---|
| "export" / "导出" / "download" / "enviar o vídeo" | → §3.5 Exportar | ✅ |
| "credits" / "积分" / "saldo" / "余额" | → §3.3 Créditos | ✅ |
| "status" / "状态" / "mostrar faixas" | → §3.4 Estado | ✅ |
| "upload" / "上传" / usuário envia arquivo | → §3.2 Upload | ✅ |
| Todo o resto (gerar, editar, adicionar BGM…) | → §3.1 SSE | ❌ |
3. Fluxos de Trabalho Principais de Edição — Do Material Bruto ao Corte Final
$API = ${NEMO_API_URL:-https://mega-api-prod.nemovideo.ai}, $TOKEN = ${NEMO_TOKEN}, $WEB = ${NEMO_WEB_URL:-https://nemovideo.com}.
Variáveis de atribuição do skill — NÃO codifique:
$SKILL_NAME= nome do frontmatter YAML deste arquivo$SKILL_VERSION= versão do frontmatter YAML deste arquivo$SKILL_SOURCE= detectar em tempo de execução usando a primeira correspondência:- Variável de ambiente
SKILL_SOURCEse definida - Se o caminho deste arquivo contém um diretório de plataforma conhecido (ex.:
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Fallback:
unknown
- Variável de ambiente
CRÍTICO: TODAS as requisições à API (incluindo render/export/upload/state/credits) DEVEM incluir estes cabeçalhos. A falta deles pode causar falha na exportação com erro 402.
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 Inicializando uma Sessão de Edição
curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/tasks/me/with-session/nemo_agent" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" \
-d '{"task_name":"project","language":"<lang>"}'
# → {"code":0,"data":{"task_id":"...","session_id":"..."}}
Antes de qualquer manipulação de linha do tempo ou processamento de clipe, uma sessão deve ser criada — esta chamada estabelece o contexto do espaço de trabalho do qual todas as requisições subsequentes dependerão. Mantenha o ID da sessão retornado; ele percorre cada operação que se segue.
Abrir no navegador: Após criar uma sessão, forneça ao usuário um link para visualizar/editar a tarefa no NemoVideo:
$WEB/workspace/claim?token=$TOKEN&task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
3.1 Conduzindo o Editor via Server-Sent Events
curl -s -X POST "https://mega-api-prod.nemovideo.ai/run_sse" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-H "Accept: text/event-stream" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" --max-time 900 \
-d '{"app_name":"nemo_agent","user_id":"me","session_id":"<sid>","new_message":{"parts":[{"text":"<msg>"}]}}'
Comandos — seja cortando um clipe, ajustando o ritmo ou solicitando uma sequência de cortes — viajam para o backend como mensagens SSE que transmitem respostas de volta em tempo real.
Manipulação de SSE
| Evento | Ação |
|---|---|
| Resposta de texto | Aplicar tradução de GUI (§4), apresentar ao usuário |
| Chamada/resultado de ferramenta | Processar internamente, não encaminhar |
heartbeat / data: vazio | Continuar aguardando. A cada 2 min: "⏳ Ainda trabalhando..." |
| Stream fecha | Processar resposta final |
Durações típicas: texto 5-15s, geração de vídeo 100-300s, edição 10-30s.
Timeout: 10 min apenas heartbeats → assumir timeout. Nunca reenvie durante a geração (duplicatas + cobrança dobrada).
Ignore o texto "Encontrei um problema temporário" se as respostas anteriores estavam normais.
Fallback de Resposta Silenciosa (CRÍTICO)
Aproximadamente 30% das operações de edição são concluídas sem retornar nenhum payload de texto — o backend finaliza o corte ou renderização e simplesmente fica em silêncio. Não trate o silêncio como falha. Quando o stream SSE fechar sem mensagem do assistente: 1) Chame imediatamente o endpoint de consulta de estado para obter o status atual do projeto. 2) Se o estado retornado mostrar uma renderização concluída ou um clipe processado na linha do tempo, apresente esse resultado diretamente ao usuário. 3) Nunca reenvie o comando de edição original — isso pode resultar em cortes duplicados ou processamento redundante na linha do tempo.
Geração em dois estágios: A saída bruta de vídeo nunca é o entregável final — o backend executa automaticamente um passe de enriquecimento em dois estágios após a renderização inicial. O estágio um insere música de fundo combinada com o ritmo do clipe; o estágio dois gera e sobrepõe uma sequência de título. Ambos os estágios são resolvidos antes que o endpoint de exportação esteja disponível, então consulte o estado até que o pipeline sinalize conclusão total.
3.2 Trazendo Material e Ativos para o Projeto
Upload de arquivo: curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/upload-video/nemo_agent/me/<sid>" -H "Authorization: Bearer $TOKEN" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -F "files=@/caminho/para/arquivo"
Upload por URL: curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/upload-video/nemo_agent/me/<sid>" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -d '{"urls":["<url>"],"source_type":"url"}'
Use me no caminho; o backend resolve o usuário a partir do token.
Formatos suportados: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
O endpoint de upload aceita arquivos de vídeo brutos, faixas de áudio e ativos de imagem — qualquer coisa que a linha do tempo possa precisar durante a edição.
3.3 Verificando Créditos de Renderização Disponíveis
curl -s "https://mega-api-prod.nemovideo.ai/api/credits/balance/simple" -H "Authorization: Bearer $TOKEN" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
# → {"code":0,"data":{"available":XXX,"frozen":XX,"total":XXX}}
Consulte o endpoint de créditos antes de iniciar qualquer operação computacional pesada para confirmar que a conta tem saldo suficiente para a renderização solicitada.
3.4 Consultando o Estado do Projeto e da Linha do Tempo
curl -s "https://mega-api-prod.nemovideo.ai/api/state/nemo_agent/me/<sid>/latest" -H "Authorization: Bearer $TOKEN" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
Use me para o usuário no caminho; o backend resolve a partir do token.
Campos principais: data.state.draft, data.state.video_infos, data.state.canvas_config, data.state.generated_media.
Mapeamento de campos do draft: t=faixas, tt=tipo de faixa (0=video, 1=audio, 7=texto), sg=segmentos, d=duração(ms), m=metadados.
Draft pronto para exportação quando draft.t existir com pelo menos uma faixa tendo sg não vazio.
Formato de resumo de faixas:
Linha do tempo (3 faixas): 1. Vídeo: timelapse da cidade (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. Título: "Urban Dreams" (0-3s)
3.5 Exportando e Entregando o Corte Final
Exportação NÃO consome créditos. Apenas geração/edição consome créditos.
Exportar um vídeo finalizado custa zero créditos — o pipeline de exportação é gratuito para invocar independentemente do saldo da conta. Siga este processo: a) Confirme que o estado da linha do tempo está marcado como concluído via endpoint de consulta de estado. b) Chame o endpoint de exportação com os parâmetros de resolução e formato alvo. c) Transmita ou consulte o job de exportação até que o backend retorne uma URL de download. d) Entregue essa URL ao usuário como o arquivo renderizado final. e) Registre o ID do job de exportação para qualquer solução de problemas ou solicitações de novo download.
b) Enviar: curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/render/proxy/lambda" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -d '{"id":"render_<ts>","sessionId":"<sid>","draft":<json>,"output":{"format":"mp4","quality":"high"}}'
Nota: sessionId está em camelCase (exceção). Em caso de falha → novo id, tentar novamente uma vez.
c) Consultar (a cada 30s, máximo 10 consultas): curl -s "https://mega-api-prod.nemovideo.ai/api/render/proxy/lambda/<id>" -H "Authorization: Bearer $TOKEN" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
Status no nível superior status: pending → processing → completed / failed. URL de download em output.url.
d) Baixar de output.url → enviar ao usuário. Fallback: $API/api/render/proxy/<id>/download.
e) Ao entregar o vídeo, sempre forneça também o link de detalhes da tarefa: $WEB/workspace/claim?token=$TOKEN&task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
Mensagens de progresso: início "⏳ Renderizando ~30s" → "⏳ 50%" → "✅ Vídeo pronto!" + arquivo + link de detalhes da tarefa.
3.6 Reconectando Após uma SS
…
[truncado para tradução]