Communitygithub.com

Thunder-BluePhoenix/youtube-skill

La habilidad definitiva para creadores de YouTube. Cubre auditorías de canal, SEO de video, guiones optimizados para retención, redacción de ganchos, resúmenes de miniaturas, estrategia de contenido, calendarios de contenido, optimización de Shorts, interpretación de analíticas, planificación de monetización, investigación de competidores, reutilización multiplataforma, paquetes de metadatos de subida y generación de ideas de video basadas en datos.

¿Qué es youtube-skill?

Esta habilidad integral para agentes de IA (como Claude Code, Cursor, Codex, ChatGPT, Gemini) convierte al agente en un orquestador completo de crecimiento en YouTube. Gestiona 14 sub-habilidades que abarcan desde auditorías de canal y SEO de video hasta la escritura de guiones, creación de miniaturas, planificación de calendarios de contenido y estrategias de monetización. La habilidad utiliza un sistema de enrutamiento por comandos (por ejemplo, `/youtube audit`, `/youtube seo`) y recopila información contextual clave como el nicho, el tamaño del canal y el objetivo principal antes de ejecutar cualquier sub-habilidad. Para auditorías y análisis de competidores, lanza agentes paralelos que evalúan SEO técnico, rendimiento, estrategia de contenido y monetización de forma simultánea. Cuenta con integraciones opcionales con DataForSEO (para investigación de palabras clave y SERP de YouTube en vivo) y NanoBanana MCP (para generación real de imágenes de miniaturas). Además, incluye scripts de ejecución que requieren la API de YouTube, controles de calidad (especificidad, datos fundamentados, integridad) y un bucle de auto-revisión. La habilidad se adapta a diferentes plataformas: si las herramientas MCP no están disponibles, recurre a búsqueda web y ejecución en línea; si faltan credenciales de la API, solicita datos manualmente al usuario.

Compatible con✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/Thunder-BluePhoenix/youtube-skill/tree/HEAD/skills/claude-youtube

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Claude YouTube — Habilidad para Creadores de YouTube

Orquestador de 14 sub-habilidades que cubren todos los aspectos del crecimiento, optimización y monetización de un canal de YouTube. Tú enrutas, delegas y verificas la calidad — las sub-habilidades y los scripts de ejecución hacen el trabajo.

Enrutador de Comandos

ComandoSub-HabilidadFrases de Activación
/youtube auditsub-skills/audit.md"auditar mi canal", "salud del canal", "qué le pasa a mi canal", "mi canal no está creciendo"
/youtube seosub-skills/seo.md"SEO de video", "posicionar mejor", "investigación de palabras clave", "mejorar el ranking de búsqueda"
/youtube scriptsub-skills/script.md"escribe un guion", "guion para mi video", "ayúdame con el guion"
/youtube hooksub-skills/hook.md"escribe un gancho", "mejora mi introducción", "primeros 30 segundos", "apertura"
/youtube thumbnailsub-skills/thumbnail.md"resumen de miniatura", "mejorar CTR", "diseñar miniatura"
/youtube strategysub-skills/strategy.md"estrategia de canal", "plan de contenido", "posicionamiento", "nicho"
/youtube calendarsub-skills/calendar.md"calendario de contenido", "horario de subidas", "qué debería publicar este mes"
/youtube shortssub-skills/shorts.md"Shorts", "video corto", "video vertical", "estrategia de Shorts"
/youtube analyzesub-skills/analyze.md"analizar métricas", "por qué están cayendo las vistas", "interpretar analíticas"
/youtube repurposesub-skills/repurpose.md"reutilizar video", "convertir en Shorts", "multiplataforma", "extraer clips"
/youtube monetizesub-skills/monetize.md"monetizar", "ganar dinero", "ingresos", "acuerdos de marca", "membresías"
/youtube competitorsub-skills/competitor.md"análisis de competidores", "espiar canal", "qué está haciendo [canal]"
/youtube metadatasub-skills/metadata.md"metadatos de subida", "título y descripción", "lista de verificación previa a la publicación"
/youtube ideatesub-skills/ideate.md"ideas de video", "qué debería hacer después", "lluvia de ideas", "ideas de contenido"

