inbox-triage

Descripción general de inbox-triage skill

Qué hace inbox-triage

inbox-triage es una skill de automatización de flujos de trabajo de email para ejecutar una revisión estructurada de la bandeja de entrada a partir de una base de conocimiento personal de correo ya existente. Busca correos recientes, clasifica mensajes según tu taxonomía, identifica nuevos remitentes, recomienda acciones, redacta respuestas y guarda los aprendizajes del triage en ${WORKSPACE}/Email/.

El detalle más importante para adoptarla: funciona en conjunto con inbox-setup. La skill inbox-triage espera la base de conocimiento de 7 archivos que crea la configuración, incluidos email-taxonomy.md, email-patterns.md, blocklist.md, tracker.md, archivos de decisión opcionales y un directorio triage-log/.

Usuarios y flujos de trabajo ideales

Esta skill encaja con usuarios que quieren hacer triage de email de forma recurrente 1–3 veces al día, o contar con un flujo fiable de “revisa mi bandeja de entrada” bajo demanda sin tener que volver a explicar sus preferencias cada vez. Es especialmente útil para fundadores, consultores, creadores, operadores y profesionales con mucho volumen de correo que reciben una mezcla de oportunidades, conversaciones activas, newsletters, mensajes comerciales en frío y seguimientos.

Usa inbox-triage para Workflow Automation cuando el objetivo no sea solo resumir, sino apoyar decisiones: clasificar, recomendar, redactar, registrar y actualizar memoria.

Diferenciadores clave

El diferenciador práctico es su modelo de automatización con prioridad en la seguridad. La skill solo crea borradores y deja explícito que nunca envía emails. El repositorio incluye references/drafts_only_safety.md y scripts/draft_safety_validator.py, que revisa los registros de acciones en busca de llamadas con forma de envío.

También incluye utilidades deterministas: kb_reader.py valida la base de conocimiento requerida antes del triage, y search_window_calculator.py calcula una ventana retrospectiva según la cadencia.

Cuándo esta skill no es la opción adecuada

No instales inbox-triage como prompt independiente si no has ejecutado inbox-setup o no has creado los archivos esperados en ${WORKSPACE}/Email/. Tampoco es una buena opción si buscas envíos totalmente autónomos, resúmenes puntuales e informales de email, o un sistema que ignore la taxonomía y el estilo de respuesta específicos del usuario.

Cómo usar inbox-triage skill

Contexto de instalación de inbox-triage

Instala la skill desde el repositorio de skills en GitHub con:

npx skills add alirezarezvani/claude-skills --skill inbox-triage

Luego confirma que tu agente pueda acceder a la ruta de la skill:

productivity/email/skills/inbox-triage

Antes de la primera ejecución, revisa SKILL.md y después lee references/kb_file_contract.md, references/drafts_only_safety.md y references/triage_decision_framework.md. Para entender el comportamiento de validación, revisa scripts/kb_reader.py, scripts/search_window_calculator.py y scripts/draft_safety_validator.py.

Entradas necesarias antes de usarla

La skill necesita un workspace que contenga ${WORKSPACE}/Email/. Como mínimo, los archivos requeridos son email-taxonomy.md, email-patterns.md, blocklist.md y tracker.md; triage-log/ debe existir como directorio. evaluation-framework.md y rate-card.md mejoran la calidad de las decisiones para oportunidades, precios, VIPs y señales de aceptar o descartar.

Si la KB falta o tiene un formato incorrecto, el comportamiento previsto es detenerse y pedir al usuario que ejecute primero /cs:inbox-setup. Este comportamiento de fallo rápido evita que el agente invente reglas de triage.

Prompts eficaces para invocar bien la skill

Un prompt débil sería: “Check my email.”

Un prompt más sólido para usar inbox-triage sería: “Run inbox-triage for my normal 2x-daily cadence. Use my existing ${WORKSPACE}/Email/ knowledge base, search only the current window, classify new messages, draft replies but do not send anything, update tracker.md and blocklist.md where appropriate, and give me the report in my preferred format.”

Para ejecuciones bajo demanda, incluye la anulación explícita: “Run inbox-triage for the last 24 hours because I missed the morning pass. Do not skip opportunity emails. Draft replies only.”

Flujo de trabajo práctico para la primera ejecución

