Communitygithub.com

ASoudy/AGS

Convierte un video de YouTube en una nota de bóveda Markdown con transcripción, metadatos y semillas de captura, usando yt-dlp.

¿Qué es AGS?

Este skill permite extraer la transcripción de un video de YouTube y almacenarla como una entrada de memoria consultable en una bóveda Markdown. Utiliza yt-dlp para descubrir y descargar subtítulos (manuales o automáticos), los limpia de marcas de tiempo y líneas duplicadas, y genera un archivo Markdown con metadatos estructurados en frontmatter (título, canal, fecha, duración, etc.). Además, escanea la transcripción en busca de palabras clave como "decisión", "modelo" o "lección" y crea semillas de captura en la carpeta Meta/Captures. Es ideal para desarrolladores que quieran integrar contenido de YouTube en flujos de conocimiento, extracción de grafos o reutilización de contenido, y es parte de la familia de conectores de bóveda como ingest-slack o ingest-github. Soporta URLs individuales, prioriza idiomas (por defecto inglés y español) y es idempotente: al re-ejecutar, sobrescribe el mismo archivo sin duplicar.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/plugins/antigravity-awesome-skills-claude/skills/ingest-youtube

Preguntar en tu IA favorita

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

Documentación

ingest-youtube — Conector de YouTube a bóveda

Extrae transcripciones de YouTube a una bóveda Markdown como entradas de memoria consultables que los skills posteriores (extracción de grafos de conocimiento, entrenamiento de huellas de voz, reutilización de contenido, extracción de elementos de acción) pueden procesar.

Mismo patrón que ingest-slack, ingest-whatsapp, ingest-notion, ingest-linear, ingest-github, ingest-gmail. Añadir YouTube implica un nuevo normalizador, no una nueva arquitectura.

Cuándo usarlo

  • El usuario pega una URL de YouTube y solicita una transcripción o resumen
  • El usuario escribe /ingest-youtube <url> para un video individual
  • El usuario solicita capturar, sincronizar, ingerir, transcribir o extraer una charla/podcast/conferencia a la bóveda

NO usar para:

  • Descargar el archivo de video real (usa yt-dlp directamente con -f best)
  • Ingesta de canales completos o ventanas de --days; este script ingiere una URL de video a la vez
  • Transmisiones en vivo (las transcripciones no son estables)
  • Fuentes que no sean YouTube (Vimeo, Twitch, Twitter Spaces tienen sus propios conectores)
  • Lecturas únicas de transcripciones donde el usuario no desea un archivo en la bóveda (ejecuta yt-dlp --write-auto-sub directamente y redirige a stdout)

Cómo funciona

  1. Analiza la entrada como una URL de video de YouTube.
  2. Verifica que yt-dlp esté instalado. Si no, el script termina con instrucciones de instalación: brew install yt-dlp (macOS) o pip3 install --user yt-dlp.
  3. Ejecuta yt-dlp --list-subs <url> para listar los subtítulos disponibles.
  4. Prioridad de subtítulos: subtítulos manuales > subtítulos automáticos. Los manuales preservan la puntuación y etiquetas de orador; los automáticos están en mayúsculas y sin puntuación.
  5. Descarga el subtítulo de mayor prioridad como VTT mediante yt-dlp --write-sub --sub-lang <lang> --skip-download. Idioma por defecto: en,es (inglés primero, español segundo).
  6. Elimina las marcas de tiempo VTT y fusiona en párrafos de prosa limpios. Elimina líneas duplicadas (los VTT automáticos duplican líneas). Preserva las etiquetas de orador si la fuente las tenía.
  7. Obtiene los metadatos del video (título, canal, fecha de subida, duración, video_id, URL) mediante yt-dlp --print-json --skip-download.
  8. Convierte el nombre del canal y el título del video a slug. Escribe en External Inputs/YouTube/<channel-slug>/<YYYY-MM-DD>-<video-slug>.md.
  9. Escanea la transcripción en busca de palabras clave (decisión, marco, modelo, principio, "la lección es", manual, antipatrón, caso de estudio). Por cada coincidencia, crea una semilla de escritura en Meta/Captures/<YYYY-MM-DD>-youtube-<channel-slug>-<video-id>.md para que la semilla llegue al agregador de capturas.
  10. Imprime resumen: ruta del archivo, recuento de palabras de la transcripción, idioma, semillas detectadas.

