Communitygithub.com

ASoudy/AGS

Extrahiert YouTube-Transkripte und speichert sie als durchsuchbare Markdown-Dateien in einem Vault, inklusive Metadaten und automatischen Notizen-Stubs.

Was ist AGS?

Dieses Skill (ingest-youtube) wandelt YouTube-Video-URLs in strukturierte Markdown-Einträge um, die in einem Wissensvault abgelegt werden. Es nutzt `yt-dlp`, um Untertitel manuell oder automatisch zu erkennen und herunterzuladen, bereinigt VTT-Zeitmarken und Duplikate, und erstellt eine saubere Prosafassung des Transkripts. Zusätzlich werden Metadaten wie Titel, Kanal, Upload-Datum und Dauer als Frontmatter hinzugefügt, und der Text wird nach Schlüsselwörtern durchsucht, um automatisch Schreibnotizen (Captures) zu generieren. Das Skill unterstützt primär Einzel-Video-URLs, ist idempotent (erneutes Einlesen überschreibt die Datei ohne Duplikate) und hinterlässt bei fehlenden Untertiteln einen Metadaten-Stub. Es ist Teil der ingest-Familie und harmoniert mit anderen Vault-Connectoren für Slack, WhatsApp, Notion, Linear, GitHub und Gmail.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

ingest-youtube – YouTube-zu-Vault-Verbinder

Überführt YouTube-Transkripte als abfragbare, typisierte Gedächtniseinträge in einen Markdown-Vault, auf die nachgelagerte Skills (Wissensgraphenextraktion, Sprach-Fingerabdruck-Training, Content-Wiederverwendung, Aktionselementextraktion) zugreifen können.

Gleiches Muster wie ingest-slack, ingest-whatsapp, ingest-notion, ingest-linear, ingest-github, ingest-gmail. YouTube hinzuzufügen bedeutet einen neuen Normalisierer, keine neue Architektur.

Wann verwenden

  • Benutzer fügt eine YouTube-URL ein und bittet um Transkript oder Zusammenfassung
  • Benutzer sagt /ingest-youtube <url> für ein einzelnes Video
  • Benutzer bittet um Erfassung, Synchronisation, Einlesen, Transkription oder Herunterladen eines Vortrags/Podcasts/Keynote in den Vault

NICHT verwenden für:

  • Herunterladen der eigentlichen Videodatei (yt-dlp direkt mit -f best nutzen)
  • Kanaleinlese oder --days-Fenster; dieses Skript verarbeitet eine Video-URL pro Durchlauf
  • Live-Streams (Transkripte sind nicht stabil)
  • Nicht-YouTube-Quellen (Vimeo, Twitch, Twitter Spaces haben eigene Verbinder)
  • Einmalige Transkriptabfragen, bei denen der Benutzer keine Vault-Datei wünscht (direkt yt-dlp --write-auto-sub und an stdout weiterleiten)

Funktionsweise

  1. Eingabe als eine YouTube-Video-URL parsen.
  2. Prüfen, ob yt-dlp installiert ist. Falls nicht, Skript beendet sich mit Installationsanweisungen: brew install yt-dlp (macOS) oder pip3 install --user yt-dlp.
  3. yt-dlp --list-subs <url> aufrufen, um verfügbare Untertitel aufzulisten.
  4. Untertitelpriorität: Manuelle Untertitel > automatisch generierte Untertitel. Manuelle Untertitel erhalten die vom Ersteller bereitgestellte Zeichensetzung und Sprecherbezeichnungen; automatische Untertitel sind in Großbuchstaben und ohne Zeichensetzung.
  5. Den Untertitel mit höchster Priorität als VTT herunterladen via yt-dlp --write-sub --sub-lang <sprache> --skip-download. Standard-Spracheinstellung: en,es (Englisch zuerst, Spanisch Zweitens).
  6. VTT-Zeitmarken entfernen und zu sauberen Prosaabsätzen zusammenführen. Doppelte Zeilen deduplizieren (automatisch generierte VTTs sind zeilenverdoppelt). Sprecherbezeichnungen beibehalten, wenn die Quelle sie hatte.
  7. Video-Metadaten (Titel, Kanal, Upload-Datum, Dauer, video_id, URL) via yt-dlp --print-json --skip-download abrufen.
  8. Kanalnamen und Videotitel slugifizieren. Schreiben nach External Inputs/YouTube/<kanal-slug>/<YYYY-MM-DD>-<video-slug>.md.
  9. Transkript nach Schlüsselwörtern durchsuchen (Entscheidung, Framework, Modell, Prinzip, „die Lektion ist“, Playbook, Anti-Pattern, Fallstudie). Für jede Übereinstimmung einen Schreibnotiz-Stub erstellen unter Meta/Captures/<YYYY-MM-DD>-youtube-<kanal-slug>-<video-id>.md, sodass die Notiz im Captures-Aggregator landet.
  10. Zusammenfassung ausgeben: Dateipfad, Transkript-Wortanzahl, Sprache, erkannte Notizen.

