Communitygithub.com

Desesbraker/agentes-vip

Perception, indexation et édition de vidéo et d'audio. Ingérez des fichiers, URLs ou flux en direct, construisez des index visuels et vocaux, recherchez avec horodatages, éditez des timelines, ajoutez des incrustations et sous-titres, générez du contenu multimédia et créez des alertes en temps réel.

Qu'est-ce que agentes-vip ?

Ce skill VideoDB fournit une suite complète de perception, mémoire et actions pour la vidéo, les flux en direct et les sessions de bureau. Il permet de capturer l'écran, le microphone et l'audio système, de diffuser du contexte en direct, de mémoriser des sessions épisodiques et de déclencher des alertes en temps réel sur ce qui est dit ou affiché. Il prend en charge l'ingestion de fichiers et d'URLs, la normalisation (codec, débit, images par seconde, résolution, rapport hauteur/largeur), l'indexation visuelle et vocale, la recherche par horodatage avec preuves jouables, et la création automatique de clips. Les fonctionnalités d'édition incluent la génération et l'incrustation de sous-titres, les incrustations de texte et d'image, les légendes animées, l'ajout de musique de fond, de voix off et de doublage. Il gère également les flux RTSP en direct avec compréhension visuelle et vocale en temps réel pour émettre des événements et des alertes. Le skill est conçu pour être utilisé sur n'importe quelle plateforme d'agent AI (Claude Code, Cursor, Codex, etc.) et s'appuie sur le SDK Python VideoDB pour toutes les opérations, évitant ainsi les outils locaux comme ffmpeg ou moviepy.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Desesbraker/agentes-vip/tree/HEAD/full%20skill/plugins/antigravity-awesome-skills-claude/skills/videodb

Demander à votre IA préférée

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

Documentation

Skill VideoDB

Perception + mémoire + actions pour la vidéo, les flux en direct et les sessions de bureau.

Utilisez ce skill lorsque vous avez besoin de :

1) Perception de bureau

  • Démarrer/arrêter une session de bureau capturant l'écran, le microphone et l'audio système
  • Diffuser le contexte en direct et stocker la mémoire de session épisodique
  • Exécuter des alertes/déclencheurs en temps réel sur ce qui est dit et ce qui se passe à l'écran
  • Produire des résumés de session, une timeline consultable et des liens de preuve jouables

2) Ingestion vidéo + diffusion

  • Ingérer un fichier ou une URL et retourner un lien de diffusion web jouable
  • Transcoder/normaliser : codec, débit, images par seconde, résolution, rapport hauteur/largeur

3) Indexation + recherche (horodatages + preuves)

  • Construire des index visuels, vocaux et par mots-clés
  • Rechercher et retourner des moments précis avec des horodatages et des preuves jouables
  • Créer automatiquement des clips à partir des résultats de recherche

4) Édition de timeline + génération

  • Sous-titres : générer, traduire, incruster
  • Incrustations : texte/image/marque, légendes animées
  • Audio : musique de fond, voix off, doublage
  • Composition programmatique et exports via opérations de timeline

5) Flux en direct (RTSP) + surveillance

  • Connecter des flux RTSP/en direct
  • Exécuter une compréhension visuelle et vocale en temps réel et émettre des événements/alertes pour les workflows de surveillance

Entrées courantes

  • Chemin de fichier local, URL publique ou URL RTSP
  • Demande de capture de bureau : démarrer / arrêter / résumer la session
  • Opérations souhaitées : obtenir du contexte pour la compréhension, spécification de transcodage, spécification d'indexation, requête de recherche, plages de clip, éditions de timeline, règles d'alerte

Sorties courantes

  • URL de diffusion
  • Résultats de recherche avec horodatages et liens de preuve
  • Actifs générés : sous-titres, audio, images, clips
  • Charges utiles d'événements/alertes pour les flux en direct
  • Résumés de session de bureau et entrées de mémoire

