Communitygithub.com

richardbowman/agent-skills

Skill de asistente personal para gestionar la bandeja de entrada de Gmail, redactar respuestas, escanear boletines informativos según intereses y preparar informes de viajes. Controla el procedimiento completo de clasificación programada de la bandeja de entrada de Gmail (incluyendo la base 'Email Action Items' de Obsidian). Úsalo al gestionar correo electrónico o automatizar flujos de trabajo de viajes/desarrollo.

¿Qué es agent-skills?

Este skill permite que un asistente de IA (Claude o Gemini) actúe como un asistente proactivo para la bandeja de entrada de Gmail de Rick y sus flujos de trabajo profesionales. Es la única fuente de verdad para el procedimiento de clasificación de la bandeja de entrada: el trabajo programado de cron simplemente invoca este skill, por lo que la lógica completa debe mantenerse aquí en lugar de duplicarse en el prompt de cron. El skill soporta las plataformas de asistente activas (Claude Code, Cursor, Codex, etc.), utilizando su conector de Gmail, solicitud de secretos seguros, herramientas de archivo/vault y programador equivalente. Si un conector requerido no está disponible, prepara un borrador/informe e identifica la capacidad faltante, sin eludir nunca las reglas de confirmación para enviar correo o cambiar el estado externo.

Compatible con✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/richardbowman/agent-skills/tree/HEAD/rb-personal-assistant

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Asistente Personal RB

Portabilidad del arnés

Usa el conector de Gmail del arnés activo, la solicitud de secretos seguros, las herramientas de archivo/vault y los equivalentes del programador. Si un conector requerido no está disponible, prepara un borrador/informe e identifica la capacidad faltante; nunca eludas las reglas de confirmación para enviar correo electrónico o cambiar el estado externo. Los encabezados de vault Claude Sessions existentes se conservan como esquema de almacenamiento, no como un requisito del arnés.

Este skill permite que un asistente de IA (Claude o Gemini) actúe como un asistente proactivo para la bandeja de entrada de Gmail de Rick y sus flujos de trabajo profesionales. Es la única fuente de verdad para el procedimiento de clasificación de la bandeja de entrada: el trabajo programado de cron simplemente invoca este skill, por lo que la lógica completa debe mantenerse aquí en lugar de duplicarse en el prompt de cron.


Clasificación de la Bandeja de Entrada de Gmail — Procedimiento Completo

Ejecuta esto siempre que se te pida clasificar la bandeja de entrada, incluyendo ejecuciones programadas/no supervisadas. Usa el CLI gws (ya en PATH). Trabaja los pasos en orden.

Constantes clave

  • Rutas de vault: cada ruta de vault a continuación es relativa al vault; el tiempo de ejecución proporciona la raíz del vault. Nunca las codifiques.
  • Etiqueta de archivo de Jarvis: Label_9220311120338883160 — para archivar, añade esta etiqueta Y elimina INBOX en la misma llamada modify.
  • Consulta de escaneo de bandeja de entrada: gws gmail +triage --query 'is:unread label:INBOX' --max 60
  • Notas de contexto: Jarvis Summaries/triage-context.md
  • Carpeta de elementos de acción: Jarvis Summaries/Action Items/
  • Base de elementos de acción (ya existe — nunca recrear): Jarvis Summaries/Email Action Items.base
  • Carpeta de resúmenes: Jarvis Summaries/
  • Notas diarias: Daily/<YYYY-MM-DD>.md
  • Advertencia de gws: los parámetros de etiqueta deben ser cadenas de texto simples, no arrays — ej. addLabelIds: "Label_9220311120338883160", removeLabelIds: "INBOX".
  • Advertencia de zsh: el shell de este entorno es zsh, no bash. for x in $VAR; do NO divide palabras en variables sin comillas en zsh (a diferencia de bash) — un bucle de múltiples IDs construido de esa manera se ejecuta una vez silenciosamente con toda la cadena como $x. Usa un array de zsh en su lugar: IDS=(id1 id2 id3); for id in "${IDS[@]}"; do .... Además, status es una variable incorporada de solo lectura en zsh — nunca nombres una variable de shell status (usa st o similar) o la asignación fallará.

PASO 0 — Leer notas de contexto

Lee el archivo de notas de contexto. Estas son notas de Rick sobre cosas que ya ha manejado o que quiere que se traten de manera diferente en esta ejecución — considéralas en cada decisión a continuación. Después de la ejecución, elimina cualquier nota en la que hayas actuado (edita la sección de Notas Pendientes). Si una nota debe convertirse en una regla permanente, agrégala a references/preferences.md en lugar de dejarla en el archivo de contexto.

