Communitygithub.com

pyai-narration

Crea narraciones expresivas, dirigidas o multilínea a partir de un guión utilizando PyAI Cast, incluyendo voces compatibles, pausas y emociones.

¿Qué es pyai-narration?

Esta habilidad permite a un agente de IA, como Claude Code o Cursor, generar narraciones de audio expresivas a partir de un guión de texto utilizando el sistema PyAI Cast. El agente puede consultar las voces y direcciones de narración disponibles, estructurar el guión respetando las asignaciones de hablantes y el texto original del usuario, y generar la narración completa o una vista previa de una línea específica. La habilidad maneja tanto la generación síncrona como asíncrona: en el modo asíncrono, el agente conserva el ID del trabajo para consultar su progreso y recuperar el audio final. Es útil para desarrolladores que desean integrar narración de voz realista en sus aplicaciones o demostraciones, evitando generar variantes innecesarias y respetando los límites de uso. Funciona en plataformas que soportan herramientas PyAI y se comunica con el servidor a través de esquemas de herramientas definidos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/atomsai/pyai-plugin/tree/main/skills/pyai-narration

Preguntar en tu IA favorita

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

Documentación

Narración

Usa los esquemas de herramientas de PyAI conectados como fuente de verdad; los clientes pueden prefijar los IDs de herramientas con el nombre del servidor. Si PyAI está desconectado, dirige al usuario al inicio de sesión en el navegador del host. Mantén las credenciales fuera del chat. Respeta el proyecto seleccionado y la tarea autorizada del usuario.

Herramientas: whoami, get_cast_capabilities, direct_cast_script, preview_cast_line, render_cast, get_cast_render, get_cast_audio

Lee get_cast_capabilities para conocer las voces disponibles y las direcciones compatibles. Usa direct_cast_script para estructurar el guión proporcionado cuando sea necesario, conservando la redacción prevista por el usuario y las asignaciones de hablantes.

Usa preview_cast_line para una muestra solicitada, o render_cast para la narración completa solicitada. Tanto la generación de medios como las vistas previas pueden consumir uso; no generes variantes adicionales solo para demostrar la integración.

Para representaciones asíncronas, conserva el ID del trabajo original y consulta get_cast_render; no vuelvas a enviar trabajos pendientes. Recupera los medios completados a través de get_cast_audio y devuelve el audio/enlace real. Informa el ID y el estado de una representación incompleta cuando se alcanza el límite de espera de la tarea. No inventes emociones, voces u opciones de representación no compatibles.

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

Skills relacionados