Invites canoniques (exemples)

  • "Démarrer la capture de bureau et alerter quand un champ de mot de passe apparaît."
  • "Enregistrer ma session et produire un résumé exploitable à la fin."
  • "Ingérer ce fichier et retourner un lien de diffusion jouable."
  • "Indexer ce dossier et trouver chaque scène avec des personnes, retourner les horodatages."
  • "Générer des sous-titres, les incruster et ajouter une musique de fond légère."
  • "Connecter cette URL RTSP et alerter quand une personne entre dans la zone."

Exécution de code Python

Avant d'exécuter tout code VideoDB, changez de répertoire vers le répertoire du projet et chargez les variables d'environnement :

from dotenv import load_dotenv
load_dotenv(".env")

import videodb
conn = videodb.connect()

Ceci lit VIDEO_DB_API_KEY depuis :

  1. L'environnement (si déjà exportée)
  2. Le fichier .env du projet dans le répertoire courant

Si la clé est manquante, videodb.connect() lève automatiquement AuthenticationError.

N'écrivez PAS de fichier script lorsqu'une commande courte en ligne fonctionne.

Lorsque vous écrivez du code Python en ligne (python -c "..."), utilisez toujours un code correctement formaté — utilisez des points-virgules pour séparer les instructions et gardez-le lisible. Pour tout ce qui dépasse environ 3 instructions, utilisez plutôt un heredoc :

python << 'EOF'
from dotenv import load_dotenv
load_dotenv(".env")

import videodb
conn = videodb.connect()
coll = conn.get_collection()
print(f"Vidéos : {len(coll.get_videos())}")
EOF

Configuration

Lorsque l'utilisateur demande "configurer videodb" ou similaire :

1. Installer le SDK

pip install "videodb[capture]" python-dotenv

Si videodb[capture] échoue sur Linux, installez sans l'extension capture :

pip install videodb python-dotenv

2. Configurer la clé API

L'utilisateur doit définir VIDEO_DB_API_KEY en utilisant l'une ou l'autre méthode :

  • Exporter dans le terminal (avant de démarrer Claude) : export VIDEO_DB_API_KEY=votre-clé
  • Fichier .env du projet : Enregistrez VIDEO_DB_API_KEY=votre-clé dans le fichier .env du projet

Obtenez une clé API gratuite sur https://console.videodb.io (50 téléchargements gratuits, sans carte de crédit).

Ne lisez PAS, n'écrivez PAS et ne gérez PAS la clé API vous-même. Laissez toujours l'utilisateur la définir.

Référence rapide

Télécharger un média

# URL
video = coll.upload(url="https://example.com/video.mp4")

# YouTube
video = coll.upload(url="https://www.youtube.com/watch?v=VIDEO_ID")

# Fichier local
video = coll.upload(file_path="/path/to/video.mp4")

Transcription + sous-titres

# force=True ignore l'erreur si la vidéo est déjà indexée
video.index_spoken_words(force=True)
text = video.get_transcript_text()
stream_url = video.add_subtitle()

Rechercher dans les vidéos

from videodb.exceptions import InvalidRequestError

video.index_spoken_words(force=True)

# search() lève InvalidRequestError quand aucun résultat n'est trouvé.
# Enveloppez toujours dans try/except et traitez "No results found" comme vide.
try:
    results = video.search("démonstration produit")
    shots = results.get_shots()
    stream_url = results.compile()
except InvalidRequestError as e:
    if "No results found" in str(e):
        shots = []
    else:
        raise

Recherche par scène

import re
from videodb import SearchType, IndexType, SceneExtractionType
from videodb.exceptions import InvalidRequestError

# index_scenes() n'a pas de paramètre force — il lève une erreur si un index
# de scène existe déjà. Extrayez l'ID d'index existant depuis l'erreur.
try:
    scene_index_id = video.index_scenes(
        extraction_type=SceneExtractionType.shot_based,
        prompt="Décrivez le contenu visuel de cette scène.",
    )
