Convertir PDF a SCORM con Copilot: la skill paso a paso

He montado en Agent Builder, dentro de Microsoft 365 Copilot, una skill que convierte un PDF corto en un curso SCORM con objetivos y evaluación. La IA decide el contenido y tú lo validas; una plantilla y un script fijos hacen la parte técnica, siempre igual. Aquí van las piezas, los pasos, cuándo no compensa y el prompt para que tu Copilot te la fabrique.

Le pasé a Copilot un PDF de cumplimiento, de esos que hay que virtualizar a menudo, y le pedí que me hiciera una presentación interactiva con preguntas. Y después, un SCORM.

Lo hizo. Y lo hizo bien, que es lo que me descolocó.

Luego me vino la pregunta de verdad. ¿Y el siguiente PDF? Si cada vez se lo pido con otras palabras, cada vez sale otra cosa, un día la navegación en otro sitio, otro día un manifest que la plataforma no traga. Yo no quería revisar código cada vez. Quería que saliera igual.

Así que lo convertí en una skill dentro de un agente. Ya te adelanto cómo acaba: funciona. La he probado en SCORM Cloud y estoy muy contenta con cómo queda. Todavía no la hemos subido a la plataforma del cliente, eso sí.

¿Por qué no basta con pedírselo cada vez?

Porque una IA es muy buena decidiendo contenido y bastante irregular escribiendo dos veces lo mismo.

Qué va en cada diapositiva, qué pregunta tiene sentido, qué feedback explica el porqué. Eso lo hace bien, y es lo que cambia de un curso a otro. El HTML y el fichero que habla con la plataforma deberían ser idénticos siempre, y ahí improvisar sale caro.

La solución es repartir el trabajo. La IA no escribe HTML. Escribe un fichero de datos, un JSON, con los textos de las diapositivas, los objetivos y las preguntas. Un script que no cambia nunca coge ese fichero, lo mete en una plantilla que tampoco cambia y empaqueta el SCORM.

Tú revisas contenido, no código.

La idea de separarlo así salió de una conversación con Claude, cuando le pregunté si el agente de Copilot iba a poder con tantas fases. Me contestó que el número de fases no era el problema. Tenía razón.

¿Qué necesitas antes de empezar?

Agent Builder viene con la licencia de Microsoft 365 Copilot. Por eso la monté ahí y no en Copilot Studio, que no tiene todo el mundo.

Ahora, ojo: las skills todavía no vienen para todos. Según la documentación de Microsoft, están en preview y solo las tienen las organizaciones inscritas en Frontier, su programa de acceso anticipado. Si no ves el apartado de skills al configurar el agente, es por eso, y quien lo resuelve es tu IT.

Además, el agente tiene que poder crear archivos, lo que Microsoft llama intérprete de código («Create documents, charts, and code»). Y las skills no funcionan en organizaciones que usan las barreras de información de Purview.

¿Qué piezas lleva la skill?

Una skill de Agent Builder es una carpeta comprimida. Dentro va un fichero de instrucciones, el SKILL.md, y todo lo que esas instrucciones necesiten para funcionar. La mía lleva cuatro piezas, y el prompt que dejo al final le pide a Copilot exactamente esas:

Pieza	Qué hace	Quién la toca
SKILL.md	El procedimiento: fases, reglas de traducción, diseño instruccional y cuándo parar a validar	Tú, una vez
Plantilla HTML	Diseño, navegación, evaluación y comunicación con la plataforma	Tú, una vez, para ponerle tu marca
Script de empaquetado	Valida el contenido, lo mete en la plantilla y crea el .zip con su manifest	Nadie
JSON de ejemplo	Le enseña al agente el formato exacto del contenido	Nadie
JSON del curso	Textos, objetivos y preguntas de cada PDF	El agente, cada vez. Tú lo validas

Comprobado en Agent Builder en octubre de 2026.

La plantilla es la que lleva tu marca. Para hacer la mía le subí a Copilot la guía de marca y le pedí la plantilla a partir de ella. El prompt le pide además que deje los colores y la tipografía juntos al principio del fichero, para cambiarlos en un minuto sin tocar nada más.

El script hace algo más que empaquetar. Antes de generar nada comprueba el contenido, y si una pregunta no está atada a ningún objetivo, o un objetivo se queda sin pregunta que lo evalúe, se niega a crear el paquete y le dice al agente qué corregir. Es el control de calidad del diseño instruccional, metido en el código.

