Documentación para desarrolladoresSkill

Skill de Once Email

Deja de reescribir esperas frágiles en cada prueba

Añade un flujo revisado a una aplicación propia o autorizada: comprueba requisitos, planifica, espera con plazo, exige una coincidencia, devuelve evidencia oculta y limpia siempre.

Skill preliminar de código abierto disponible

Qué resuelve

Antes: cada proyecto reescribe sondeo, coincidencia, errores y limpieza.

Con el Skill: doctor, plan, una prueba acotada y recuperación explícita.

Después: CI recibe una causa oculta y útil, no solo “correo no encontrado”.

Tres flujos autorizados comunes

Código de verificación

Enlace de confirmación

Notificación y entrega

doctor → plan → run → cleanup

$test-email-flows
doctor
plan
ejecutar un flujo autorizado
exigir cleanup=cleaned

Ámbito seguro

Crear un buzón aislado, consultar con plazo, validar y eliminar.

Datos fuera del modelo

Claves, direcciones, códigos, enlaces, cuerpos y adjuntos no entran en prompts ni registros.

Responsabilidad del Skill

Orquesta operaciones revisadas y devuelve solo resultados redactados.

Resultado confiable

Distingue tiempo, ambigüedad, aserción y limpieza; devuelve solo evidencia redactada.

Flujo recomendado

  1. Continúa solo con acceso a la API expresamente autorizado y credenciales válidas ya emitidas con los permisos mínimos necesarios. Guárdalas en un mecanismo de secretos del proceso; sin ese acceso, limítate a revisar documentación y descargas.
  2. Crear un buzón por prueba.
  3. Activar correo desde el sistema autorizado.
  4. Consultar con plazo.
  5. Devolver solo resultado redactado.
  6. Eliminar siempre el buzón.

Prompt + Demo

Prompts seguros y demo autorizado

No pegues claves, direcciones, códigos, enlaces ni mensajes.

Guía de uso completa

Descargar paquete local versionado

Úsalo solo con aplicaciones propias o autorizadas. Once Email solo recibe correo.

Documentación y código públicos; API controlada y descargas preliminares fuera de registros. La documentación pública y las descargas preliminares no conceden acceso a la API. La creación de claves API y las llamadas reales no están abiertas al público.

Verifica SHA256SUMS antes de extraer.

Punto de inicio local exacto

unzip test-email-flows-0.1.0-private.2.zip

De la descarga a la limpieza

  1. Descarga el Skill completo y verifica la suma.
  2. Instala toda la carpeta test-email-flows.
  3. Recarga el agente y confirma que el Skill aparece.
  4. Mantén clave y correo fuera del chat; ejecuta doctor y plan.
  5. Continúa solo con acceso a la API expresamente autorizado y credenciales válidas ya emitidas con los permisos mínimos necesarios. Guárdalas en un mecanismo de secretos del proceso; sin ese acceso, limítate a revisar documentación y descargas. Ejecuta un flujo sin trazas, vídeo ni capturas.
  6. Exige cleanup=cleaned y no abras el diario 0600.

Errores y recuperación

Distingue 400/401/403/404/413/429/503, tiempo agotado, ambigüedad, extracción, aserción y limpieza. Reintenta solo dentro de un plazo.