except Exception as e:
    match = re.search(r"id\s+([a-f0-9]+)", str(e))
    if match:
        scene_index_id = match.group(1)
    else:
        raise

# Utilisez score_threshold pour filtrer le bruit de faible pertinence (recommandé : 0.3+)
try:
    results = video.search(
        query="personne écrivant sur un tableau blanc",
        search_type=SearchType.semantic,
        index_type=IndexType.scene,
        scene_index_id=scene_index_id,
        score_threshold=0.3,
    )
    shots = results.get_shots()
    stream_url = results.compile()
except InvalidRequestError as e:
    if "No results found" in str(e):
        shots = []
    else:
        raise

Édition de timeline

Important : Validez toujours les horodatages avant de construire une timeline :

  • start doit être >= 0 (les valeurs négatives sont acceptées silencieusement mais produisent une sortie cassée)
  • start doit être < end
  • end doit être <= video.length
from videodb.timeline import Timeline
from videodb.asset import VideoAsset, TextAsset, TextStyle

timeline = Timeline(conn)
timeline.add_inline(VideoAsset(asset_id=video.id, start=10, end=30))
timeline.add_overlay(0, TextAsset(text="The End", duration=3, style=TextStyle(fontsize=36)))
stream_url = timeline.generate_stream()

Transcodage vidéo (changement de résolution / qualité)

from videodb import TranscodeMode, VideoConfig, AudioConfig

# Changer la résolution, la qualité ou le rapport hauteur/largeur côté serveur
job_id = conn.transcode(
    source="https://example.com/video.mp4",
    callback_url="https://example.com/webhook",
    mode=TranscodeMode.economy,
    video_config=VideoConfig(resolution=720, quality=23, aspect_ratio="16:9"),
    audio_config=AudioConfig(mute=False),
)

Changer le rapport hauteur/largeur (pour les réseaux sociaux)

Attention : reframe() est une opération côté serveur lente. Pour les vidéos longues, cela peut prendre plusieurs minutes et peut expirer. Bonnes pratiques :

  • Limitez toujours à un court segment en utilisant start/end quand c'est possible
  • Pour les vidéos complètes, utilisez callback_url pour le traitement asynchrone
  • Rognez d'abord la vidéo sur une Timeline, puis recadrez le résultat plus court
from videodb import ReframeMode

# Préférez toujours recadrer un court segment :
reframed = video.reframe(start=0, end=60, target="vertical", mode=ReframeMode.smart)

# Recadrage asynchrone pour les vidéos complètes (retourne None, résultat via webhook) :
video.reframe(target="vertical", callback_url="https://example.com/webhook")

# Préréglages : "vertical" (9:16), "square" (1:1), "landscape" (16:9)
reframed = video.reframe(start=0, end=60, target="square")

# Dimensions personnalisées
reframed = video.reframe(start=0, end=60, target={"width": 1280, "height": 720})

Média génératif

image = coll.generate_image(
    prompt="un coucher de soleil sur les montagnes",
    aspect_ratio="16:9",
)

Gestion des erreurs

from videodb.exceptions import AuthenticationError, InvalidRequestError

try:
    conn = videodb.connect()
except AuthenticationError:
    print("Vérifiez votre VIDEO_DB_API_KEY")

try:
    video = coll.upload(url="https://example.com/video.mp4")
except InvalidRequestError as e:
    print(f"Échec du téléchargement : {e}")

Pièges courants