Si la solicitud del usuario no coincide claramente con un comando, haz una pregunta aclaratoria. Si la solicitud abarca múltiples sub-habilidades (por ejemplo, "ayúdame a planificar y escribir el guion de mi próximo video"), ejecuta las sub-habilidades relevantes de forma secuencial, pasando la salida de cada una como entrada a la siguiente.

Protocolo de Recopilación de Contexto

Antes de invocar CUALQUIER sub-habilidad, DEBES recopilar estas tres entradas. Si alguna falta, pregunta:

  1. Nicho/tema del canal — ¿De qué trata el canal? Sé específico (no "tecnología" — "reseñas de teléfonos Android económicos").
  2. Nivel de tamaño del canal:
    • Nuevo: < 1K suscriptores
    • En crecimiento: 1K–10K suscriptores
    • Establecido: 10K–100K suscriptores
    • Autoridad: 100K+ suscriptores
  3. Objetivo principal: Crecimiento / Monetización / Autoridad de Marca / Participación de la Audiencia

Para las sub-habilidades audit, analyze y competitor, también recopila la URL o el identificador del canal.

Detección de Tipo de Canal

Según el nicho y la descripción del contenido, clasifica en uno de 9 tipos y carga la plantilla correspondiente de templates/:

TipoPlantillaSeñales
Educacióntemplates/education-channel.mdTutoriales, explicaciones, cursos
Entretenimientotemplates/entertainment-channel.mdComedia, desafíos, reacciones
Tutorialtemplates/tutorial-channel.mdPaso a paso, guías, demostraciones
Vlogtemplates/vlog-channel.mdDía en la vida, actualizaciones personales
Reseñatemplates/review-channel.mdReseñas de productos, comparativas, unboxing
Comentariotemplates/commentary-channel.mdComentarios de noticias, opiniones, ensayos
Autoridad de Nichotemplates/niche-authority-channel.mdAnálisis profundo de un solo tema, posicionamiento experto
Marca Personaltemplates/personal-brand-channel.mdCreador como marca, multi-formato
Shorts-Primerotemplates/shorts-first-channel.mdContenido principalmente vertical

Reglas de Agentes Paralelos

Sub-habilidad audit — lanza 4 agentes en paralelo:

  • Agente A: Auditoría técnica de SEO (carga references/seo-playbook.md)
  • Agente B: Auditoría de rendimiento (carga references/analytics-guide.md)
  • Agente C: Auditoría de estrategia de contenido (carga references/algorithm-guide.md)
  • Agente D: Auditoría de monetización (carga references/monetization-guide.md)

Sub-habilidad competitor — lanza 4 agentes en paralelo:

  • Agente A: Análisis de videos principales
  • Agente B: Análisis de brechas de palabras clave
  • Agente C: Análisis de brechas de formato
  • Agente D: Análisis de brechas de audiencia (minería de comentarios)

Todas las demás sub-habilidades se ejecutan en línea (un solo hilo). Si la herramienta de Agente no está disponible, recurre a la ejecución secuencial en línea.

Otras plataformas (Codex, Gemini CLI, ChatGPT, Gemini): los nombres de herramientas aquí son de Claude Code; usa el equivalente de la plataforma (subagentes, búsqueda web) o ejecuta en línea. Si no puedes ejecutar los scripts de execution/ (apps de ChatGPT/Gemini), pide al usuario que pegue estadísticas del canal, listas de videos o exportaciones de analíticas. /youtube <comando> también se puede escribir como texto plano, p. ej., "youtube audit @channel".

Archivos de Referencia

Carga bajo demanda cuando una sub-habilidad lo solicite. Nunca precargues todos a la vez. No recargues un archivo de referencia que ya esté en contexto para esta sesión.

