Communitygithub.com

Anhvu1107/all-agent-skill

À utiliser TOUJOURS lorsque la requête correspond à Videodb : perception, indexation et édition vidéo et audio.

Qu'est-ce que all-agent-skill ?

Cette compétence spécialisée pour agents IA (Claude Code, Cursor, etc.) vous permet d’interagir avec la plateforme VideoDB pour effectuer des opérations avancées sur la vidéo et l’audio : perception, indexation, recherche, édition de timeline, et surveillance en temps réel. Elle couvre l’ingestion de fichiers ou de flux (y compris YouTube, RTSP), la capture de bureau (macOS), la recherche sémantique avec horodatages, la génération de sous-titres et d’overlays, la composition de timeline, et le déclenchement d’alertes sur des événements visuels ou parlés. Le SKILL.md fournit un guide complet avec des extraits de code Python prêts à l’emploi, une gestion des erreurs robuste, et une référence pour éviter les pièges courants (index déjà existant, recherche sans résultat, timestamps négatifs). Il est conçu pour remplacer l’utilisation d’outils locaux comme ffmpeg ou moviepy pour toutes les opérations supportées côté serveur par VideoDB, ce qui simplifie et accélère les workflows de traitement vidéo.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Anhvu1107/all-agent-skill/tree/HEAD/.agent/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

Compétence VideoDB

Règle de lecture sélective

Commencez par :

  • references/senior-master-standard.md
  • references/usage-routing.md
  • references/quality-checklist.md

Ensuite, chargez uniquement les documents hérités, scripts, ressources ou exemples qui correspondent à la tâche réelle de l'utilisateur.

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

Utilisez cette compétence lorsque vous avez besoin :

Quand l'utiliser

  • Vous avez besoin de perception vidéo ou audio, d'indexation, de recherche ou d'édition de timeline à partir de fichiers, d'URL, de sessions de bureau ou de flux en direct.
  • La tâche implique des horodatages, des preuves consultables, des sous-titres, des clips, des incrustations ou des alertes de surveillance en temps réel.
  • Vous souhaitez un workflow unique combinant ingestion, compréhension, récupération et actions média.

1) Perception de bureau

  • Démarrer/arrêter une session de bureau capturant l'écran, le micro 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 lisibles

2) Ingestion vidéo + flux

  • Ingérer un fichier ou une URL et renvoyer un lien de flux web lisible
  • Transcodage/normalisation : codec, débit binaire, fps, résolution, rapport hauteur/largeur

3) Indexation + recherche (horodatages + preuves)

  • Créer des index visuels, vocaux et par mots-clés
  • Rechercher et renvoyer des moments précis avec horodatages et preuves lisibles
  • 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 exportations via opérations de timeline

5) Flux en direct (RTSP) + surveillance

  • Connecter des flux RTSP/en direct
  • Exécuter une compréhension visuelle et parlée 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 session
  • Opérations souhaitées : obtenir le contexte pour la compréhension, spécification de transcodage, spécification d'indexation, requête de recherche, plages de clips, modifications de timeline, règles d'alerte

Sorties courantes

  • URL du flux
  • Résultats de recherche avec horodatages et liens de preuve
  • Ressources générées : 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 mémoire

Invites canoniques (exemples)

  • « Démarrer la capture de bureau et alerter lorsqu'un champ de mot de passe apparaît. »
  • « Enregistrer ma session et produire un résumé exploitable à la fin. »
  • « Ingérer ce fichier et renvoyer un lien de flux lisible. »
  • « Indexer ce dossier et trouver chaque scène avec des personnes, renvoyer 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 lorsqu'une personne entre dans la zone. »

Exécuter du code Python

Avant d'exécuter du code VideoDB, placez-vous dans 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é)
  2. Le fichier .env du projet dans le répertoire courant

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

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

Lorsque vous écrivez du 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 de « configurer videodb » ou similaire :

1. Installer le SDK

pip install "videodb[capture]" python-dotenv

Si videodb[capture] échoue sous 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 lancer 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, n'écrivez et ne manipulez 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="/chemin/vers/video.mp4")

Transcription + sous-titre

