Communitygithub.com

AbobakrDiara61/railway-system

Extrait les transcriptions de vidéos YouTube et génère des résumés complets et détaillés en utilisant des cadres d'analyse intelligents.

Qu'est-ce que railway-system ?

Cette compétence permet d'extraire automatiquement les transcriptions de vidéos YouTube et de produire des résumés détaillés et structurés en utilisant le cadre d'analyse STAR + R-I-S-E. Elle valide d'abord la disponibilité de la vidéo et de ses sous-titres via la bibliothèque Python `youtube-transcript-api`, puis applique un prompt de synthèse avancé pour générer un compte rendu complet incluant métadonnées, résumé exécutif, analyse section par section, concepts clés et références. Particulièrement utile pour les développeurs, les étudiants et les professionnels qui souhaitent documenter ou analyser du contenu éducatif (cours, tutoriels, conférences) sans devoir revoir l'intégralité de la vidéo. La compétence fonctionne avec des agents IA capables d'exécuter des commandes Python et de manipuler des fichiers, comme Claude Code ou tout autre agent intégré à un terminal. Elle inclut un suivi visuel de la progression en cinq étapes avec des barres de progression animées. L'utilisateur fournit simplement une URL YouTube valide, et la compétence s'occupe de la validation, de l'extraction, de la synthèse et de la mise en forme du résultat en Markdown. En cas de dépendance manquante, l'agent propose de l'installer automatiquement ou manuellement.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AbobakrDiara61/railway-system/tree/HEAD/frontend/skills/youtube-summarizer

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

youtube-summarizer

Objectif

Cette compétence extrait les transcriptions de vidéos YouTube et génère des résumés complets et détaillés en utilisant le cadre STAR + R-I-S-E. Elle valide la disponibilité de la vidéo, extrait la transcription via la bibliothèque Python youtube-transcript-api et produit une documentation détaillée capturant tous les enseignements, arguments et points clés.

Elle est conçue pour les utilisateurs qui ont besoin d'une analyse approfondie du contenu et d'une documentation de référence à partir de vidéos éducatives, de cours, de tutoriels ou de contenu informatif.

Quand utiliser cette compétence

Cette compétence doit être utilisée lorsque :

  • L'utilisateur fournit une URL YouTube et souhaite un résumé détaillé
  • L'utilisateur a besoin de documenter le contenu d'une vidéo sans la revoir
  • L'utilisateur souhaite extraire des enseignements, points clés et arguments d'un contenu éducatif
  • L'utilisateur a besoin de transcriptions de vidéos YouTube pour analyse
  • L'utilisateur demande de « résumer », « récapituler » ou « extraire le contenu » d'une vidéo YouTube
  • L'utilisateur souhaite une documentation complète privilégiant l'exhaustivité à la concision

Étape 0 : Découverte et configuration

Avant de traiter les vidéos, validez l'environnement et les dépendances :

# Vérifier si youtube-transcript-api est installé
python3 -c "import youtube_transcript_api" 2>/dev/null
if [ $? -ne 0 ]; then
    echo "⚠️  youtube-transcript-api introuvable"
    # Proposer l'installation
fi

# Vérifier la disponibilité de Python
if ! command -v python3 &>/dev/null; then
    echo "❌ Python 3 est requis mais n'est pas installé"
    exit 1
fi

Demandez à l'utilisateur si une dépendance manque :

youtube-transcript-api est requis mais n'est pas installé.

Souhaitez-vous l'installer maintenant ?
- [ ] Oui - Installer avec pip (pip install youtube-transcript-api)
- [ ] Non - Je l'installerai manuellement

Si l'utilisateur sélectionne « Oui » :

pip install youtube-transcript-api

Vérifiez l'installation :

python3 -c "import youtube_transcript_api; print('✅ youtube-transcript-api installé avec succès')"

Flux de travail principal

Directives de suivi de progression

Tout au long du flux de travail, affichez une jauge de progression visuelle avant chaque étape pour tenir l'utilisateur informé. Le format de la jauge est :

echo "[████░░░░░░░░░░░░░░░░] 20% - Étape 1/5 : Validation de l'URL"

Spécifications du format :

  • 20 caractères de large (utilisez █ pour rempli, ░ pour vide)
  • Incréments en pourcentage : Étape 1=20%, Étape 2=40%, Étape 3=60%, Étape 4=80%, Étape 5=100%
  • Compteur d'étapes indiquant l'étape courante / totale (ex. « Étape 3/5 »)
  • Brève description de la phase en cours

Affichez le statut initial avant l'étape 1 :

╔══════════════════════════════════════════════════════════════╗
║     📹  RÉSUMÉ YOUTUBE - Traitement de la vidéo               ║
╠══════════════════════════════════════════════════════════════╣
║ → Étape 1 : Validation de l'URL          [EN COURS]           ║
║ ○ Étape 2 : Vérification de disponibilité                     ║
║ ○ Étape 3 : Extraction de la transcription                    ║
║ ○ Étape 4 : Génération du résumé                              ║
║ ○ Étape 5 : Mise en forme du résultat                         ║
╠══════════════════════════════════════════════════════════════╣
║ Progression : ██████░░░░░░░░░░░░░░░░░░░░░░░░  20%            ║
╚══════════════════════════════════════════════════════════════╝

