use-runway-api
Ce skill est un composant opérationnel du repo runwayml/skills, la collection officielle de skills Runway pour agents de code (Claude Code, Cursor, Codex, etc.). Son rôle est de donner à l'agent un accès direct à l'API publique Runway : lister et modifier des avatars, gérer des documents, déclencher des générations de médias, consulter le solde de crédits, etc.
Ce que contient ce skill
Le SKILL.md embarque des instructions détaillées pour l'agent : comment localiser le script runtime scripts/runway-api.mjs (livré dans le même dossier), comment vérifier l'authentification via la variable d'environnement RUNWAY_SKILLS_API_SECRET, et comment invoquer les différentes commandes — raccourcis de liste (avatars list, voices list, documents list) ou appel générique request <METHOD> <path>. Le script Node.js 20+ n'a aucune dépendance externe.
Quand utiliser ce skill
Ce skill est à privilégier dès que l'utilisateur souhaite agir sur son compte Runway — créer ou mettre à jour un avatar, déclencher une génération, attendre la complétion d'une tâche, inspecter l'organisation. Pour les tâches d'intégration dans une application (écriture de code serveur), les skills +integrate-* du même repo sont plus adaptés. Ce skill se combine naturellement avec +api-reference pour disposer du contrat API complet (modèles, formes de requêtes, coûts).
Environnement requis
L'exécution nécessite Node.js 20+ et la variable RUNWAY_SKILLS_API_SECRET positionnée dans l'environnement de l'agent. Un flag --stage permet de cibler l'API de staging avec une clé dédiée. Pour les payloads volumineux (images en base64), le flag --stdin contourne les limites d'arguments shell.