Empieza con una ejecución en seco y supervisada. Pide al agente que valide la KB, calcule la ventana de búsqueda, enumere las categorías previstas y confirme que no se usará ninguna acción de envío. Después deja que procese los mensajes, cree borradores y genere el informe de triage.

Tras el informe, revisa tres cosas: emails mal clasificados, borradores que no suenan como tú y cualquier actualización escrita en tracker.md o blocklist.md. Estas correcciones tienen mucho impacto porque las futuras ejecuciones dependen de la base de conocimiento.

Preguntas frecuentes sobre inbox-triage skill

¿inbox-triage envía emails?

No. La regla central de seguridad es solo borradores. La skill está diseñada para redactar respuestas que el usuario pueda revisar, no para enviarlas. El validador incluido puede escanear un registro de acciones de triage en busca de operaciones similares a envíos, como llamadas de envío de Gmail u Outlook, y hacer fallar la ejecución si aparecen.

¿En qué mejora a un prompt normal de email?

Un prompt genérico puede resumir correos, pero normalmente no tiene memoria estable, reglas por remitente, ventanas según cadencia, disciplina de seguridad basada en borradores ni un marco repetible de recomendación. La skill inbox-triage lee un contrato de KB definido, usa una taxonomía, aplica decisiones TAKE IT / WORTH CONSIDERING / PASS / FLAG FOR REVIEW y registra los resultados.

¿inbox-triage es apta para principiantes?

Es apta para principiantes solo después de la configuración. Si te sientes cómodo ejecutando un instalador de skills y permitiendo que un agente acceda a herramientas de email y archivos del workspace, el uso diario es sencillo. El principal bloqueo inicial es la dependencia de inbox-setup y de la estructura exacta de archivos en ${WORKSPACE}/Email/.

¿Qué ecosistemas de email puede admitir?

La skill está escrita en torno al comportamiento de herramientas de email, no a un único proveedor. La referencia de seguridad menciona operaciones de tipo borrador para Gmail y Outlook/Microsoft Graph. El éxito real depende de si tu entorno de agente tiene permisos para buscar, leer y crear borradores de email sin permisos de envío.

Cómo mejorar inbox-triage skill

Mejorar los resultados de inbox-triage con mejores archivos de KB

La forma más rápida de mejorar inbox-triage es hacer que email-taxonomy.md y email-patterns.md sean más específicos. Añade ejemplos de newsletters que deben omitirse, VIPs que deben destacarse, oportunidades que conviene evaluar y conversaciones que requieren respuesta el mismo día. Añade reglas de voz como “short, warm, no exclamation marks” o “include pricing only when asked.”

Si el triage de oportunidades es importante, mantén actualizados evaluation-framework.md y rate-card.md. Estos archivos reducen las recomendaciones vagas de “quizás” y ayudan a que los borradores incluyan próximos pasos concretos, postura de precios o preguntas aclaratorias.

Corregir fallos habituales

Si la skill redacta demasiados borradores, ajusta las señales PASS y las reglas de blocklist.md. Si se le escapan conversaciones importantes, amplía las señales de conversaciones activas y las entradas de VIPs. Si los borradores son demasiado genéricos, añade ejemplos reales de respuestas aceptadas y rechazadas a email-patterns.md.

Si la ventana de búsqueda es incorrecta, revisa los valores de cadencia usados por search_window_calculator.py: una vez al día usa un solapamiento más amplio, mientras que 2x y 3x al día usan ventanas más cortas. Para sesiones de puesta al día inusuales, proporciona una anulación explícita en horas.

Iterar después del primer informe

Después de cada ejecución, marca qué recomendaciones fueron correctas, qué borradores enviaste después de editarlos y qué mensajes deberían haberse omitido. Pide al agente que convierta ese feedback en actualizaciones de la KB en lugar de tratarlo como contexto temporal de chat.

Un prompt de seguimiento útil: “Review the last inbox-triage report. Update my taxonomy so emails like X are classified as PASS, add sender Y to VIP, and adjust my draft style to be shorter for cold outreach. Do not change send safety rules.”

Mantener exigibles la seguridad y el registro

Para uso programado, mantén visible la regla de solo borradores en los prompts y los registros. Ejecuta o inspecciona draft_safety_validator.py si tu entorno admite registros de acciones. Mantén triage-log/ organizado porque proporciona la pista de auditoría de lo que se buscó, se redactó, se omitió y se aprendió.