القائمة
Lee, busca, organiza, crea borradores y envía correos en Gmail. Usar cuando el usuario pida revisar correo, buscar emails, crear borradores o gestionar su bandeja.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | claudia-gmail |
| description | Lee, busca, organiza, crea borradores y envía correos en Gmail. Usar cuando el usuario pida revisar correo, buscar emails, crear borradores o gestionar su bandeja. |
| scope | core |
| user-invocable | true |
| argument-hint | [listar|buscar|leer|borrador|...] |
Gmail API v1 con OAuth2 scope gmail.modify (leer, organizar, borradores, envío).
Personalización: antes de ejecutar, lee
user/behavior.mden este directorio. Si tiene contenido, aplícalo como ajustes sobre el comportamiento de esta skill — en caso de conflicto con lo definido aquí, prevalece lo del usuario.
Siempre con el venv de la skill (si existe) o python3 del sistema:
python3 .claude/skills/claudia-gmail/gmail.py --account personal --action list [--max 20] [--unread]
python3 .claude/skills/claudia-gmail/gmail.py --account personal --action read --id <message_id>
python3 .claude/skills/claudia-gmail/gmail.py --account personal --action search --query "from:juan"
python3 .claude/skills/claudia-gmail/gmail.py --account personal --action draft --to "a@b.com" --subject "Re: X" --body "Hola..."
python3 .claude/skills/claudia-gmail/gmail.py --account personal --action archive --id <message_id>
python3 .claude/skills/claudia-gmail/gmail.py --account personal --action label --id <message_id> --label "Clientes"
python3 .claude/skills/claudia-gmail/gmail.py --action accounts
Fichero compartido: user/config/settings.json (key calendar_aliases, el mismo que usa Calendar). Mapea emails a nombres cortos. En listados y búsquedas, el remitente se muestra con el alias en vez de la dirección completa.
{
"juan@example.com": "Juan",
"contabilidad@empresa.com": "Gestoría",
"noreply@github.com": "GitHub"
}
El campo message_id_header solo aparece al leer un correo concreto (necesario para reply-to), no en listados.
Tras completar el setup de Gmail, ofrece al usuario configurar aliases:
gmail.py --account <cuenta> --action list --max 20 para ver remitentes recientesfromcalendar_aliases en user/config/settings.json (o actualiza si ya existe, respetando entradas previas de Calendar u otras skills)--action send está disponible en el código, pero nunca lo uses sin cumplir las dos condiciones:
user/context/constraints.md lo autoriza explícitamente para el contexto actual (p.ej. briefings automáticos, intake) o el usuario lo confirma en la conversación.--action draft) y pide al usuario que lo revise y envíe desde Gmail. Los borradores siempre son reversibles; un send no.--action accountsGmail usa OAuth2, no API keys simples. La configuración tiene dos pasos:
user/credentials/gmail/credentials.jsonpython3 .claude/skills/claudia-gmail/auth.py personal
auth.py arranca un servidor loopback en 127.0.0.1:<puerto>, abre el navegador y captura el código de Google automáticamente (flujo oficial "Installed App" de Google). El token queda guardado en user/credentials/gmail/tokens/personal.json.
En un VPS sin entorno gráfico, abre antes un túnel SSH hacia un puerto fijo desde tu máquina local:
ssh -L 8765:127.0.0.1:8765 usuario@tu-servidor
# y en el servidor:
python3 .claude/skills/claudia-gmail/auth.py personal --port 8765 --no-browser
Copia la URL impresa y ábrela en el navegador local. La redirección http://127.0.0.1:8765/?code=… llegará al servidor remoto por el túnel.
Puedes autorizar varias cuentas con nombres distintos:
python3 .claude/skills/claudia-gmail/auth.py trabajo
pip install google-auth google-auth-oauthlib google-api-python-client
Sin credentials.json, el script auth.py mostrará instrucciones al ejecutarse.
Automatiza facturas de compra de proveedores en Holded: lee correos etiquetados en Gmail, extrae los datos del PDF, comprueba duplicados y crea la compra en Holded (con PDF adjunto). Ante cualquier duda no sube y lo pregunta en el chat. Usar cuando el usuario pida procesar/subir facturas de proveedor.
Sincroniza el corpus de contenido publicado de un workspace (YouTube, Substack) con lo que hay en local. Útil para creadores que mantienen un archivo local de sus propias piezas publicadas.
Pipeline de captura, procesamiento y entrega de contenido. Encola URLs, extrae wisdom en batch, genera briefing diario dual (Telegram + email).
Bot de Telegram para comunicación bidireccional usuario ↔ Claudia. Gestión del proceso PM2, watchdog, briefing y recordatorios. Usar cuando haya que gestionar, debuggear o modificar el bot.
Análisis de gastos familiares: importa extractos bancarios, categoriza movimientos con reglas, enriquece con detalle de merchants, y genera dashboards.
Captura tareas, recordatorios e ideas desde cualquier canal (Telegram, Siri, conversación directa). Detecta la intención del usuario y guarda en el fichero correspondiente de user/workspaces/_me/notes/ con el formato adecuado. Úsala cuando el usuario diga "anota", "apunta", "recuérdame", "que no se me olvide", "un cliente me ha pedido", "tengo una idea", o cuando consulte sus tareas/ideas pendientes.