Aufruf

python3 ingest.py <youtube-url> [--vault <pfad>] [--lang <code>]

Standardwerte:

  • --vault: $VAULT_ROOT-Umgebungsvariable oder aktuelles Verzeichnis
  • --lang: en,es (Englisch zuerst, Spanisch Zweitens; entspricht einem häufigen zweisprachigen Standard)
  • --whisper: als zukünftiges Fallback-Flag akzeptiert, aber diese Version schreibt einen Stub, wenn keine Untertitel verfügbar sind

Ausgabevereinbarung

Die Vault-Datei unter External Inputs/YouTube/<kanal-slug>/<YYYY-MM-DD>-<video-slug>.md enthält Frontmatter:

---
type: external-input
source: youtube
video_id: <11-stellige ID>
url: https://www.youtube.com/watch?v=<id>
channel: <kanalname>
channel_url: https://www.youtube.com/<handle>
title: <videotitel>
upload_date: <YYYY-MM-DD>
duration_seconds: <int>
language: <ISO-Code>
subtitle_source: manual | auto | whisper
word_count: <int>
ingested_at: <ISO 8601-Zeitstempel>
---

Body ist das bereinigte Transkript als Absatzprosa. Wenn die Quelle Sprecherbezeichnungen hatte, als **<sprecher>:** <text> pro Wechsel formatieren.

Idempotenz

Das erneute Einlesen derselben Video-URL überschreibt dieselbe Vault-Datei. Die Dateinamen der Captures-Stubs hashen die video_id, sodass dasselbe Quellvideo denselben Stub-Dateinamen bei wiederholten Durchläufen erzeugt. Wiederholungen aktualisieren, duplizieren nie.

Fehlende Untertitel

Wenn yt-dlp --list-subs keine manuellen oder automatischen Untertitel zurückgibt, schreibt das Skript einen Stub-Vault-Eintrag mit den Video-Metadaten und der Quell-URL, anstatt stillschweigend zu scheitern. Das --whisper-Flag ist für ein zukünftiges lokales Transkriptions-Fallback reserviert und meldet derzeit, dass das Fallback nicht implementiert ist.

Für ein manuelles Fallback heute: Audio mit yt-dlp herunterladen, mit Ihrem lokalen Whisper-Workflow transkribieren und Untertitel oder Transkripttext hinzufügen, bevor Sie den Einlesevorgang wiederholen.

Einschränkungen

  • Verarbeitet eine YouTube-Video-URL pro Durchlauf; Kanal-Handles, Playlists und --days-Fenster sind nicht abgedeckt.
  • Hängt von den von yt-dlp zurückgegebenen Untertiteln ab; Videos ohne Untertitel erzeugen einen Metadaten-Stub, kein Transkript.
  • Lädt keine Videodateien herunter und führt in dieser Version keine eingebaute Whisper-Transkription durch.
  • Netzwerkverfügbarkeit, YouTube-Untertitelzugriff und lokales yt-dlp-Verhalten bestimmen, ob der Einlesevorgang erfolgreich ist.

Abnahmetest

Gegen das erste jemals hochgeladene YouTube-Video ausführen:

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

Erwartete Ausgabe:

39 Wörter geschrieben nach /tmp/test/External Inputs/YouTube/jawed/2005-04-24-me-at-the-zoo.md. Sprache: en. Untertitelquelle: manual.

Die Ausgabedatei enthält gültiges Frontmatter und einen sauberen Prosatext.

Abhängigkeiten

  • yt-dlp (erforderlich): installieren via brew install yt-dlp oder pip3 install --user yt-dlp
  • whisper-cpp (optional für ein manuelles Fallback außerhalb dieses Skripts)

Quelle

Gebündelt in adelaidasofia/ai-brain-starter, einer Verifikationsumgebung um einen KI-Agenten, sodass sich Erinnerungen anreichern statt korrumpieren. Das Skill ist Teil der ingest-*-Familie von Vault-Connectoren.

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.

Verwandte Skills