Étape 1 : Valider l'URL YouTube

Objectif : Extraire l'ID de la vidéo et valider le format de l'URL.

Formats d'URL pris en charge :

  • https://www.youtube.com/watch?v=VIDEO_ID
  • https://youtube.com/watch?v=VIDEO_ID
  • https://youtu.be/VIDEO_ID
  • https://m.youtube.com/watch?v=VIDEO_ID

Actions :

# Extraire l'ID de la vidéo via regex ou analyse d'URL
URL="$USER_PROVIDED_URL"

# Modèle 1 : youtube.com/watch?v=VIDEO_ID
if echo "$URL" | grep -qE 'youtube\.com/watch\?v='; then
    VIDEO_ID=$(echo "$URL" | sed -E 's/.*[?&]v=([^&]+).*/\1/')
# Modèle 2 : youtu.be/VIDEO_ID  
elif echo "$URL" | grep -qE 'youtu\.be/'; then
    VIDEO_ID=$(echo "$URL" | sed -E 's/.*youtu\.be\/([^?]+).*/\1/')
else
    echo "❌ Format d'URL YouTube invalide"
    exit 1
fi

echo "📹 ID de la vidéo extrait : $VIDEO_ID"

Si l'URL est invalide :

❌ URL YouTube invalide

Veuillez fournir une URL YouTube valide dans l'un des formats suivants :
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID

Exemple : https://www.youtube.com/watch?v=dQw4w9WgXcQ

Étape 2 : Vérifier la disponibilité de la vidéo et de la transcription

Progression :

echo "[████████░░░░░░░░░░░░] 40% - Étape 2/5 : Vérification de disponibilité"

Objectif : Vérifier que la vidéo existe et que la transcription est accessible.

Actions :

from youtube_transcript_api import YouTubeTranscriptApi, TranscriptsDisabled, NoTranscriptFound
import sys

video_id = sys.argv[1]

try:
    # Obtenir la liste des transcriptions disponibles
    transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
    
    print(f"✅ Vidéo accessible : {video_id}")
    print("📝 Transcriptions disponibles :")
    
    for transcript in transcript_list:
        print(f"  - {transcript.language} ({transcript.language_code})")
        if transcript.is_generated:
            print("    [Générée automatiquement]")
    
except TranscriptsDisabled:
    print(f"❌ Les transcriptions sont désactivées pour la vidéo {video_id}")
    sys.exit(1)
    
except NoTranscriptFound:
    print(f"❌ Aucune transcription trouvée pour la vidéo {video_id}")
    sys.exit(1)
    
except Exception as e:
    print(f"❌ Erreur lors de l'accès à la vidéo : {e}")
    sys.exit(1)

Gestion des erreurs :

ErreurMessageAction
Vidéo introuvable"❌ La vidéo n'existe pas ou est privée"Demander à l'utilisateur de vérifier l'URL
Transcriptions désactivées"❌ Les transcriptions sont désactivées pour cette vidéo"Impossible de continuer
Aucune transcription disponible"❌ Aucune transcription trouvée (ni générée automatiquement ni ajoutée manuellement)"Impossible de continuer
Vidéo privée/restreinte"❌ La vidéo est privée ou restreinte"Demander une vidéo publique

Étape 3 : Extraire la transcription

Progression :

echo "[████████████░░░░░░░░] 60% - Étape 3/5 : Extraction de la transcription"

Objectif : Récupérer la transcription dans la langue préférée.

Actions :

from youtube_transcript_api import YouTubeTranscriptApi

video_id = "VIDEO_ID"

try:
    # Essayer d'abord d'obtenir la transcription dans la langue préférée de l'utilisateur
    # Repli sur l'anglais si non disponible
    transcript = YouTubeTranscriptApi.get_transcript(
        video_id, 
        languages=['fr', 'en']  # Préférer français, repli sur anglais
    )
    
    # Combiner les segments de transcription en texte complet
    full_text = " ".join([entry['text'] for entry in transcript])
    
    # Obtenir les métadonnées de la vidéo
    from youtube_transcript_api import YouTubeTranscriptApi
    transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
    
    print("✅ Transcription extraite avec succès")
    print(f"📊 Longueur de la transcription : {len(full_text)} caractères")
    
    # Sauvegarder dans un fichier temporaire pour traitement
    with open(f"/tmp/transcript_{video_id}.txt", "w") as f:
        f.write(full_text)
    
except Exception as e:
    print(f"❌ Erreur lors de l'extraction de la transcription : {e}")
    exit(1)

Traitement de la transcription :

  • Combiner tous les segments de transcription en un texte cohérent
  • Conserver la ponctuation et le formatage lorsque disponibles
  • Supprimer les segments en double ou qui se chevauchent (artefacts de la génération automatique)
  • Stocker dans un fichier temporaire pour analyse

Étape 4 : Générer un résumé complet

Progression :

