gws-slides

Aperçu de la skill gws-slides

gws-slides est la skill Google Slides de googleworkspace/cli pour lire et modifier des présentations via l’interface gws CLI. Elle convient particulièrement aux agents qui doivent inspecter un deck, en créer un ou appliquer des modifications structurées sans éditer manuellement les diapositives dans le navigateur. Si votre objectif est de « mettre à jour cette présentation de façon sûre à partir d’un prompt », gws-slides est le bon point de départ.

La principale valeur de la skill gws-slides est d’exposer l’API Slides dans un flux de travail orienté commande, au lieu de supposer qu’un prompt générique devinera la bonne forme de requête. C’est important, car les mises à jour de présentations sont souvent sensibles au schéma : titres, IDs, ressources de page et opérations en lot exigent des paramètres valides, sinon toute l’opération peut échouer. La skill rend aussi la prérequis explicite : vous devez disposer de la configuration partagée gws-shared pour l’authentification, les options globales et les règles de sécurité.

À quoi sert gws-slides

Utilisez gws-slides pour les Slide Decks lorsque vous avez besoin d’actions reposant sur l’API, comme créer une présentation, récupérer son état actuel ou appliquer des mises à jour groupées à des pages et à d’autres ressources de présentation. Elle est mieux adaptée à l’automatisation, aux workflows éditoriaux répétables et aux tâches de maintenance pilotées par agent qu’à la rédaction ponctuelle.

Quand c’est un bon choix

Choisissez la skill gws-slides si vous savez déjà que vous voulez travailler dans l’écosystème Google Workspace CLI et que vous pouvez fournir un ID de deck, un titre ou un objectif d’édition précis. C’est un très bon choix lorsque vous avez besoin de changements déterministes, pas seulement de सुझावs sur le contenu des diapositives.

Limite principale à connaître

Cette skill n’est pas, à elle seule, un système pour « concevoir votre présentation de zéro ». Vous devez toujours traduire votre objectif en requêtes Slides API valides, et pour tout ce qui dépasse la découverte de base, il faut s’attendre à examiner le schéma de la méthode avant d’agir. Si vous cherchez une stratégie de mise en page visuelle plutôt qu’une exécution via API, une approche de prompting générique peut être plus simple.

Comment utiliser la skill gws-slides

Installer gws-slides correctement

Pour l’installation de gws-slides, utilisez le flux du package CLI du dépôt : npx skills add googleworkspace/cli --skill gws-slides. Après l’installation, vérifiez la prérequis indiqué dans SKILL.md : ../gws-shared/SKILL.md doit exister pour l’authentification et les règles partagées. Si ce fichier manque, le dépôt indique d’exécuter gws generate-skills.

Lire d’abord les bons fichiers

Commencez par skills/gws-slides/SKILL.md, puis lisez le fichier de skill partagé auquel il renvoie. Le chemin le plus rapide est :

1. SKILL.md pour la forme des commandes et la liste des ressources.
2. ../gws-shared/SKILL.md pour l’authentification et les contraintes de sécurité.
3. gws slides --help pour voir les ressources et méthodes disponibles.
4. gws schema slides.<resource>.<method> avant de construire une vraie requête.

Cette séquence évite l’échec le plus courant : envoyer les mauvais champs à une méthode pourtant valide.

Transformer un objectif flou en prompt exploitable

Une bonne demande d’usage de gws-slides est précise sur la ressource, la méthode et le résultat attendu. Au lieu de dire « corrige mes diapositives », dites par exemple : « Utilise gws-slides pour inspecter la sortie de presentations.get du deck abc123, puis propose un plan batchUpdate pour renommer le titre et mettre à jour le texte de la première page. » Incluez l’identifiant du deck, la modification exacte et toute contrainte, comme la préservation de la mise en page existante ou l’absence de suppression de contenu.

Partir du schéma pour aller vers la commande

Le workflow de la skill part du schéma. Utilisez gws schema pour découvrir les paramètres obligatoires, les structures d’objets et les valeurs par défaut, puis mappez votre changement prévu vers les options CLI ou les corps de requête. C’est particulièrement important pour batchUpdate, où plusieurs opérations sont validées ensemble et où une seule requête incorrecte annule tout le lot.

FAQ sur la skill gws-slides

gws-slides est-elle réservée aux utilisateurs avancés ?

Non. Elle reste utilisable par des débutants s’ils peuvent suivre un workflow « lire le schéma puis agir ». La skill est plus structurée qu’un prompt libre, mais c’est précisément cette structure qui réduit les erreurs.

En quoi gws-slides diffère-t-elle d’un prompt classique ?

Un prompt classique peut décrire l’apparence souhaitée d’une présentation. gws-slides peut, elle, inspecter les ressources de présentation et exécuter des changements réels via l’API, à travers gws. Elle est donc meilleure pour de vraies modifications, mais cela implique aussi de fournir des identifiants valides et des détails au niveau des méthodes.

Quand ne faut-il pas utiliser gws-slides ?

N’utilisez pas gws-slides si vous avez seulement besoin d’idées créatives pour des slides, d’un texte approximatif ou d’un plan non technique. Elle convient aussi mal si vous n’avez pas accès à l’environnement Google Workspace CLI ou à la configuration d’authentification partagée requise.

Que faut-il vérifier avant d’installer ?

Vérifiez que votre workflow dépend bien d’opérations Google Slides API et que vous pouvez satisfaire la dépendance au fichier gws-shared. Si votre dépôt ou votre environnement ne peut pas remplir cette dépendance, gws-slides sera difficile à utiliser de manière fiable.

Comment améliorer la skill gws-slides

Donner à l’agent le contexte exact du deck

Les prompts gws-slides les plus solides incluent l’ID de la présentation, la ressource cible et l’action attendue. Si le deck est nouveau, dites-le ; s’il existe déjà, précisez si la modification doit préserver les slides actuelles, l’ordre ou les notes du présentateur. Cela réduit les suppositions et augmente les chances que la première commande soit valide.

Demander la méthode API, pas seulement le résultat

La skill fonctionne mieux quand vous nommez l’opération attendue, par exemple presentations.get ou presentations.batchUpdate. Si vous demandez seulement « mets à jour le deck », l’agent doit déduire la méthode et peut emprunter une voie incomplète. Des requêtes orientées méthode donnent une meilleure utilisation de gws-slides.

Itérer après la première lecture

Un workflow pratique consiste à inspecter d’abord le deck, puis à affiner la demande à partir de la structure renvoyée. Après le premier résultat, resserrez le prompt autour de la page exacte, du champ exact ou de l’opération batch à modifier. C’est généralement plus efficace que de vouloir tout préciser d’emblée sur chaque slide.

Surveiller les échecs de validation de batchUpdate

Le mode d’échec le plus courant dans gws-slides est un objet de requête invalide à l’intérieur d’un batch. Pour l’éviter, construisez des lots plus petits, vérifiez les noms de paramètres avec gws schema, et ne regroupez les opérations qu’une fois que chacune est reconnue comme valide.