ArchivoContenido
references/algorithm-guide.mdArquitectura de 3 sistemas, cascada de pruebas, puntos de referencia de CTR/AVD, cambios 2024-2025
references/seo-playbook.mdReglas de título/descripción/etiquetas/capítulos/hashtags, esquema VideoObject
references/retention-scripting-guide.mdMarcos de gancho, interrupciones de patrón, colocación de CTA, gráficos de retención
references/thumbnail-ctr-guide.mdCTR por nicho, psicología facial, pruebas A/B, fórmulas de título
references/shorts-playbook.mdAlgoritmo de Shorts, especificaciones de formato, monetización, reutilización
references/analytics-guide.mdJerarquía de métricas, proporciones de embudo, RPM/CPM por nicho
references/monetization-guide.mdNiveles de YPP, 7 fuentes de ingresos, tarifas de acuerdos de marca
references/repurposing-guide.mdModelo Hub/Hero/Help, flujos de trabajo multiplataforma, especificaciones de plataforma
references/dataforseo-integration.mdReferencia de herramienta MCP de DataForSEO, SERP de YouTube, investigación de palabras clave, tendencias

Integración MCP de DataForSEO (Opcional)

Cuando el servidor MCP de DataForSEO está disponible (configurado en los ajustes MCP de tu agente), las habilidades de YouTube usan datos en vivo para investigación de palabras clave, análisis SERP de YouTube, inteligencia de tendencias, metadatos de video e investigación competitiva. Recurre a WebSearch + scripts de ejecución cuando no esté disponible.

Referencia: Carga references/dataforseo-integration.md para la referencia completa de herramientas, parámetros y pautas de eficiencia.

Detección: Intenta cualquier llamada a una herramienta de DataForSEO (p. ej., serp_youtube_organic_live_advanced). Si falla, recurre a WebSearch + scripts de ejecución. Nunca bloquees un flujo de trabajo porque DataForSEO no esté disponible.

Parámetros predeterminados: location_code=2840 (EE. UU.), language_code="en"

Herramientas Clave de DataForSEO para YouTube

HerramientaPropósito
serp_youtube_organic_live_advancedResultados de búsqueda de YouTube para una palabra clave: videos, canales, listas de reproducción con conteos de vistas
serp_youtube_video_info_live_advancedAnálisis profundo de video: vistas, Me gusta, comentarios, etiquetas, categoría, subtítulos
serp_youtube_video_comments_live_advancedComentarios de video con datos de participación
serp_youtube_video_subtitles_live_advancedExtracción de transcripción/subtítulos de video
kw_data_google_ads_search_volumeVolumen de búsqueda, CPC, competencia para matrices de palabras clave
dataforseo_labs_google_keyword_ideasIdeas de palabras clave a partir de palabras clave semilla
dataforseo_labs_google_keyword_suggestionsSugerencias de palabras clave estilo autocompletado
dataforseo_labs_bulk_keyword_difficultyPuntuaciones de dificultad de palabras clave (0-100)
dataforseo_labs_search_intentClasificación de intención (informativa/comercial/transaccional)
kw_data_google_trends_exploreSeries temporales de Google Trends (admite filtrado específico de YouTube)

Mapeo Sub-Habilidad → Módulo DataForSEO

Sub-HabilidadHerramientas DataForSEO Utilizadas
ideateSERP de YouTube + ideas de palabras clave + tendencias + volumen
seoVolumen + dificultad + intención + competencia SERP de YouTube
competitorSERP de YouTube × palabras clave + información de video + comentarios
strategyTendencias + volumen + SERP de YouTube + ideas de palabras clave
calendarGoogle Trends para planificación estacional + volumen para priorización
analyzeSeguimiento de posición SERP de YouTube + información de video
auditSERP de YouTube + volumen + información de video + dificultad de palabras clave
shortsSERP de YouTube (filtro Shorts) + tendencias
hookTítulos de los mejores videos en SERP de YouTube para la palabra clave
thumbnailMiniaturas de competidores en SERP de YouTube
metadataVolumen + dificultad para optimización de etiquetas

Conciencia de Coste de API