¿Dónde entra el diseño instruccional?

La primera versión que me montó Copilot no tenía ni una gota. Traducía, maquetaba, ponía preguntas y empaquetaba. Rápido y vacío.

Para piezas de menos de diez diapositivas no hace falta un briefing largo. Me quedé con lo mínimo que hace que un curso sea un curso:

1. El colectivo. Es lo único que pregunta. Y si lo puede deducir del PDF, lo propone y tú solo confirmas.

2. Dos o tres objetivos. Con verbo observable: identificar, aplicar, decidir. Nunca «conocer» ni «entender», que no hay forma de comprobarlos.

3. Una o dos preguntas por objetivo. De escenario mejor que de memoria, del tipo «un proveedor te envía esto, ¿qué deberías hacer?». Cada una con su feedback, y cada una diciendo a qué objetivo responde.

4. Una sola validación, con todo junto. Objetivos, preguntas y glosario a la vez. Si cambias algo, el agente te vuelve a enseñar la versión completa, porque a veces aplica una corrección y de paso pierde otra parte.

Y luego está la traducción, que casi se me cuela. Los PDF llegan en inglés y tienen que quedar en español de España nativo, lo más literal posible. En cumplimiento la fuerza de cada frase importa: «must» es «debe», «should» es «debería», «may» es «puede».

Por eso se traduce primero y se diseña después, sobre el texto ya traducido, para que las preguntas usen las mismas palabras que las diapositivas. Y el glosario de diez o quince términos clave permite revisar rápido sin releer la traducción entera.

¿Cómo se monta en Agent Builder?

No comparto aquí el .zip con la skill porque lleva un archivo JavaScript, y no quería compartir un archivo así. Comparto el prompt: la skill te la fabrica tu propio Copilot.

1. Elige el modelo más avanzado que tengas. En el chat de Copilot, en el selector de modelo, coge el más potente disponible. En mi caso fue Opus 5.5, de Anthropic. Qué modelos ves depende de lo que active tu organización.

2. Pídele la skill. Adjunta tu guía de marca y un PDF corto de prueba, y pega el prompt. Copilot genera las cuatro piezas, prueba el script con tu PDF y te devuelve la skill en un .zip. Descárgalo en el momento: los archivos que genera solo están disponibles durante la sesión.

3. Léete lo que te ha hecho. Abre el SKILL.md y comprueba que el flujo es el que quieres. Si el código te queda grande, pídele que te explique qué hace el script.

4. Crea el agente y súbele la skill. Crea un agente nuevo y ve a la pestaña de configuración. Instrucciones cortas, algo así: «Eres un asistente que convierte PDFs breves en formaciones SCORM. Cuando el usuario suba un PDF, usa la skill pdf-a-scorm». El procedimiento va en la skill. Después, en el apartado de skills, añade el .zip completo. No subas el SKILL.md suelto, que Microsoft lo advierte expresamente.

5. Pruébala con otro PDF corto. Desde la pestaña de prueba del agente, sube un PDF de tres o cuatro páginas. Mira que pregunte el colectivo, que proponga objetivos con verbo observable y que pare a esperar tu validación.

6. Pásalo por SCORM Cloud antes que por tu plataforma. Tiene una versión de prueba gratuita. Haz el curso entero, suspende a propósito una vez y aprueba después, y mira que registra la nota y el estado. Si ahí funciona, lo que falle después será cosa de tu plataforma.

¿Cuándo no compensa?

PDFs largos. Por encima de diez páginas, mejor partirlo en varios cursos.
Contenido que vive en las imágenes. Diagramas y tablas complejas se pierden.
Interacciones complejas. Escenarios ramificados o simulaciones siguen pidiendo una herramienta de autor.
Traducciones sin revisar. El texto normativo lo tiene que firmar una persona.

Datos comprobados el 23 de octubre de 2026. Las skills de Agent Builder están en preview y Microsoft cambia sus condiciones a menudo: comprueba en su documentación antes de montarla.

Skills disponibles solo en organizaciones inscritas en Frontier, con licencia de Microsoft 365 Copilot o pago por uso.
Hasta 8 skills por agente; paquete .zip de hasta 50 MB; instrucciones de la skill por debajo de 20.000 caracteres; instrucciones del agente, hasta 8.000.
Modelo con el que la creé: Opus 5.5, de Anthropic. Los modelos disponibles cambian y los activa cada organización.
Los archivos generados solo se pueden descargar durante la sesión.
SCORM Cloud: plan de prueba gratuito, sin límite de tiempo, con 3 cursos y 10 matrículas.

