# Instrucciones para el agente: gws: conecta agentes con operaciones de Google Workspace

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: principiante
- Proyecto: https://github.com/googleworkspace/cli (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/gws-workspace-skills

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

Comprueba Node.js ≥22.20.0 y npm/npx para la secuencia completa: la CLI principal pide ≥18, pero la instalación posterior de skills exige ≥22.20.0 según su [manifiesto](https://github.com/vercel-labs/skills/blob/main/package.json). Para `gws auth setup`, comprueba además que gcloud está instalado y autenticado; si no lo tienes, sigue la ruta manual de OAuth del README. Comandos del README:

```bash
npm install -g @googleworkspace/cli
```

Configura OAuth según la guía; el asistente requiere gcloud:

```bash
gws auth setup
gws auth login
```

Instala las skills con:

```bash
npx skills add https://github.com/googleworkspace/cli
```

## Comprobación

Prueba una lectura documentada:

```bash
gws drive files list --params '{"pageSize": 5}'
```

## Si algo falla

Revisa permisos, API habilitadas y el procedimiento manual de OAuth del README.