Invocación

python3 ingest.py <youtube-url> [--vault <ruta>] [--lang <código>]

Valores por defecto:

  • --vault: variable de entorno $VAULT_ROOT o directorio actual
  • --lang: en,es (inglés primero, español segundo; coincide con un bilingüe común por defecto)
  • --whisper: aceptado como bandera de reserva futura, pero esta versión escribe una semilla cuando no hay subtítulos disponibles

Contrato de salida

El archivo de la bóveda en External Inputs/YouTube/<channel-slug>/<YYYY-MM-DD>-<video-slug>.md tiene frontmatter:

---
type: external-input
source: youtube
video_id: <ID de 11 caracteres>
url: https://www.youtube.com/watch?v=<id>
channel: <nombre-del-canal>
channel_url: https://www.youtube.com/<handle>
title: <título-del-video>
upload_date: <YYYY-MM-DD>
duration_seconds: <int>
language: <código ISO>
subtitle_source: manual | auto | whisper
word_count: <int>
ingested_at: <marca de tiempo ISO 8601>
---

El cuerpo es la transcripción limpia en prosa en párrafos. Si la fuente tenía etiquetas de orador, el formato es **<orador>:** <texto> por turno.

Idempotencia

Re-ingerir la misma URL de video sobrescribe el mismo archivo de la bóveda. Los nombres de los archivos de semillas incluyen un hash del video_id, por lo que el mismo video fuente produce el mismo nombre de archivo de semilla en cada ejecución. Las re-ejecuciones actualizan, nunca duplican.

Subtítulos faltantes

Si yt-dlp --list-subs no devuelve subtítulos manuales ni automáticos, el script escribe una nota de bóveda de semilla con los metadatos del video y la URL fuente en lugar de fallar silenciosamente. La bandera --whisper está reservada para una futura transcripción local de respaldo y actualmente informa que el respaldo no está implementado.

Para un respaldo manual hoy, descarga el audio con yt-dlp, transcríbelo con tu flujo de trabajo local de Whisper y añade subtítulos o texto de transcripción antes de volver a ejecutar la ingesta.

Limitaciones

  • Ingiere una URL de video de YouTube por ejecución; los handles de canal, listas de reproducción y ventanas --days están fuera del alcance.
  • Depende de los subtítulos devueltos por yt-dlp; los videos sin subtítulos producen una semilla de metadatos, no una transcripción.
  • No descarga archivos de video ni realiza transcripción Whisper integrada en esta versión.
  • La disponibilidad de la red, el acceso a subtítulos de YouTube y el comportamiento local de yt-dlp determinan si la ingesta tiene éxito.

Prueba de aceptación

Ejecuta contra el primer video de YouTube subido:

python3 ingest.py "https://www.youtube.com/watch?v=jNQXAC9IVRw" --vault /tmp/test

Salida esperada:

Wrote 39 words to /tmp/test/External Inputs/YouTube/jawed/2005-04-24-me-at-the-zoo.md. Language: en. Subtitle source: manual.

El archivo de salida contiene un frontmatter válido y un cuerpo de prosa limpio.

Dependencias

  • yt-dlp (requerido): instala mediante brew install yt-dlp o pip3 install --user yt-dlp
  • whisper-cpp (opcional para un respaldo manual fuera de este script)

Fuente

Incluido en adelaidasofia/ai-brain-starter, un entorno de verificación para un agente de IA para que la memoria se acumule en lugar de corromperse. El skill es parte de la familia de conectores de bóveda ingest-*.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Skills relacionados