El resultado: un promo vertical en dos idiomas.
Le dimos al agente un brief de cinco líneas: promocionar este tutorial ante fundadores y marketers que ya usan Claude. Devolvió el guion, la voz en español y en inglés, dos composiciones de HyperFrames y estos dos vídeos. Ningún editor de vídeo intervino. Lo único manual fue revisarlos.
Es un ejemplo pequeño a propósito: seis frases, seis escenas. El mismo procedimiento sirve para un anuncio, un lanzamiento o una serie de Shorts. Solo cambian el brief y las escenas.
Qué es un agente de marketing (y qué no).
No es un chat que escribe posts. Es un modelo con herramientas y un procedimiento escrito: lee un brief, decide qué investigar, llama a cada herramienta, comprueba el resultado y se para donde tú decides. En Claude Code eso se monta con tres cosas:
- Un modelo que dirige: Opus 5.5 lee, planifica, escribe el guion y el código de las escenas, y revisa los fotogramas.
- Herramientas: conectores MCP (NexLev), plugins con comandos (marketing) y scripts propios (Fish Audio, ffmpeg, HyperFrames).
- Una skill: un
SKILL.mdcon los pasos, las reglas y los puntos donde el agente espera tu aprobación.
El agente no publica. Entrega el vídeo y un informe; publicar es tarea tuya. Así un error de guion o una voz mal pronunciada nunca llegan a tu audiencia sin que nadie los vea.
Las piezas y lo que hace cada una.
| Pieza | Para qué | Acceso | En esta prueba |
|---|---|---|---|
| Claude Code + Opus 5.5 | Orquestar, escribir guion y escenas, revisar | Plan de Claude o API | Usado |
Plugin marketing | /marketing:competitive-brief, /marketing:brand-review y otros comandos | Gratis, Apache-2.0 | Usado para el vídeo largo del canal; no en este promo |
| NexLev MCP | Canales y vídeos que destacan en YouTube | Cuenta de NexLev, OAuth | No conectado |
| Fish Audio | Voz a partir del texto | Clave de API | Usado: 2 peticiones |
| HyperFrames | HTML + GSAP a MP4, render determinista | npx hyperframes | Usado: 0.9.16 |
| ffmpeg | Pausas de la voz y volumen | Local | Usado |
Si ya usas otra herramienta de investigación, como Ahrefs o Similarweb, el plugin de marketing trae conectores para ellas. El agente no cambia: solo cambia lo que conectas.
Paso 1: el proyecto y el modelo.
Un agente de Claude Code es una carpeta. Lo que hay en .claude/ define cómo trabaja ahí dentro. Fija el modelo para que todas las sesiones de esta carpeta usen Opus 5.5:
{
"model": "claude-opus-5-5"
}La estructura completa del kit:
.claude/settings.json modelo
.claude/skills/marketing-agent/SKILL.md el procedimiento
brief/brief.md qué promocionar y qué se puede afirmar
script/{es,en}.txt una frase por línea
scripts/fish-tts.mjs texto → MP3 con Fish Audio
scripts/build-video.mjs guion + cortes → video-<idioma>/index.html
scripts/finish.sh render + −14 LUFS
video-{es,en}/ proyectos de HyperFramesEl brief es lo más importante de la carpeta. Incluye una línea que muchos olvidan: lo que no se puede afirmar. Si no lo escribes, un modelo con ganas de vender se inventará cifras de visitas.
- Product: the SKOA tutorial "Build a marketing agent with Claude".
- Audience: founders and marketers who already use Claude.
- Action: read the tutorial at skoa.online/blog/.
- Claims we can prove: the pipeline in this folder and the approval step.
- Do not claim: views, sales or time saved.Paso 2: investigar a la competencia con NexLev y el plugin de marketing.
NexLev publica un servidor MCP de solo lectura con datos públicos de YouTube. Su guía da este comando para Claude Code:
claude mcp add -s user --transport http nexlev https://prod.dashboard.nexlev.io/api/claude-mcp
# dentro de claude: /mcp → nexlev → Authenticate (abre el navegador)
claude mcp list # nexlev: … (HTTP) - ✓ ConnectedLas herramientas que usa la skill son search_niche_finder_channels y get_similar_channels para encontrar cinco canales del nicho, y youtube_channel_outliers para ver qué vídeos de cada uno rinden muy por encima de su media. De esos vídeos, al agente le interesan tres cosas: el gancho, el título y la duración.
En esta prueba NexLev no estaba conectado. El comando y los nombres de las herramientas vienen de la guía oficial de NexLev, actualizada el 20 de agosto de 2026. Los límites dependen del plan y se cuentan por herramienta y día: en el plan gratuito, por ejemplo, son 10 búsquedas de canales y 5 de canales similares. Comprueba tu plan antes de lanzar una investigación grande.
Para posicionarte frente a competidores directos, añade el plugin de marketing de Anthropic. Es abierto y trae comandos como /marketing:competitive-brief, /marketing:brand-review, /marketing:campaign-plan y /marketing:seo-audit:
/plugin marketplace add anthropics/knowledge-work-plugins
/plugin install marketing@knowledge-work-pluginsLa skill exige que cada dato de brief/research.md tenga su enlace. Si NexLev no responde o se queda sin cuota, el agente lo apunta y sigue solo con el plugin. Nunca debe rellenar el hueco con números inventados.
Paso 3: la skill que convierte a Claude en el agente.
La skill es un procedimiento, no un prompt largo. Claude la carga cuando le pides un promo o un vídeo de lanzamiento. Estas son las partes que más importan:
---
name: marketing-agent
description: Turns a product brief into a researched short video for
YouTube Shorts, Reels or TikTok. Studies competitors (NexLev MCP,
the marketing plugin's competitive-brief), writes the script, voices
it with Fish Audio and builds it with HyperFrames. Never publishes.
---
Stop at each **Approval** line and wait for a yes.
## 3. Script
Six sentences, about 15 seconds. Sentence 1 is the hook and must
work muted. Every claim comes from brief.md or research.md.
Run /marketing:brand-review on the script.
**Approval:** show the script and the research summary.
## 6. Finish
**Approval:** the user watches both videos with sound.
Publishing is the user's job, not yours.Hay dos aprobaciones. La primera llega antes de gastar créditos de voz: corregir un guion no cuesta nada, pero regenerar audio sí. La segunda llega con el vídeo terminado. El agente no puede oír, así que tienes que escucharlo tú.
Paso 4: el guion, una idea por frase.
Para un Short de 15 segundos, el agente escribe seis frases. La primera tiene que funcionar sin sonido, porque mucha gente ve los vídeos en silencio. Cada frase será una escena, así que cada una lleva una sola idea:
Este vídeo lo ha montado un agente de marketing.
Primero estudia a tu competencia con NexLev.
Después, Opus 5.5 escribe el guion.
Fish Audio le pone la voz.
Y HyperFrames lo convierte en vídeo.
Pero no publica nada sin tu visto bueno.El gancho es cierto en este caso, y eso no es casualidad. La skill exige que cada afirmación salga del brief o de la investigación, y /marketing:brand-review repasa el tono antes de tu primera aprobación.
Paso 5: la voz con Fish Audio y los cortes en las pausas.
Una sola petición por idioma, con la clave en el entorno. El script tiene veinte líneas y no usa dependencias:
const res = await fetch('https://api.fish.audio/v1/tts', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.FISH_API_KEY}`,
'Content-Type': 'application/json', model: 's2.1-pro-free' },
body: JSON.stringify({ text, reference_id: voice, format: 'mp3',
mp3_bitrate: 192, normalize: true }),
});node scripts/fish-tts.mjs --text script/es.txt \
--voice 3f45a7fd7a614655a61eb7027b955783 --out video-es/assets/vo.mp3
node scripts/fish-tts.mjs --text script/en.txt \
--voice 536d3a5e000945adb7038665781a4aca --out video-en/assets/vo.mp3Usamos dos voces públicas de la biblioteca de Fish: «voz de locutor k» en español y Ethan en inglés. El reference_id es el identificador que aparece en la URL de cada voz en fish.audio. Fish no devuelve tiempos por palabra, así que los cortes de escena salen de las pausas del audio:
ffmpeg -i video-es/assets/vo.mp3 -af silencedetect=n=-35dB:d=0.18 -f null -
silence_start: 2.42 silence_end: 2.95 → escena 2 en 2.80
silence_start: 5.21 silence_end: 5.77 → escena 3 en 5.62
silence_start: 6.29 silence_end: 6.59 (la coma de «Después,»)
silence_start: 8.75 silence_end: 9.10 → escena 4 en 8.95
silence_start: 10.50 silence_end: 10.93 → escena 5 en 10.78
silence_start: 12.79 silence_end: 13.30 → escena 6 en 13.15Cada escena empieza 0,15 s antes de que vuelva la voz, para que la imagen se adelante un poco a la palabra. Una de las pausas es solo una coma, y el agente tiene que reconocerla y no cortar ahí. El vídeo acaba 0,3 s después de la última palabra, sin cierre ni fundido.
Paso 6: el vídeo con HyperFrames.
HyperFrames convierte HTML en vídeo. La animación es una línea de tiempo de GSAP en pausa, y el render recorre esa línea fotograma a fotograma en Chrome sin pantalla. El mismo HTML da siempre el mismo vídeo, y lo puedes abrir y retocar en su vista previa.
npx hyperframes init video-es --audio vo.mp3 --language es \
--resolution portrait --non-interactive
# 1080×1920, transcribe la voz con whisper (transcript.json)
# y deja AGENTS.md / CLAUDE.md con las reglas para el agenteEl agente no dibuja las escenas a mano, sino que escribe un generador. build-video.mjs lee el guion y los cortes, y escribe un index.html con seis escenas, subtítulos y la línea de tiempo:
const CUTS = {
// inicio de las escenas 2 a 6 y el final (última palabra + 0,3 s)
es: [2.80, 5.62, 8.95, 10.78, 13.15, 15.58],
en: [2.39, 5.27, 8.15, 9.91, 12.39, 14.79],
};
// cada escena es un clip con su inicio y duración en segundos
// <div id="s2" class="clip scene" data-start="2.8" data-duration="2.82">
tl.to('#s2 .hot', { scaleY: 1.3, duration: 0.5, ease: 'back.out(1.6)' }, 3.55);Antes de renderizar, npx hyperframes check pasa el lint, ejecuta la composición y mide la legibilidad. En la primera versión avisó de dos rótulos que no duraban en pantalla lo suficiente para leerlos. Los adelantamos.
line_unread "por encima de su media" (5 words) is on screen 1.07 s,
under its 1.50 s floor
line_unread The film's last line "APROBADO ✓" is on screen 1.02 s
nested_structure_needs_subcomposition (6×, aviso de organización)Los avisos de estructura sugieren pasar cada escena a su propio archivo dentro de compositions/. Para seis escenas cortas lo dejamos en uno, a propósito, para que el ejemplo se lea de un vistazo. En un proyecto más largo, sepáralas.
Paso 7: revisar fotogramas, medir el volumen y aprobar.
El agente mira el vídeo antes que tú, a su manera: genera una hoja con un fotograma de cada escena y la revisa. En la primera hoja encontró dos fallos. La barra destacada del gráfico tapaba el buscador, y el cursor que pulsa «Aprobar» era demasiado pequeño para verse en un móvil.

Después renderiza y normaliza el volumen a −14 LUFS en dos pasadas:
promo-es.mp4 1080×1920 15,6 s I: −14,1 LUFS pico: −1,9 dBFS
promo-en.mp4 1080×1920 14,8 s I: −14,3 LUFS pico: −0,9 dBFSSin normalizar, la voz inglesa salía a −23,1 LUFS y la española a −15,8: dos voces de la misma herramienta, con 7 dB de diferencia. Por eso se mide siempre, nunca se supone.
La transcripción oyó «Nextlev» donde la voz dice NexLev. Es un fallo de whisper, no de Fish, pero no garantiza que el nombre suene bien. Escucha los nombres propios antes de aprobar: NexLev, Opus, Fish Audio y HyperFrames.
Costes, límites y dónde falla.
- Fish Audio: dos peticiones, de 234 y 228 caracteres. El precio depende de tu plan, así que míralo en tu cuenta. Antes de publicar, revisa también los términos de uso comercial de las voces públicas de la biblioteca: nosotros aún los estamos comprobando.
- NexLev: límites diarios por herramienta y por plan. Su web da cifras distintas para el número de herramientas y la cuota de API según la página, así que confía en lo que muestre tu panel.
- HyperFrames: el render es local y no gasta créditos. En un Mac con M4 Pro, cada vídeo de 15 s se renderizó en menos de un minuto. La primera vez descarga Chrome sin pantalla y las fuentes.
- Opus 5.5: es la parte que más tokens consume, porque escribe código y revisa imágenes. Si usas Claude Code con un plan de suscripción, entra en tu cuota de uso.
- Dónde falla: tiempos por palabra que no son exactos, nombres propios mal pronunciados y rótulos que se solapan. Todo eso se ve en la revisión. Ninguno de esos fallos llega a publicarse si respetas la aprobación final.
El kit y el prompt para hacerlo tú.
El agente completo, en una carpeta.
Skill, brief de ejemplo, guiones, scripts de Fish y de acabado, y los dos proyectos de HyperFrames con su voz.
Descargar el kit ↓ZIP · 760 KB · sin claves ni secretos · HyperFrames 0.9.16Descomprímelo, exporta tu clave de Fish y abre Claude Code en la carpeta. Luego pide:
Usa la skill marketing-agent con brief/brief.md.
Investiga 5 canales del nicho con NexLev y resume en brief/research.md
qué tienen en común sus vídeos que destacan, con enlaces.
Escribe un guion de 6 frases en español e inglés y enséñamelo
antes de generar la voz. Voces de Fish: <id ES> y <id EN>.
Monta los vídeos con HyperFrames, revisa una hoja de fotogramas,
normaliza a −14 LUFS y dime qué no has podido comprobar.
No publiques nada.Si no tienes NexLev, quita la segunda línea: la skill sigue funcionando solo con el plugin de marketing. Y si te interesa la parte de motion graphics, en Del chat al vídeo contamos cómo sincronizar la animación palabra a palabra. Más tutoriales en el blog de SKOA.