echo "[████████████████░░░░] 80% - Étape 4/5 : Génération du résumé"

Objectif : Appliquer le prompt amélioré STAR + R-I-S-E pour créer un résumé détaillé.

Prompt appliqué :

Utilisez le prompt amélioré de la Phase 2 (cadre STAR + R-I-S-E) avec la transcription extraite comme entrée.

Actions :

  1. Charger le texte complet de la transcription
  2. Appliquer le prompt de résumé complet
  3. Utiliser le modèle IA (Claude/GPT) pour générer un résumé structuré
  4. S'assurer que la sortie suit la structure définie :
    • En-tête avec métadonnées de la vidéo
    • Synthèse exécutive
    • Analyse détaillée section par section
    • Enseignements clés et conclusions
    • Concepts et terminologie
    • Ressources et références

Implémentation :

# Utiliser le fichier de transcription comme entrée du prompt IA
TRANSCRIPT_FILE="/tmp/transcript_${VIDEO_ID}.txt"

# L'agent IA va :
# 1. Lire la transcription
# 2. Appliquer le cadre de résumé STAR + R-I-S-E
# 3. Générer une sortie Markdown complète
# 4. Structurer avec des en-têtes, listes et mises en évidence

Lire "$TRANSCRIPT_FILE"  # Lire la transcription dans le contexte

Appliquez ensuite le prompt de résumé complet (selon la version améliorée de la Phase 2).

Étape 5 : Mettre en forme et présenter le résultat

Progression :

echo "[████████████████████] 100% - Étape 5/5 : Mise en forme du résultat"

Objectif : Fournir le résumé dans un Markdown propre et bien structuré.

Structure du résultat :

# [Titre de la vidéo]

**Chaîne :** [Nom de la chaîne]  
**Durée :** [Durée]  
**URL :** [https://youtube.com/watch?v=VIDEO_ID]  
**Date de publication :** [Date si disponible]


## 📝 Résumé détaillé

### [Sujet 1]

[Explication complète avec exemples, données, citations...]

#### [Sous-sujet 1.1]

[Analyse détaillée...]

### [Sujet 2]

[Analyse détaillée suite...]


## 📚 Concepts et terminologie

- **[Terme 1] :** [Définition et contexte]
- **[Terme 2] :** [Définition et contexte]


## 📌 Conclusion

[Synthèse finale et points à retenir]

Exemple 2 : Dépendance manquante

Entrée utilisateur :

claude> résume cette vidéo youtube https://youtu.be/abc123

Réponse de la compétence :

⚠️  youtube-transcript-api non installé

Cette compétence nécessite la bibliothèque Python 'youtube-transcript-api'.

Souhaitez-vous que je l'installe maintenant ?
- [ ] Oui - Installer avec pip
- [ ] Non - Je l'installerai manuellement

L'utilisateur sélectionne « Oui » :

$ pip install youtube-transcript-api
Successfully installed youtube-transcript-api-0.6.1

✅ Installation terminée ! Poursuite du résumé vidéo...

Exemple 4 : URL invalide

Entrée utilisateur :

claude> résume la vidéo youtube www.youtube.com/some-video

Réponse de la compétence :

❌ Format d'URL YouTube invalide

Exemples de formats attendus :
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID

Veuillez fournir une URL de vidéo YouTube valide.

📊 Résumé exécutif

Cette vidéo propose une introduction complète aux concepts fondamentaux de l'Intelligence Artificielle (IA), conçue pour les débutants et les professionnels souhaitant comprendre les bases techniques et les applications pratiques de l'IA moderne. L'instructeur couvre tout, des définitions de base aux algorithmes d'apprentissage automatique, en utilisant des exemples pratiques et des visualisations pour faciliter la compréhension.

[... suite du résumé détaillé ...]

Options de sauvegarde :

Que souhaitez-vous sauvegarder ?
→ Résumé + transcription brute

✅ Fichier sauvegardé : resume-exemple123-2026-02-01.md (inclut la transcription brute)
[████████████████████] 100% - ✓ Traitement terminé !

Bienvenue dans ce tutoriel complet sur les fondamentaux de l'apprentissage automatique. Dans la vidéo d'aujourd'hui, nous explorerons les concepts fondamentaux qui alimentent les systèmes d'IA modernes...

Version : 1.2.0 Dernière mise à jour : 2026-02-02 Maintenu par : Eric Andrade

Limitations

  • N'utilisez cette compétence que lorsque la tâche correspond clairement au champ décrit ci-dessus.
  • Ne considérez pas le résultat comme un substitut à une validation spécifique à l'environnement, à des tests ou à une relecture experte.
  • Arrêtez-vous et demandez des clarifications si les entrées requises, les autorisations, les limites de sécurité ou les critères de succès sont manquants.

Individual skills in this repo

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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 悬停效果

AbobakrDiara61/railway-system

Best practices for Remotion - Video creation in React

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

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.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

AbobakrDiara61/railway-system

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

AbobakrDiara61/railway-system

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

AbobakrDiara61/railway-system

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

AbobakrDiara61/railway-system

Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.

Skills associés