DrErwin/videoscript-skill

Transcriptions VideoScript

Ce que fait cette compétence

Elle pilote le client en ligne de commande videoscript. Le CLI dialogue avec l'API publique VideoScript en utilisant une clé que l'utilisateur a générée pour lui-même ; le service effectue l'extraction, la transcription et la facturation. Cette compétence ne parle jamais HTTP elle-même et ne manipule jamais de clé.

Avant toute chose

videoscript auth status --json

• {"authenticated": true, ...} → continuez.
• Code de sortie 3 → l'utilisateur n'est pas connecté. Dites-lui de créer une clé API sur le site VideoScript et d'exécuter videoscript auth login --token <clé> lui-même. Ne lui demandez jamais de coller la clé dans la conversation, et ne l'affichez jamais.
• videoscript introuvable → demandez à l'utilisateur de l'installer (npm install -g videoscript).

Le flux normal

# 1. soumettre (renvoie immédiatement un identifiant de tâche)
videoscript transcribe create "<url>" --json

# 2. attendre (respecte le Retry-After du serveur)
videoscript transcribe wait <id> --json

# 3. écrire la transcription dans un fichier, pas dans le chat
videoscript transcript get <id> --format markdown --output notes/<nom>.md

Règles importantes :

• Une soumission = une clé d'idempotence. Le CLI la génère et la renvoie dans --json ; si un appel doit être réessayé, réutilisez cette clé (--idempotency-key) pour que l'utilisateur ne soit jamais facturé deux fois.
• Les longues transcriptions vont dans des fichiers. Lisez le fichier seulement dans la mesure nécessaire à la demande de l'utilisateur. Ne collez jamais une transcription d'une heure entière dans la conversation.
• La consommation est visible. Chaque tâche terminée utilise les Crédits de l'utilisateur et apparaît dans sa bibliothèque ; dites-le avant de soumettre quelque chose de long.
• Les limites de contenu sont celles du service, pas les vôtres. Les connexions, contenus payants, DRM, blocages régionaux et flux en direct sont refusés par conception. Ne suggérez pas de proxies, cookies ou téléchargeurs tiers.

En cas de problème

Codes de sortie : 3 connexion, 4 tâche introuvable, 5 réessayer plus tard, 6 Crédits/budget, 7 source refusée.

• 5 → attendez le Retry-After que le CLI rapporte, puis réessayez. Le CLI effectue déjà deux tentatives automatiquement.
• 6 → dites à l'utilisateur que son solde ou le budget de cette clé est épuisé ; ne tentez jamais un achat.
• 7 → expliquez clairement la restriction et arrêtez. Ne réessayez pas.
• 1/2 → erreur inattendue ou mauvais arguments ; lisez le message, corrigez l'appel.

Tableaux complets : reference/cli.md et reference/errors.md.

Ce que cette compétence ne fait pas

Téléchargements, tâches en lot, suppression de tâches, paiements, actions d'administration, ou quoi que ce soit nécessitant le mot de passe de l'utilisateur. Les portées de la clé sont appliquées par le service.