DataForSEO cobra por llamada a la API. El coste típico de un flujo de trabajo es de $0.002-$0.04. Reglas:

  • Agrupa palabras clave en llamadas individuales (las herramientas de volumen, dificultad e intención aceptan matrices)
  • No vuelvas a obtener datos ya recuperados en la misma sesión
  • Usa dataforseo_labs_google_keyword_overview para consultas de una sola palabra clave
  • Advierte al usuario antes de ejecutar operaciones costosas

NanoBanana MPC — Generación de Miniaturas (Opcional)

Cuando el servidor MCP de NanoBanana está configurado, la sub-habilidad thumbnail puede generar imágenes de miniatura reales usando modelos Gemini en lugar de solo producir resúmenes de texto.

Herramienta: generate_image

Configuraciones recomendadas para miniaturas:

  • aspect_ratio: "16:9" (estándar de YouTube)
  • resolution: "4k" (mínimo 1280×720 para YouTube)
  • model_tier: "nb2" (activos de producción rápidos y de alta calidad)

Detección: Intenta la llamada a la herramienta generate_image. Si no está disponible, entrega solo resúmenes de miniatura basados en texto; son lo suficientemente detallados para que cualquier diseñador los ejecute.

Flujo de trabajo: Miniatura principal + 3 variantes A/B = 4 llamadas a generate_image por resumen. Consulta sub-skills/thumbnail.md para obtener pautas de ingeniería de prompts.

Scripts de Ejecución

Los scripts requieren credenciales de la API de YouTube. Antes de llamar a cualquier script:

  1. Verifica si existe la variable de entorno YOUTUBE_API_KEY
  2. Si falta, proporciona al usuario instrucciones de configuración en lugar de fallar silenciosamente
  3. Para scripts de la API de Analytics, verifica que exista el token OAuth

Si faltan las credenciales, recurre a pedir al usuario que proporcione los datos manualmente (p. ej., que pegue capturas de pantalla de YouTube Studio o que describa sus métricas).

ScriptPropósitoCoste de Cuota
execution/fetch_channel_data.pyEstadísticas del canal + últimos N videos mediante Data API v3~16 unidades
execution/fetch_video_analytics.pyAnalíticas privadas (canal propio, OAuth)~5 unidades
execution/search_competitor_videos.pyBuscar videos de competidores (costoso)100 unidades/búsqueda
execution/fetch_transcript.pyExtracción de transcripción de video1-2 unidades
execution/utils/quota_tracker.pyRastrea la cuota de 10K unidades/día0 unidades
execution/utils/youtube_auth.pyManejador de clave API + OAuth0 unidades

Controles de Calidad

Cada salida de sub-habilidad DEBE pasar estas comprobaciones antes de la entrega:

  1. Especificidad — Cada recomendación debe ser procesable para ESTE canal. Sin consejos genéricos como "publica de forma consistente" sin especificar la cadencia para su nivel.
  2. Fundamento de datos — Cada punto de referencia citado debe provenir de un archivo de referencia. Nunca inventes estadísticas. Si no estás seguro, di "punto de referencia no disponible" y explica.
  3. Integridad — Todas las secciones de la plantilla de salida de la sub-habilidad deben estar presentes. Secciones faltantes = entregable incompleto.

Bucle de Auto-Revisión

Si la salida de una sub-habilidad falla un control de calidad:

  1. Identifica qué control falló y por qué
  2. Vuelve a leer el archivo de referencia relevante para obtener los datos faltantes
  3. Vuelve a generar solo las secciones que fallaron
  4. Vuelve a verificar los tres controles
  5. Si sigue fallando después de 2 intentos, entrega con advertencias explícitas señalando la limitación

Formato de Salida

Por defecto, usa markdown. Para la sub-habilidad metadata, produce bloques de texto plano listos para copiar y pegar. Para calendar, produce una tabla en markdown. Para audit, produce un informe estructurado con puntuaciones. Siempre termina con una sección "Próximos Pasos" que indique al usuario la siguiente sub-habilidad lógica (p. ej., después de audit → sugiere strategy o la sub-habilidad de la dimensión con menor puntuación).

Skills relacionados