En resumen

Pedírselo a Copilot cada vez funciona, pero cada vez sale distinto. Una skill lo hace repetible.
La IA decide el contenido y tú lo validas; la plantilla y el script hacen la parte técnica, siempre igual.
Con tres decisiones basta para que haya diseño instruccional: colectivo, dos o tres objetivos observables y preguntas atadas a cada objetivo.
No hace falta descargar nada: con el modelo más avanzado que tengas y un buen prompt, tu Copilot te genera la skill.
Las skills de Agent Builder todavía están en preview y solo para organizaciones inscritas en Frontier. Compruébalo antes de nada.

El siguiente PDF ya no me descoloca. Lo subo, confirmo el colectivo, retoco un objetivo y descargo el paquete. Antes, cada PDF así era un encargo a un proveedor: briefing, maqueta, revisiones. Ahora lo hago yo, sin Storyline.

¿Hablamos?

¿Cómo conviertes tú ahora los PDFs en cursos? ¿Te aparece el apartado de skills en tu Agent Builder? ¿Qué tipo de contenido le dejarías a una skill así, y cuál no le dejarías ni loca? Cuéntamelo en los comentarios.

Preguntas frecuentes

¿Genera SCORM 2004?

El prompt pide SCORM 1.2, que es el que aceptan prácticamente todas las plataformas. Pasar a 2004 supone cambiar el manifest y la parte de la plantilla que habla con la plataforma.

¿Sirve para PDFs que no sean de cumplimiento?

Sí. Las reglas de no tocar el texto normativo están pensadas para cumplimiento. Con otro tipo de contenido puedes suavizarlas en el SKILL.md y dejar que el agente reescriba más.

El prompt, para copiar

Este es el prompt del paso 2. Adjunta antes tu guía de marca y un PDF corto de prueba. Léelo entero: es lo que va a construir tu skill, y si algo no te encaja, cámbialo antes de darle al Enter.

Quiero que me crees una skill para un agente de Agent Builder de Microsoft 365 Copilot. La skill convierte un PDF breve (menos de 10 páginas o diapositivas, normalmente de cumplimiento) en un curso SCORM 1.2 con objetivos y evaluación. Te adjunto mi guía de marca y un PDF corto para probarla.

Entrégamela como un único .zip con esta estructura, y el SKILL.md en la raíz:

- SKILL.md: encabezado YAML con name (pdf-a-scorm) y description, y debajo el procedimiento.
- assets/plantilla.html: la plantilla del curso.
- scripts/empaquetar.py: el script que genera el paquete.
- references/ejemplo-contenido.json: un ejemplo completo del formato del contenido.

El principio es este: tú, como agente, solo decides el contenido. La parte técnica la hacen siempre la misma plantilla y el mismo script. El agente nunca escribe HTML ni XML a mano.

PROCEDIMIENTO QUE TIENE QUE SEGUIR EL AGENTE (va en el SKILL.md)

Fase 1. Leer y traducir.
- Leer el PDF completo. Si tiene más de 10 páginas o diapositivas, avisar y preguntar si se divide en varios cursos.
- Si no está en español, traducirlo al español de España, con redacción nativa. Lo más literal posible: conservar el significado, la estructura y el nivel de obligación de cada frase ("must" = "debe", "should" = "debería", "may" = "puede"). Sin resumir, omitir, añadir, suavizar ni endurecer. Literal no es calco: construcciones naturales en español, sin anglicismos innecesarios. Mismo término, misma traducción en todo el documento. Nombres de políticas, leyes y siglas oficiales en su forma original salvo que exista traducción oficial.
- Preparar un glosario con los 10 a 15 términos clave.

Fase 2. Diseño instruccional, sobre el texto ya traducido.
- Preguntar solo a qué colectivo va dirigida la formación. Si se puede deducir del PDF, proponerlo para que el usuario confirme.
- Proponer 2 o 3 objetivos con verbo observable (identificar, aplicar, decidir...), nunca "conocer" ni "entender".
- Proponer 1 o 2 preguntas por objetivo, preferiblemente de escenario, con 3 o 4 opciones, una sola correcta, feedback para cada opción explicando el porqué, y el objetivo al que responde cada una.
- Presentar juntos glosario, objetivos y preguntas, y esperar aprobación explícita. Si el usuario cambia algo, volver a presentar la versión completa.

