use-runway-api
Ce skill fait partie des skills dits « legacy » du repository officiel runwayml/skills. Il est archivé sous legacy/skills/use-runway-api/ et n'est plus inclus dans le plugin actif Runway Dev. Il reste disponible pour les installations standalone ou les environnements épinglés sur une ancienne version du repository.
Rôle du skill
Le skill fournit à l'agent un script Node.js (scripts/runway-api.mjs, sans dépendances, Node 20+ requis) ainsi qu'un ensemble d'instructions détaillées pour appeler l'API publique Runway directement depuis la session de l'agent. L'agent peut ainsi lister et modifier des avatars, gérer des documents de connaissance, consulter des voix, vérifier le solde de crédits, déclencher des générations d'images/vidéos/audio et attendre leur résultat via un mécanisme de polling (wait <task-id>).
Quand l'utiliser
Ce skill est conçu pour les cas où l'utilisateur souhaite que l'agent agisse directement sur son compte Runway — créer ou mettre à jour des avatars, déclencher des générations, inspecter l'état de l'organisation, etc. Pour l'intégration de code applicatif, le README du repo recommande plutôt les skills actifs runway-dev et ses déclinaisons par surface (runway-dev-models, runway-dev-characters, etc.).
Structure et utilisation
Le SKILL.md embarque toutes les instructions opérationnelles : résolution du chemin absolu du script, vérification des credentials via la variable d'environnement RUNWAY_SKILLS_API_SECRET, commandes rapides pour les listes (avatars list, voices list, documents list), commande générique request <METHOD> <path>, gestion des gros payloads via --stdin, et support d'un environnement de staging avec --stage. L'agent est guidé pour consulter https://docs.dev.runwayml.com/llms.txt avant toute génération afin d'utiliser le contrat d'API courant.
Statut legacy
Comme indiqué dans le README du repo parent, ce skill est retiré du plugin actif et n'a pas été mis à jour. Les installations marketplace épinglées sur un ancien commit conservent leur version. Pour tout nouveau projet, les skills runway-dev et ses compléments constituent le chemin recommandé par Runway.