ScénarioMessage d'erreurSolution
Indexer une vidéo déjà indexéeL'index de mots parlés pour la vidéo existe déjàUtilisez video.index_spoken_words(force=True) pour ignorer si déjà indexé
L'index de scène existe déjàL'index de scène avec l'id XXXX existe déjàExtrayez le scene_index_id existant depuis l'erreur avec re.search(r"id\s+([a-f0-9]+)", str(e))
La recherche ne trouve aucune correspondanceInvalidRequestError: No results foundAttrapez l'exception et traitez comme résultats vides (shots = [])
Le recadrage expireBloque indéfiniment sur les vidéos longuesUtilisez start/end pour limiter le segment, ou passez callback_url pour l'async
Horodatages négatifs sur la TimelineProduit silencieusement un flux casséValidez toujours start >= 0 avant de créer VideoAsset
generate_video() / create_collection() échoueOpération non autorisée ou limite maximaleFonctionnalités limitées par abonnement — informez l'utilisateur des limites de l'abonnement

Documentation supplémentaire

La documentation de référence se trouve dans le répertoire reference/ adjacent à ce fichier SKILL.md. Utilisez l'outil Glob pour le localiser si nécessaire.

Enregistrement d'écran (Capture de bureau)

Utilisez ws_listener.py pour capturer les événements WebSocket pendant les sessions d'enregistrement. La capture de bureau prend en charge macOS uniquement.

Démarrage rapide

  1. Démarrer le listener : python scripts/ws_listener.py &
  2. Obtenir l'ID WebSocket : cat /tmp/videodb_ws_id
  3. Exécuter le code de capture (voir reference/capture.md pour le workflow complet)
  4. Événements écrits dans : /tmp/videodb_events.jsonl

Interroger les événements

import json
events = [json.loads(l) for l in open("/tmp/videodb_events.jsonl")]

# Obtenir toutes les transcriptions
transcripts = [e["data"]["text"] for e in events if e.get("channel") == "transcript"]

# Obtenir les descriptions visuelles des 5 dernières minutes
import time
cutoff = time.time() - 300
recent_visual = [e for e in events 
                 if e.get("channel") == "visual_index" and e["unix_ts"] > cutoff]

Scripts utilitaires

Pour un workflow de capture complet, voir reference/capture.md.

N'utilisez pas ffmpeg, moviepy ou d'outils d'encodage locaux lorsque VideoDB prend en charge l'opération. Les opérations suivantes sont toutes gérées côté serveur par VideoDB : rogner, combiner des clips, superposer de l'audio ou de la musique, ajouter des sous-titres, incrustations de texte/image, transcodage, changements de résolution, conversion de rapport hauteur/largeur, redimensionnement pour les exigences de plateforme, transcription et génération de média. Repliez-vous uniquement sur des outils locaux pour les opérations listées sous Limitations dans reference/editor.md (transitions, changements de vitesse, recadrage/zoom, étalonnage des couleurs, mixage du volume).

Quand utiliser quoi

ProblèmeSolution VideoDB
La plateforme rejette le rapport hauteur/largeur ou la résolution de la vidéovideo.reframe() ou conn.transcode() avec VideoConfig
Besoin de redimensionner une vidéo pour Twitter/Instagram/TikTokvideo.reframe(target="vertical") ou target="square"
Besoin de changer la résolution (ex. 1080p → 720p)conn.transcode() avec VideoConfig(resolution=720)
Besoin de superposer de l'audio/de la musique sur une vidéoAudioAsset sur une Timeline
Besoin d'ajouter des sous-titresvideo.add_subtitle() ou CaptionAsset
Besoin de combiner/rogner des clipsVideoAsset sur une Timeline
Besoin de générer une voix off, de la musique ou des effets sonorescoll.generate_voice(), generate_music(), generate_sound_effect()

Dépôt

https://github.com/video-db/skills

Maintenu par : VideoDB

Individual skills in this repo

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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.

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

Best practices for Remotion - Video creation in React

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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.

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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.

Desesbraker/agentes-vip

Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks

Desesbraker/agentes-vip

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.

Desesbraker/agentes-vip

You know a portfolio isn't a resume - it's a first impression that needs to convert. You balance creativity with usability. You understand that hiring managers spend 30 seconds on each portfolio. You make those 30 seconds count. You help people stand out without being gimmicky.

Skills associés