gws-drive
por googleworkspacegws-drive es la skill de Google Drive para Google Workspace CLI. Úsala para gestionar archivos, carpetas, unidades compartidas, propuestas de acceso y flujos de trabajo de Drive impulsados por API con menos margen de error. Encaja especialmente bien en desarrollo backend, automatización y tareas repetibles en la línea de comandos.
Esta skill obtiene 78/100, así que es una candidata sólida para el directorio: los usuarios probablemente podrán activarla con el patrón `gws drive <resource> <method> [flags]` y cubrir flujos reales de Google Drive, aunque deberán apoyarse en la dependencia general `gws-shared` para la autenticación y las reglas. El contenido tiene suficiente detalle para evaluar su instalación, pero no tanto como para sentirse listo para usar desde el primer momento.
- Alcance operativo sólido: cubre la gestión de Google Drive en recursos como about, accessproposals y muchos métodos de la Drive API, no solo una demo limitada.
- Buena capacidad de activación: la forma explícita del comando, el frontmatter válido y la referencia de ayuda respaldada por el repo (`gws drive --help`) facilitan que los agentes lo invoquen correctamente.
- Divulgación progresiva útil: un comando auxiliar enlaza a la guía específica de subida, y el cuerpo incluye notas y restricciones a nivel de API para algunas operaciones.
- No hay comando de instalación en SKILL.md ni archivos o scripts de apoyo, así que la configuración y la ejecución dependerán del contexto del repositorio externo y de la skill prerequisito compartida.
- La skill está orientada a métodos de API más que a playbooks de tareas, lo que puede dejar a los agentes con cierto margen de interpretación para flujos de usuario de extremo a extremo.
Descripción general de la skill gws-drive
Qué hace gws-drive
gws-drive es la skill de Google Drive para la Google Workspace CLI. Te ayuda a gestionar archivos, carpetas, unidades compartidas y flujos de trabajo relacionados con la Drive API desde la línea de comandos, con la guía específica de la skill necesaria para no tener que adivinar nombres de recursos, campos obligatorios ni restricciones de permisos.
Quién debería usarla
Usa la skill gws-drive si trabajas en Backend Development, automatización u ops y necesitas acciones repetibles en Drive dentro de scripts o flujos con agentes. Resulta especialmente útil cuando quieres un proceso respaldado por CLI para tareas de Drive en lugar de un prompt puntual, sobre todo para subidas, operaciones con metadatos y consultas impulsadas por API.
Qué conviene saber antes de instalarla
El valor principal de gws-drive no es la amplitud, sino la fiabilidad: orienta al agente hacia los recursos de Drive correctos y la forma adecuada de la solicitud. El mayor freno para adoptarla es la autenticación y la configuración compartida, porque la skill depende del entorno más amplio gws y de las instrucciones compartidas de gws-shared para los flags y las reglas de seguridad.
Cómo usar la skill gws-drive
Instalar y comprobar los requisitos previos
Instala la skill gws-drive en el contexto de la Google Workspace CLI y luego confirma primero el requisito compartido: ../gws-shared/SKILL.md. Los metadatos de la skill también esperan que el binario gws esté disponible, así que verifica que la CLI funcione antes de intentar un flujo de trabajo de Drive. Una ruta práctica de instalación es ejecutar gws drive --help después de la configuración y compararlo con la lista de recursos de la skill.
Empezar con la forma de entrada correcta
El patrón de uso de gws-drive es gws drive <resource> <method> [flags], así que tu prompt debe nombrar el recurso objetivo, la acción y las restricciones exactas de salida. Un buen input sería: “Lista las unidades compartidas a las que tengo acceso, devuelve solo name e id y excluye la papelera.” Un mal input sería: “Revisa Drive.” Si vas a usar la guía de gws-drive para Backend Development, incluye desde el inicio identificadores, carpetas padre y cualquier supuesto sobre permisos o scopes.
Leer primero estos archivos
Empieza con SKILL.md y después revisa ../gws-shared/SKILL.md, porque ahí se definen la autenticación, los flags globales y el comportamiento de seguridad. En este fragmento del repositorio no hay scripts auxiliares ni carpetas de soporte en las que apoyarse, así que el propio archivo de la skill es la principal fuente de verdad. Presta especial atención a las secciones de recursos de la API y al comando auxiliar +upload, porque muestran el flujo previsto en lugar de obligarte a inferirlo a partir de documentación genérica de Drive.
Flujo de trabajo que da mejores resultados
Usa un flujo de tres pasos: define el recurso, acota el método y añade solo los flags que afecten la respuesta de la API. Por ejemplo, una petición para obtener información de la cuenta de Drive debería mencionar que la llamada about.get requiere fields, mientras que el trabajo relacionado con subidas debería pasar por el comando auxiliar cuando quieras metadatos automáticos. Esta es la disciplina clave de uso de gws-drive: pide la respuesta útil más pequeña posible, no la más amplia.
Preguntas frecuentes sobre la skill gws-drive
¿gws-drive es solo para tareas básicas de Drive?
No. gws-drive cubre recursos centrales de Drive y comportamientos específicos de la API que importan en automatización, como que about.get requiera fields y la gestión de propuestas de acceso con restricciones exclusivas para aprobadores. Eso la hace más adecuada que un prompt genérico cuando tu tarea depende de la forma correcta de la API y no solo de una explicación general de Drive.
¿Cuándo no debería usar esta skill?
Omite la skill gws-drive si solo necesitas un consejo manual y puntual sobre Drive o si no tienes listo el CLI gws y la configuración compartida de autenticación. También encaja mal cuando tu tarea no tiene nada que ver con operaciones de Drive, porque la skill está optimizada para construir solicitudes y ejecutar comandos en la CLI, no para dar orientación general sobre Workspace.
¿Es apta para principiantes?
Sí, si puedes describir un objetivo concreto en Drive. La skill reduce la incertidumbre al mostrar el patrón recurso-método y los puntos de cautela clave, pero los principiantes siguen teniendo que indicar un archivo, carpeta, unidad compartida o escenario de permisos concreto. Sin eso, el agente puede generar un comando vago o elegir una llamada a la API demasiado amplia.
¿Cuál es la mayor diferencia frente a un prompt normal?
Un prompt normal puede explicar conceptos de Drive; gws-drive te da un flujo de trabajo anclado en la CLI y los recursos reales de la API. Eso importa cuando necesitas un comando determinista, una selección de campos válida o una operación consciente de permisos que no debería fallar en el primer intento.
Cómo mejorar la skill gws-drive
Dale al agente el contexto exacto de Drive
Los mejores resultados llegan cuando nombras el recurso, la acción y el alcance en una sola frase. Ejemplo: “Usa gws-drive para listar los archivos de la carpeta abc123, devuelve id, name, mimeType y modifiedTime, y no incluyas elementos en la papelera.” Esto es mucho más sólido que pedir que “encuentre documentos”, porque reduce la ambigüedad de búsqueda y evita salida innecesaria de la API.
Indica las restricciones que cambian la llamada a la API
Menciona si necesitas unidades compartidas, una carpeta concreta, una propuesta de acceso o información a nivel de cuenta. En gws-drive, esos detalles importan porque cada recurso tiene permisos y requisitos de respuesta distintos. Si los omites, el primer resultado suele fallar por falta de fields, falta de acceso de aprobador o una consulta demasiado amplia.
Itera del comando al resultado
Si la primera salida es demasiado amplia, ajusta la petición quitando la salida opcional y añadiendo los identificadores exactos que te importan. Si falla, comprueba si el problema es autenticación, requisitos previos faltantes de gws-shared o una combinación recurso-método incorrecta. El flujo de trabajo más rápido con gws-drive es corregir la forma del comando antes de cambiar la tarea en sí.