gws-slides

Descripción general de la skill gws-slides

gws-slides es la skill de Google Slides en googleworkspace/cli para leer y escribir presentaciones mediante la CLI gws. Es la mejor opción para agentes que necesitan inspeccionar una presentación, crear una nueva o aplicar cambios estructurados sin editar Slides a mano en el navegador. Si tu tarea es “actualiza esta presentación de forma segura a partir de un prompt”, gws-slides es el punto de partida adecuado.

El valor principal de la skill gws-slides es que expone la API de Slides en un flujo de trabajo orientado a comandos, en lugar de asumir que un prompt genérico puede adivinar la forma correcta de la solicitud. Eso importa porque las actualizaciones de presentaciones suelen ser sensibles al esquema: títulos, IDs, recursos de página y operaciones por lotes necesitan parámetros válidos o toda la operación puede fallar. La skill también deja explícito el requisito previo: debes tener configurado gws-shared para la autenticación, las banderas globales y las reglas de seguridad.

Para qué sirve gws-slides

Usa gws-slides para Slide Decks cuando necesites acciones respaldadas por la API, como crear una presentación, obtener su estado actual o aplicar actualizaciones por lotes a páginas y otros recursos de la presentación. Encaja mejor con la automatización, los flujos editoriales repetibles y las tareas de mantenimiento guiadas por agentes que con la redacción puntual.

Cuándo es una buena opción

Elige la skill gws-slides si ya sabes que quieres trabajar dentro del ecosistema de Google Workspace CLI y puedes proporcionar un ID de deck, un título o un objetivo de edición concretos. Es una buena opción cuando necesitas cambios deterministas, no solo sugerencias sobre el contenido de las diapositivas.

Limitación principal a tener en cuenta

Esta skill no es, por sí sola, un sistema para “diseñar tu presentación desde cero”. Aun así tienes que traducir tu objetivo a solicitudes válidas de la API de Slides y, para cualquier cosa más allá del descubrimiento básico, deberías revisar el esquema del método antes de actuar. Si lo que buscas es estrategia visual de maquetación y no ejecución de la API, puede que te resulte más fácil un enfoque de prompting genérico.

Cómo usar la skill gws-slides

Instala gws-slides correctamente

Para instalar gws-slides, usa el flujo de paquete CLI del repositorio: npx skills add googleworkspace/cli --skill gws-slides. Después de instalarlo, verifica el requisito previo indicado en SKILL.md: debe existir ../gws-shared/SKILL.md para la autenticación y las reglas compartidas. Si ese archivo no está, el repositorio indica que debes ejecutar gws generate-skills.

Lee primero los archivos correctos

Empieza con skills/gws-slides/SKILL.md y luego lee el archivo de skill compartido al que hace referencia. La ruta más rápida es:

1. SKILL.md para la forma del comando y la lista de recursos.
2. ../gws-shared/SKILL.md para la autenticación y las restricciones de seguridad.
3. gws slides --help para ver los recursos y métodos disponibles.
4. gws schema slides.<resource>.<method> antes de construir una solicitud real.

Ese orden evita el fallo más común: enviar campos incorrectos a un método que sí es válido.

Convierte un objetivo difuso en un prompt útil

Una buena solicitud de uso de gws-slides es específica sobre el recurso, el método y el resultado. En lugar de decir “arregla mis diapositivas”, di algo como: “Usa gws-slides para inspeccionar la salida de presentations.get del deck abc123 y luego propone un plan de batchUpdate para renombrar el título y actualizar el texto de la primera página”. Incluye el identificador del deck, el cambio exacto y cualquier restricción, como conservar el diseño existente o evitar borrados de contenido.

Trabaja del esquema al comando

El flujo de trabajo de la skill se basa primero en el esquema. Usa gws schema para descubrir los parámetros obligatorios, las formas de los objetos y los valores predeterminados, y después traduce el cambio que quieres hacer a banderas de la CLI o a cuerpos de solicitud. Esto es especialmente importante para batchUpdate, donde varias operaciones se validan juntas y una sola solicitud incorrecta cancela todo el lote.

Preguntas frecuentes sobre la skill gws-slides

¿gws-slides es solo para usuarios avanzados?

No. También puede usarlo alguien principiante si sigue un flujo de trabajo de leer el esquema y luego actuar. La skill está más estructurada que un prompt simple, pero precisamente esa estructura es la que reduce errores.

¿En qué se diferencia gws-slides de un prompt normal?

Un prompt normal puede describir cómo debería verse una presentación. gws-slides puede inspeccionar de verdad los recursos de la presentación y ejecutar cambios respaldados por la API mediante gws. Eso la hace mejor para ediciones reales, pero también significa que debes proporcionar identificadores válidos y detalles a nivel de método.

¿Cuándo no debería usar gws-slides?

No uses gws-slides si solo necesitas ideas creativas para diapositivas, texto preliminar o un esquema no técnico. Tampoco es una buena opción si no tienes acceso al entorno de Google Workspace CLI o a la configuración compartida de autenticación requerida.

¿Qué debo comprobar antes de instalarla?

Confirma que tu flujo de trabajo depende de operaciones de la API de Google Slides y que puedes cumplir el requisito previo del archivo gws-shared. Si tu repositorio o tu entorno no pueden satisfacer esa dependencia, gws-slides será difícil de usar con fiabilidad.

Cómo mejorar la skill gws-slides

Dale al agente el contexto exacto del deck

Los prompts más sólidos para gws-slides incluyen el ID de la presentación, el recurso objetivo y la acción prevista. Si el deck es nuevo, dilo; si ya existe, aclara si el cambio debe conservar las diapositivas actuales, el orden o las notas del orador. Esto reduce las suposiciones y aumenta la probabilidad de que el primer comando sea válido.

Pide el método de la API, no solo el resultado

La skill funciona mejor cuando nombras la operación que esperas, como presentations.get o presentations.batchUpdate. Si solo pides “actualiza el deck”, el agente tiene que inferir el método y puede escoger una ruta incompleta. Las solicitudes con conciencia del método producen un uso mejor de gws-slides.

Usa iteración después de la primera lectura

Un flujo de trabajo práctico consiste en inspeccionar primero el deck y luego afinar la solicitud a partir de la estructura devuelta. Después del primer resultado, ajusta el prompt alrededor de la página, el campo o la operación por lotes exacta que quieres cambiar. Suele ser más eficaz que intentar especificar todos los detalles de cada diapositiva desde el principio.

Vigila los fallos de validación de batchUpdate

El fallo más común en gws-slides es un objeto de solicitud inválido dentro de un lote. Para evitarlo, construye lotes más pequeños, verifica los nombres de parámetros con gws schema y solo combina operaciones cuando cada una ya sepas que es válida.