Source: https://once-email.com/es/skill

Documentación para desarrolladores

Documentación para desarrolladores Skill

# 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

[Descargar el Skill abierto](<https://once-email.com/downloads/test-email-flows-0.1.0-private.2.zip>) [Revisar código en GitHub](<https://github.com/pangxin12345/once-email-sdks/tree/main/skills/test-email-flows>)

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.

## Disponibilidad actual

El Skill test-email-flows se ofrece como paquete preliminar versionado. El código es público y la API sigue controlada. 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.

Prompt + Demo

## Prompts seguros y demo autorizado

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

[Abrir prompts](<https://github.com/pangxin12345/once-email-sdks/blob/main/demos/skill/PROMPTS.md>) [Abrir demo](<https://github.com/pangxin12345/once-email-sdks/blob/main/demos/skill/DEMO.md>)

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.

[Descargar paquete](<https://once-email.com/downloads/test-email-flows-0.1.0-private.2.zip>) [SHA256SUMS](<https://once-email.com/downloads/SHA256SUMS>)

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.

[Ver código público](<https://github.com/pangxin12345/once-email-sdks>) [Leer guía práctica](<https://once-email.com/es/blog/temporary-email-api-testing-guide>)