Crea tu propia skill docente
Crea tu propia skill docente
Recorre ocho etapas con una skill de ejemplo, asistente-formacion-ocupacional, para preparar programaciones, actividades y materiales.
La skillDefine cómo trabaja la IA.
La documentaciónAporta la información de cada edición.
El docenteToma decisiones y valida el resultado.
Diseñar la skill
Ponerla en práctica
Etapa 1 de 8
Detectar
Objetivo. Identifica una tarea que repites de un curso a otro.
Resultado esperadoUna tarea delimitada: preparar borradores de programación, actividades o materiales a partir de la documentación de cada edición.
Etapa 2 de 8
Decidir
Objetivo. Elige la herramienta en función de lo que se repite.
Resultado esperadoUna elección justificada y las dependencias que requiere.
Etapa 3 de 8
Delimitar
Objetivo. Define qué puede hacer la IA y qué decides tú.
Resultado esperadoUna regla comprobable: «Entrega un borrador con fuentes y decisiones pendientes de validación».
Etapa 4 de 8
Estructurar
Objetivo. Convierte el método en un paquete de instrucciones legible.
Resultado esperadoUna carpeta instalable en entornos compatibles. Abre el árbol para explorar sus archivos.
Etapa 5 de 8
Contextualizar
Objetivo. Conecta el método con las fuentes de la edición.
Resultado esperadoUna ficha de fuentes identificadas y decisiones confirmadas o pendientes.
Etapa 6 de 8
Implementar
Objetivo. Pon el método a disposición del asistente que vas a usar.
Resultado esperadoLa skill está accesible en el entorno elegido y lista para una prueba con datos ficticios.
Etapa 7 de 8
Comprobar
Objetivo. Comprueba que el asistente aplica el método de forma verificable.
Resultado esperadoUna tabla de pruebas con resultado observado, cambio y nueva comprobación.
Etapa 8 de 8
Mantener
Objetivo. Actualiza la skill sin duplicar el método ni las fuentes.
Resultado esperadoUna versión identificada, fuentes vigentes y pruebas repetibles.
Prompt
Para una petición puntual, escribe directamente al asistente qué necesitas.
Qué incluirLa tarea, la fuente que debe usar, el formato de salida y qué hacer si falta información.
Ejemplo docente«A partir del programa adjunto, propón una actividad de 30 minutos para practicar el envío de fotos desde el móvil. Incluye materiales, pasos y una comprobación final. Si el programa no indica el nivel del grupo, pregúntame».
Estructura de una skill
El archivo SKILL.md va directamente en la carpeta principal. Añade las otras carpetas cuando necesites recursos.
Carpeta principalasistente-formacion-ocupacional/
- Archivo obligatorioInstrucciones en Markdown
- Carpeta opcional · guías
criterios-de-entrega.mdGuía en Markdownmanual-docente.pdfDocumento de consulta
- Carpeta opcional · materiales
plantilla-actividad.docxPlantilla editablepictograma.pngImagen reutilizable
- Carpeta opcional · utilidades
validar-tabla.pyPrograma en Python
El ZIP permite subir en un único archivo la carpeta completa de la skill. Conserva los nombres y la ubicación de los archivos, de modo que el asistente pueda encontrar los recursos que se mencionan en SKILL.md.
asistente-formacion-ocupacional.zip
└── asistente-formacion-ocupacional/
├── SKILL.md
└── assets/
└── plantilla-actividad.docx- Claude.ai. Para subir una skill personalizada, comprime su carpeta principal e importa el ZIP. En este ejemplo, la plantilla viaja junto con las instrucciones.
- Herramientas locales. Codex y Claude Code pueden leer la carpeta directamente desde la ubicación adecuada. Gemini CLI también admite la instalación desde una carpeta o repositorio.
Guía de Anthropic para preparar el ZIP
Incluye una cabecera con name y description, seguida por los pasos que seguirá el asistente. Este ejemplo es una base para adaptar.
---
name: asistente-formacion-ocupacional
description: Prepara borradores de programaciones, actividades y materiales de formación ocupacional a partir de las fuentes vigentes de la edición.
---
# Preparar un borrador docente
1. Identifica el curso, la edición y el entregable solicitado.
2. Consulta el programa oficial, el calendario aprobado y el perfil anónimo del grupo.
3. Si falta una fuente esencial o hay contradicciones, pregunta antes de completar la parte afectada.
4. Redacta el borrador. Indica qué fuentes usaste y qué decisiones debe validar el docente.
5. Espera la validación antes de preparar una versión para compartir.
Guarda guías estables que explican cómo consultar o citar las fuentes. Por ejemplo, criterios-de-entrega.md. El programa y el calendario vigentes pueden seguir en el proyecto de cada edición.
Guarda recursos reutilizables, como una plantilla de actividad vacía. Comprueba que no contiene nombres, contactos ni resultados de alumnado.
Guarda programas para una tarea mecánica y fácil de comprobar. Por ejemplo, validar si una tabla tiene las columnas requeridas. Esta skill puede empezar sin scripts.
Fuentes consultadas el 16 de noviembre de 2026. Los enlaces necesitan conexión.
Cuando Skills está disponible, entra en Plugins → Skills para crear, instalar o subir una skill. Comprueba los permisos de tu plan y espacio de trabajo. Adjunta o enlaza el programa autorizado para la edición y verifica que el asistente usa esa fuente.
Documentación oficial de ChatGPT
Coloca la carpeta de la skill en ~/.agents/skills/ para reutilizarla como usuario, o en .agents/skills/ dentro del repositorio para limitarla al proyecto. En Codex CLI puedes buscarla con /skills o seleccionarla con $. Comprueba los permisos de los archivos del curso.
Documentación oficial de Codex
Google está sustituyendo Gems por skills en Gemini Apps. Revisa el calendario de tu tipo de cuenta y, cuando la función esté disponible, crea o adapta las instrucciones en la app y añade los recursos que admita. En cuentas personales de mayores de edad, Google anunció solo lectura de Gems desde el 17 de noviembre de 2026 y su retirada el 17 de diciembre. La migración de trabajo y educación tiene otras fechas.
Documentación oficial de Gemini Apps · Gems y skills
Instala desde una carpeta o repositorio compatible. Puedes usar ~/.gemini/skills/ para tu usuario o .gemini/skills/ para el proyecto. Gemini CLI también reconoce .agents/skills/ según el ámbito. Comprueba que aparezca en /skills list y revisa la solicitud de permiso al activarla.
Documentación oficial de Gemini CLI
Si la cuenta y los permisos lo admiten, habilita la ejecución de código y abre Customize → Skills para subir el ZIP que contiene la carpeta de la skill. Actívala y prueba con archivos ficticios antes de usar fuentes de tu centro.
Documentación oficial de Claude.ai
Guarda la skill en ~/.claude/skills/ para el usuario o en .claude/skills/ dentro del proyecto. Selecciónala por su nombre con /nombre-skill o comprueba si se activa al hacer un encargo pertinente. Revisa qué archivos puede leer en la sesión.
Documentación oficial de Claude Code
- ¿Qué hago con frecuencia?
- ¿Qué pasos se repiten?
- ¿Qué tendría que corregir cada vez?
- Reúne dos encargos reales anonimizados.
- Describe qué entra, qué pasos siguen y cómo reconoces una buena salida.
Al preparar una programación, una actividad práctica o una evaluación, ten en cuenta lo siguiente.
- Qué debe aprender o demostrar el alumnado.
- Qué indica el programa oficial y qué decisiones ha tomado el docente.
- Cuánto tiempo hay y qué materiales están disponibles.
- Qué apoyos necesita el grupo.
- Cómo comprobarás el aprendizaje y con qué criterios.
Si revisas estos mismos puntos en varios encargos, pueden convertirse en pasos de una skill.
- ¿Es una petición puntual?
- ¿Necesitas conservar el contexto de un curso o una edición? Proyecto
- ¿Quieres reutilizar el mismo método en varias tareas? Skill
- ¿Necesitas leer datos o ejecutar una acción en otro servicio? Integración
- para un encargo puntual.
- Proyecto. Reúne los archivos y el contexto de un curso o edición.
- Skill. Reutiliza un método en distintas tareas.
- Integración. Lee datos o realiza acciones en otro servicio.
Puedes combinar estas opciones según el encargo.
Para una edición, guarda programa y calendario en el proyecto. Reutiliza la skill para seguir los mismos pasos en otras ediciones. Añade Drive solo si necesitas acceso directo a sus archivos.
- ¿Puede proponer, redactar o cambiar archivos?
- ¿Cuándo debe parar?
- ¿Quién valida?
- Especifica entradas, salidas y límites.
- Si falta información esencial o las fuentes discrepan, pide aclaración.
- Limita el acceso a datos personales.
- Deja la aprobación, evaluación y publicación en manos del docente.
La skill propone una actividad y señala dudas. El docente autoriza el tiempo, los criterios y la versión final antes de compartirla.
- ¿Qué reglas deben ir en SKILL.md?
- ¿Qué recursos necesitan un archivo aparte?
- Escribe name y description en la cabecera, y debajo el procedimiento, la salida y las comprobaciones.
- Añade carpetas solo si tienen contenido necesario.
- Usa scripts para pasos mecánicos que puedas verificar.
La descripción indica que prepara materiales de formación ocupacional basados en fuentes. SKILL.md explica cómo resolver el encargo. Una plantilla reutilizable puede ir en assets/.
- ¿Cuál es el programa vigente?
- ¿Qué fechas y materiales están aprobados?
- ¿Qué sabemos del grupo sin identificar a nadie?
- Identifica programa y calendario, materiales disponibles, perfil anónimo del grupo y decisiones docentes.
- Registra fecha o versión.
- Contrasta discrepancias y pide al docente que confirme la fuente aplicable.
El calendario reserva 90 minutos, pero un borrador antiguo dice 60. La skill muestra la discrepancia y espera la confirmación antes de ajustar la sesión.
- ¿Uso una app web o una herramienta local?
- ¿Tengo permisos?
- ¿Dónde estarán los recursos de cada edición?
- Elige una plataforma en la comparativa.
- Instala o recrea el método según lo que admita.
- Comprueba que lo detecta y que puede leer los recursos necesarios.
Usas la misma idea en ChatGPT y en Codex. En cada entorno revisas si la skill está disponible y si el programa se puede adjuntar o leer desde el proyecto.
- ¿Se activa cuando toca?
- ¿Usa el programa vigente?
- ¿Respeta los límites, la privacidad y la validación docente?
- Prueba un caso completo, otro con una fuente ausente y una petición fuera de alcance.
- Registra el resultado esperado y lo que ocurrió.
- Corrige la regla que falló y repite los tres casos.
Con fuentes completas entrega un borrador trazable. Sin calendario pregunta antes de fijar tiempos. Si le pides publicar directamente, espera la autorización docente.
- ¿Qué cambió: el procedimiento, la plantilla o los datos de la edición?
- ¿Dónde está la versión de referencia?
- Mantén una copia maestra del procedimiento y un registro breve de versiones.
- Actualiza el dato en su fuente.
- Repite las pruebas al cambiar instrucciones o herramientas.
Si cambia el calendario, actualizas la fuente de la edición. Si cambia la forma de validar un borrador, actualizas SKILL.md y registras la versión.