Fase 3. Generar el curso de una vez.
- Repartir el contenido en un máximo de 10 diapositivas, en el orden del PDF.
- Escribir contenido.json siguiendo exactamente el ejemplo de references.
- Ejecutar el script. Si da errores, corregir contenido.json y repetir. No tocar nunca la plantilla ni el script.
- Entregar el .zip y avisar de que hay que descargarlo en ese momento, porque solo está disponible durante la sesión.

Fase 4. Una ronda de cambios: aplicar los cambios en contenido.json, volver a ejecutar el script y entregar el .zip con la versión en el nombre (_v2, _v3...).

Reglas: no modificar, resumir ni reinterpretar el texto normativo; el colectivo solo puede cambiar ejemplos, tono y escenarios de las preguntas. Usar los términos del glosario en objetivos y preguntas. No añadir nada que no se apoye en el PDF. Textos del JSON en texto plano, sin HTML ni Markdown.

FORMATO DE contenido.json
Campos: titulo, identificador (minúsculas, números y guiones), colectivo, nota_aprobado (de 1 a 100), objetivos (id, texto), glosario (original, traduccion), diapositivas (titulo y bloques de tipo parrafo, destacado o lista) y preguntas (id, objetivo_id, enunciado y opciones con texto, correcta y feedback).

LA PLANTILLA
- Un solo fichero HTML autocontenido: nada de fuentes, librerías ni imágenes cargadas de internet.
- Diseño según mi guía de marca, con todos los colores y la tipografía como variables CSS agrupadas al principio en un bloque comentado como MARCA, para poder cambiarlos sin tocar nada más.
- Pantallas en este orden: portada con título, colectivo y objetivos; diapositivas; introducción a la evaluación; una pregunta por pantalla, con botón Comprobar y feedback de la opción elegida; resultado con la nota y, si no aprueba, un botón para repetir la evaluación.
- Barra de progreso y botones Anterior y Siguiente. Que se vea bien en el móvil y se pueda usar con teclado.
- El contenido va incrustado como JSON en un <script type="application/json"> y se inserta siempre con textContent, nunca con innerHTML, para que ningún texto del PDF pueda ejecutarse como código.
- SCORM 1.2: buscar el objeto API en las ventanas padre y en window.opener; si no lo encuentra, que el curso funcione igual sin plataforma. Al empezar, LMSInitialize y, si el estado es "not attempted", poner "incomplete". Guardar cmi.core.lesson_location en portada y diapositivas para reanudar, pero no a mitad de evaluación. Al terminar la evaluación, cmi.core.score.raw, min 0, max 100 y cmi.core.lesson_status "passed" o "failed" según nota_aprobado, con LMSCommit. LMSFinish una sola vez al cerrar.

EL SCRIPT
- Python, solo biblioteca estándar, sin red.
- Antes de empaquetar, validar contenido.json y, si hay errores, listarlos todos y no generar nada. Como mínimo: que estén todos los campos; que no haya más de 10 diapositivas; que cada pregunta tenga entre 2 y 5 opciones y exactamente una correcta, con feedback en todas; que cada objetivo_id exista; que cada objetivo tenga al menos una pregunta; que ningún texto contenga HTML. Avisar, sin bloquear, si hay menos de 2 o más de 3 objetivos o si un objetivo empieza por "conocer" o "entender".
- Meter el JSON en la plantilla neutralizando cualquier "</" para que no rompa la etiqueta script.
- Generar imsmanifest.xml de SCORM 1.2 con adlcp:masteryscore igual a nota_aprobado, y un .zip con imsmanifest.xml e index.html en la raíz.

ANTES DE ENTREGARME LA SKILL
Prueba el script con el PDF que te adjunto: genera el contenido.json, ejecuta el script, comprueba que el manifest es XML válido y prueba también que la validación rechaza un JSON con errores. Después entrégame el .zip de la skill y, aparte, el SCORM de prueba, y dime qué has comprobado y qué no has podido comprobar.

Copilot puede tomarse libertades con los detalles, así que revisa lo que te entregue como dice el paso 3. Si algo no sale como pide el prompt, pídele que lo corrija antes de subir la skill al agente.