PASO 0b — Desduplicar contra ejecuciones anteriores Y la Base de Elementos de Acción

  1. ls "Jarvis Summaries/Triage-$(date +%Y-%m-%d)"*.md 2>/dev/null (relativo a la raíz del vault) — si existen, léelos y extrae cada asunto/remitente ya en Acción Requerida y cada boletín ya en Destacados de Boletines.
  2. ls "Jarvis Summaries/Action Items/" y, para cualquier correo electrónico que estés a punto de marcar, verifica si existe una nota de seguimiento existente por ID de Gmail: grep -rl "gmail_id: <ID>" "Jarvis Summaries/Action Items/".

Si algo ya fue reportado hoy, o ya tiene una nota de elemento de acción abierta, no lo repitas en el resumen y no crees una nota duplicada — solo actualiza la nota existente (PASO 5b), a menos que haya información genuinamente nueva (una respuesta, una actualización, un correo electrónico diferente sobre el mismo tema).

PASO 0c — Procesar acciones pendientes de la Base

La Base de Elementos de Acción tiene una columna de casilla de verificación archive (Rick la marca en Obsidian). Antes de escanear la bandeja de entrada, busca acciones pendientes:

  1. grep -l "^archive: true" "Jarvis Summaries/Action Items/"*.md (también coincide con archive: true sin el signo de intercalación en caso de diferencias de sangría).
  2. Para cada coincidencia, lee el frontmatter de la nota. Sáltala si status ya es Done o Dismissed (ya procesada en una ejecución anterior — no hay nada que hacer).
  3. De lo contrario, archiva el correo electrónico subyacente: gws gmail users messages modify --params '{"userId": "me", "id": "<gmail_id>", "addLabelIds": "Label_9220311120338883160", "removeLabelIds": "INBOX"}'.
  4. En caso de éxito, actualiza el frontmatter de la nota: establece status: Dismissed y last_run a ahora. Deja archive: true en su lugar como registro de la acción — no lo desmarques.
  5. En caso de fallo (ej. mensaje ya eliminado), deja status como está, no lo reintentes sin fin, y anota el fallo bajo una línea Errores en el resumen de clasificación de esta ejecución (PASO 7) para que Rick lo vea.

Este paso es lo único que cierra el ciclo de la casilla de verificación — marcarla en Obsidian no hace nada al mensaje real de Gmail hasta que la próxima ejecución de clasificación programada lo recoja (cada 6h, 07:00-22:00).

PASO 0d — Envejecer elementos de seguimiento obsoletos

La Base de Elementos de Acción solo crece a menos que algo cierre activamente una nota — el PASO 0c requiere que Rick note y marque una casilla, lo que no escala (para 2026-09-18 había alcanzado 274 notas, 253 aún Open, algunas de seis semanas antes). Este paso se ejecuta en cada clasificación y cierra notas automáticamente siempre que sea seguro inferir que el elemento ya no está activo, para que la Base siga siendo una lista confiable de cosas que realmente aún necesitan la atención de Rick.

  1. Lista cada gmail_id de nota Open en Jarvis Summaries/Action Items/.
  2. Obtén el conjunto actual de IDs de la bandeja de entrada completa (no solo no leídos): gws gmail users messages list --params '{"userId": "me", "q": "in:inbox", "maxResults": 500}'. Si la respuesta incluye nextPageToken, repite con pageToken configurado hasta que se detenga, para que se cubra la bandeja de entrada completa (rutinariamente supera los 500).
  3. Cierra cualquier nota Open cuyo gmail_id ya no esté en ese conjunto. Si el correo electrónico subyacente ya no está en la bandeja de entrada, Rick (o algo más) ya lo manejó fuera de este flujo — la nota está huérfana. Establece status: Dismissed, deja archive: false (nada más que archivar), y añade una línea al cuerpo de la nota: **Auto-cerrado <fecha de hoy>:** el correo electrónico subyacente ya no está en la bandeja de entrada — resuelto fuera del flujo de clasificación. No toques notas cuyo correo electrónico aún esté en la bandeja de entrada; esas aún necesitan una revisión humana.
  4. Envejece el ruido específico de categoría para notas aún en la bandeja de entrada:
    • CI/CD: si first_seen tiene más de 5 días y la nota nunca ha sido actualizada a In Progress/Done por Rick, trátala como obsoleta (los fallos de CI siempre son reemplazados por la siguiente ejecución o una revisión directa del repositorio — una nota de seguimiento de una semana no tiene valor informativo). Archiva el correo electrónico (etiqueta Jarvis) y establece status: Dismissed, anotando **Auto-cerrado <fecha>:** aviso de CI/CD no resuelto después de 5+ días, tratado como obsoleto — revisa el repositorio directamente si aún es relevante.
    • Appointment: si due_date (o email_date cuando no hay due_date) está en el pasado, la cita ya ocurrió o pasó — archiva el correo electrónico y descarta con **Auto-cerrado <fecha>:** la fecha de la cita ha pasado.
    • Avisos de envío/entrega archivados bajo Other (el asunto coincide con "package"/"delivery"/"shipped"/"on the way"): si tienen más de 10 días de antigüedad, archiva y descarta con **Auto-cerrado <fecha>:** la ventana de envío ha transcurrido. (Mejor: según el PASO 5b, archívalos ya cerrados en el momento de la creación para que esto nunca tenga que atrapar uno — ver nota allí.)
    • Deja Billing, Security, Compliance, Invoice, Benefits, Opportunity, Solar, SEO y Account solos aquí — esas categorías pueden implicar dinero real, plazos o juicios, por lo que solo se aplica la verificación de presencia en la bandeja de entrada del paso 3; nunca los envejezcas por tiempo.
  5. Reporta conteos, no una lista por elemento, en el resumen de clasificación (PASO 7) — ej. Mantenimiento: cerradas 14 notas obsoletas (9 ya no en la bandeja de entrada, 4 CI/CD envejecidos, 1 cita vencida). Una lista detallada completa no es una señal útil; el conteo confirma que la limpieza se ejecutó.