# force=True ignore l'erreur si la vidéo est déjà indexée
video.index_spoken_words(force=True)
texte = video.get_transcript_text()
url_flux = 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é.
# Toujours encapsuler dans try/except et traiter "Aucun résultat trouvé" comme vide.
try:
    results = video.search("démo produit")
    shots = results.get_shots()
    url_flux = results.compile()
except InvalidRequestError as e:
    if "Aucun résultat trouvé" 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 — elle lève une erreur si un
# index de scène existe déjà. Extrayez l'ID d'index existant de 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\)?\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()
    url_flux = results.compile()
except InvalidRequestError as e:
    if "Aucun résultat trouvé" 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 un résultat cassé)
  • 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="Fin", duration=3, style=TextStyle(fontsize=36)))
url_flux = 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),
)

Recadrer le rapport hauteur/largeur (pour les plateformes sociales)

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

  • Limitez toujours à un court segment avec start/end autant que possible
  • Pour les vidéos complètes, utilisez callback_url pour un traitement asynchrone
  • Découpez d'abord la vidéo sur une Timeline, puis recadrez le résultat plus court
from videodb import ReframeMode

# Toujours préférer le recadrage d'un court segment :
recadree = 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)
recadree = video.reframe(start=0, end=60, target="square")

# Dimensions personnalisées
recadree = 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 des 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 de l'erreur avec re.search(r"id\(s\)?\s+([a-f0-9]+)", str(e))
La recherche ne trouve aucune correspondanceInvalidRequestError : Aucun résultat trouvéAttrapez l'exception et traitez comme des 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'asynchrone
Horodatages négatifs sur 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 le plan — informez l'utilisateur des limites du plan

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 l'écouteur : 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
evenements = [json.loads(l) for l in open("/tmp/videodb_events.jsonl")]

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

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

Scripts utilitaires

Pour le workflow complet de capture, consultez 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 — découpage, combinaison de clips, superposition audio ou musicale, ajout de sous-titres, incrustations de texte/image, transcodage, changements de résolution, conversion de rapport hauteur/largeur, redimensionnement pour les exigences de la plateforme, transcription et génération de médias. Revenez uniquement aux 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 (par 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/découper 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

Limitations

  • Utilisez cette compétence uniquement lorsque la tâche correspond clairement au champ d'application décrit ci-dessus.
  • Ne considérez pas la sortie comme un substitut à une validation, un test ou une revue d'expert spécifique à l'environnement.
  • Arrêtez-vous et demandez des clarifications si les entrées, autorisations, limites de sécurité ou critères de succès requis sont manquants.

Individual skills in this repo

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

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches 007: Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Agentfolio: Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Animejs Animation: Advanced JavaScript animation library skill for creating complex, high-performance web animations.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Astropy: Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Astro: Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Emotional ARC Designer: One sentence - what this skill does and when to invoke it

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Fixing Motion Performance: Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches I18n Localization: Internationalization and localization patterns.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Interactive Portfolio: Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches JQ: Expert jq usage for JSON querying, filtering, transformation, and pipeline integration.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Landing Page Generator: Generates high-converting Next.js/React landing pages with Tailwind CSS.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches LEX: Centralized ''Truth Engine'' for cross-jurisdictional legal context (US, EU, CA) and contract scaffolding.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Magic Animator: AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Makepad Animation: CRITICAL: Use for Makepad animation system.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Nextjs APP Router Patterns: Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

Anhvu1107/all-agent-skill

ALWAYS use this when the user mentions Nextjs Best Practices, asks to build, debug, review, document, automate, test, configure, migrate, or make decisions in this domain, or the task clearly depends on Nextjs Best Practices; scope: Next.js App Router principles. Apply the bundled workflow, references, scripts, Senior Master standard, and Codex strict review gate before final output.

Anhvu1107/all-agent-skill

description: ALWAYS use this when the work is specifically about modern Next.js or React architecture, data flow, rendering strategy, routing, or performance-sensitive frontend behavior.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Nextjs Supabase Auth: Expert integration of Supabase Auth with Next.js App Router

Anhvu1107/all-agent-skill

ALWAYS use this when the task involves reading, extracting, splitting, merging, rotating, creating, validating, OCR-ing, form-filling, or otherwise producing or modifying PDF files.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches React Nextjs Development: React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

Skills associés