agentleFS
sergi-rzsergi-rz/claudia-os/.claude/skills/claudia-calendar/SKILL.md

claudia-calendar

Skill39 starsChanged 7 months agoMITView on GitHub

Consulta y gestiona Google Calendar (lectura, creación, modificación y borrado de eventos). Usar cuando el usuario pregunte por su agenda, quiera crear/mover citas, o cualquier operación de calendario.

  • Reads credentials

The file

Files
SKILL.md

Calendar — Google Calendar

Acceso a Google Calendar via Google Apps Script desplegado como Web App (lectura + escritura).

Personalización: antes de ejecutar, lee user/behavior.md en 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.

Lectura

python3 .claude/skills/claudia-calendar/fetch_calendar.py --days 1          # eventos de hoy
python3 .claude/skills/claudia-calendar/fetch_calendar.py --days 7 --raw    # próximos 7 días (JSON)
python3 .claude/skills/claudia-calendar/fetch_calendar.py --calendars        # listar calendarios disponibles

Escritura

# Crear evento
python3 .claude/skills/claudia-calendar/fetch_calendar.py --action create \
  --calendar "email@gmail.com" --title "Dentista" \
  --start "2026-03-25T10:00" --end "2026-03-25T11:00"

# Evento de día completo
python3 .claude/skills/claudia-calendar/fetch_calendar.py --action create \
  --title "Vacaciones" --start "2026-04-01" --all-day

# Modificar
python3 .claude/skills/claudia-calendar/fetch_calendar.py --action update \
  --event-id "ID" --calendar "email@gmail.com" --title "Nuevo título"

# Borrar
python3 .claude/skills/claudia-calendar/fetch_calendar.py --action delete \
  --event-id "ID" --calendar "email@gmail.com"

Aliases

Fichero compartido: user/config/settings.json (key calendar_aliases, el mismo que usa Gmail). Mapea identificadores (emails o IDs de calendario) a nombres cortos. Se usan tanto en la salida (mostrar alias en vez del ID) como en --calendar (resolver alias a ID).

En Google Calendar, una misma cuenta puede tener varios calendarios:

  • Calendario principal: su ID es el email de la cuenta (ej: usuario@gmail.com)
  • Calendarios creados (ej: "Familia", "Deporte"): tienen IDs opacos tipo abc123@group.calendar.google.com
  • Calendarios compartidos: su ID es el email de quien lo comparte
{
  "usuario@gmail.com": "Yo",
  "pareja@gmail.com": "Pareja",
  "abc123@group.calendar.google.com": "Familia"
}

Configuración asistida de aliases

Tras completar el setup, ofrece al usuario configurar aliases:

  1. Ejecuta fetch_calendar.py --days 7 --raw para obtener eventos con sus calendarId
  2. Extrae los calendarIds únicos de los eventos
  3. Muestra al usuario la lista: "He encontrado estos calendarios: [lista con ID y nombre]. ¿Qué alias quieres para cada uno?"
  4. Con las respuestas, escribe la key calendar_aliases en user/config/settings.json (o actualiza si ya existe, respetando entradas previas de Gmail u otras skills)

Setup (primera vez)

Esta skill conecta con Google Calendar via un Apps Script desplegado como Web App.

  1. Ve a https://script.google.com y crea un nuevo proyecto
  2. Copia el contenido de apps-script.js (incluido en esta skill) al editor
  3. Despliega como Web App: Deploy → New deployment → Web app → Execute as "Me" → Anyone with link
  4. Copia la URL del deployment
  5. Añádela a user/credentials/.env:
    CALENDAR_WEBAPP_URL=https://script.google.com/macros/s/.../exec

Apps Script

apps-script.js contiene el código desplegado en Google Apps Script. Tras modificarlo, copiar a script.google.com y redesplegar (nueva versión).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.