PASO 1 — Escanear mensajes no leídos

Ejecuta la consulta de escaneo de la bandeja de entrada anterior. (Nota: gws gmail +triage simple sin consulta por defecto es is:unread en toda la bandeja de entrada, limitado a 20 — se pierde el backlog real de la bandeja de entrada porque los correos ya archivados pero aún no leídos desplazan los elementos reales de la bandeja de entrada. Siempre pasa la consulta explícita label:INBOX para que esto escanee la bandeja de entrada real.)

PASO 2 — Archivar ruido rutinario

Archiva (etiqueta jarvis + eliminar INBOX): TestFlight / GitHub / Vercel éxitos, promociones de Experian, TaxSlayer, Alertas de Seguridad de Google para cuentas conocidas. También archiva boletines después de resumir sus aspectos destacados (PASO 4) — no los dejes en la bandeja de entrada.

PASO 3 — Avisos de construcción / condominio

Mueve los correos electrónicos de la Asociación de Condominios / edificio a la etiqueta Home.

PASO 4 — Boletines informativos

Escanea boletines (WBEZ, Block Club, City Cast, etc.) en busca de fragmentos que coincidan con los intereses de Rick: carnes ahumadas, pan, ciclismo, automatización del hogar, Linux, local de SW Michigan, viajes a Costa Rica / Portugal (mapa de intereses completo en references/preferences.md). Resume cualquier acierto, luego archiva el boletín (etiqueta jarvis). OMITE cualquier boletín ya resumido hoy (PASO 0b) — solo archívalo silenciosamente.

PASO 5 — Marcar Acción Requerida

Marca: facturas de contactos prioritarios, alertas de producción / facturación / seguridad, plazos de cumplimiento / atestación, preparación de citas y oportunidades remuneradas. Omite cualquier cosa que las notas de contexto digan que Rick ya manejó. OMITE cualquier cosa ya reportada hoy o ya rastreada por una nota de elemento de acción abierta (PASO 0b), a menos que haya información genuinamente nueva. Las notificaciones de envío/seguimiento puras ("su pedido ha sido enviado") se reportan una vez, luego se archivan — archiva su nota de seguimiento como ya cerrada (status: Dismissed, archive: true) en el momento de la creación en el PASO 5b en lugar de Open, ya que no hay acción de seguimiento para que una notificación de envío espere. Dejar estas Open es exactamente el tipo de nota que el PASO 0d tiene que limpiar más tarde sin razón.

PASO 5b — Mantener la Base de Elementos de Acción

Para cada elemento marcado en el PASO 5, asegúrate de que esté rastreado como una nota en la carpeta Action Items para que aparezca en la Base Email Action Items. El archivo Base ya existe — NO lo recrees.

  • Desduplica por gmail_id (PASO 0b). Si existe una nota con ese id: solo actualiza last_run (y last_seen) a la ejecución actual — NO sobrescribas status (Rick lo gestiona manualmente) y NO dupliques. Si el estado de la nota existente es Done o Dismissed, déjala cerrada; no la reabras ni la vuelvas a marcar.
  • Si no existe ninguna nota, crea una. Nombre de archivo: <Remitente> - <asunto corto>.md (elimina caracteres no válidos para nombres de archivo: / \ : etc.). Esquema de frontmatter:
---
type: email-action
status: Open            # Open | In Progress | Done | Dismissed  (Rick edita esto en Obsidian)
archive: false          # Rick marca esta casilla en la Base para archivar el correo electrónico + cerrar el elemento (PASO 0c)
priority: High          # High | Medium | Low
priority_rank: 1        # 1=High, 2=Medium, 3=Low  (impulsa el orden de clasificación)
category: Billing       # Billing | Invoice | Security | Compliance | CI/CD | Account | Benefits | Appointment | Opportunity | Solar | SEO | Other
sender: "Vercel"
subject: "..."
email_date: YYYY-MM-DD  # fecha en que se recibió el correo electrónico
due_date:               # opcional; solo si el correo electrónico indica una fecha de vencimiento
gmail_id: <id hex de gws>
gmail_link: https://mail.google.com/mail/u/0/#all/<id hex>
first_seen: YYYY-MM-DD  # hoy
last_run: YYYY-MM-DD-HH-MM
---

Cuerpo: un H1 # <Remitente> — <asunto>, una descripción de 1 a 2 oraciones de la acción necesaria, y una línea **[Abrir en Gmail](<gmail_link>)**. El id hex de gmail_link es el mismo id de mensaje/hilo hex que gws devuelve — es el enlace permanente web de Gmail.

  • Asigna la prioridad de manera sensata: High = dinero en riesgo / producción caída / plazo estricto (fallos de facturación, pagos vencidos, brechas de seguridad, atestaciones de cumplimiento); Medium = necesita una decisión o respuesta pronto (facturas, fallos de CI, configuración de cuenta, citas, oportunidades remuneradas); Low = informativo pero procesable (estados de cuenta, auditorías SEO, empujones de marketing).

PASO 6 — Retención de viajes

NO archives correos electrónicos de viajes (Marriott, AC Hotels, UPS, aerolíneas) hasta que se confirme que el viaje ha terminado. Ver Reporte de Viajes y Viajes a continuación.

PASO 7 — Escribir el resumen de clasificación

Escribe en Jarvis Summaries/Triage-<YYYY-MM-DD-HH-MM>.md con secciones: Acción Requerida, Destacados de Boletines, Archivado, Mantenimiento. Bajo Acción Requerida, nota que los elementos también están rastreados en la Base [[Jarvis Summaries/Email Action Items.base|Email Action Items]]. Si el PASO 0c procesó alguna acción de casilla de verificación, añade una línea Archivado vía Base listándolas, y una línea Errores para las que fallaron. Bajo Mantenimiento, reporta los conteos de cierre del PASO 0d. Si no se encontró nada nuevo, escribe una breve nota "No hay nuevos elementos desde la última ejecución" (el mantenimiento del PASO 0d aún se ejecuta y se reporta) y detente.

PASO 8 — Vincular en la nota diaria

Añade un wikilink al archivo de resumen en Daily/<YYYY-MM-DD>.md bajo una sección ## Claude Sessions (crea la sección si falta).

Ejecuciones programadas/no supervisadas: completa el PASO 0–8 y detente — no es necesario publicar el resumen en ningún otro lugar.


Reporte de Viajes y Viajes

  • Identificar: Rastrea correos electrónicos de hoteles (Marriott, AC Hotels), vuelos y envíos (UPS).
  • Flujo de trabajo: (Futuro) Verificar el calendario para correlacionarlos en un solo "Informe de Viaje".
  • Acción: No archivar recibos/información de viajes hasta que el viaje haya concluido.

Protocolo de Respuesta

  • Contactos Prioritarios: (ej. contratista de HVAC) Redactar respuestas cortas y corteses a facturas o consultas.
  • Seguridad: Nunca autorizar pagos ni hacer clic en enlaces financieros sin confirmación explícita de Rick.

Crear Borradores de Gmail (con o sin archivos adjuntos)

El CLI gws no puede manejar cargas grandes como argumentos de línea de comandos. Usa la receta de Python a continuación, que descifra las credenciales de gws directamente y llama a la API de Gmail.

Borrador solo texto:

import base64, json, subprocess
from email.mime.text import MIMEText

# Obtener token de acceso fresco
from cryptography.hazmat.primitives.ciphers.aead import AESGCM
key = base64.b64decode(subprocess.run(['security', 'find-generic-password', '-s', 'gws-cli', '-w'], capture_output=True, text=True).stdout.

…

[truncado para traducción]

Skills relacionados