Has explicado el mismo trabajo a una ventana de chat otra vez. Las reglas de tono. La forma de salida. Los datos que nunca debe inventar. Gemini Skills existen para terminar ese ciclo, y la parte que la mayor parte de la cobertura entierra es el archivo debajo de ellos. Google construyó Skills sobre el estándar abierto SKILL.md, así que una habilidad que escribes una vez como un archivo que conservas puede ir a Gemini y también puede ir a otros asistentes que leen ese mismo estándar.
Google anunció Skills el 30 de septiembre de 2026, como instrucciones reutilizables que reemplazarán a Gems. El despliegue en la aplicación de Gemini comenzó el 13 de octubre de 2026. Este tutorial sigue las páginas de ayuda de Gemini Apps y la especificación de Agent Skills, verificadas el 11 de noviembre de 2026. No afirma una ejecución de prueba propia. La sección de Verificación te dice cómo juzgar el resultado en tu propia cuenta.
Lo que vas a construir o aprender
Terminarás con una habilidad funcional que redacta una descripción de producto a partir de datos que tú aportas. El ejemplo es pequeño a propósito. Una vez que el archivo funcione en Gemini, reutilizarás ese archivo exacto fuera de Gemini, y aprenderás dónde se detiene la reutilización. Los scripts, archivos y acceso a herramientas no viajan con tanta fiabilidad como las instrucciones.
La ganancia es la propiedad. Una habilidad construida solo dentro de una aplicación vive a merced de esa aplicación. Una habilidad conservada como un archivo en tu propia carpeta puede editarse, compartirse, guardarse con un proyecto y cargarse de nuevo cuando cambies de herramientas. Nuestro perfil de Microsoft APM, el gestor de paquetes para habilidades de agente, cubre cómo los equipos comparten esos archivos a escala. Este tutorial cubre la versión de una sola habilidad que cualquiera puede hacer hoy.
La descripción en la parte superior de un archivo SKILL.md decide cuándo un asistente lo busca. Ilustración: Dirty Static
Antes de empezar
Elige un trabajo que se repita y tenga una salida comprobable. Texto de producto, notas de reunión en una forma fija o un informe en un formato de la casa funcionan bien. Un trabajo vago hace una habilidad vaga, y una descripción vaga hace que Gemini pierda los momentos en que la habilidad debería aplicarse.
Dos límites dan forma a todo el método, y Google declara ambos en términos sencillos. Primero, Skills en la aplicación de Gemini y Skills en las aplicaciones de Workspace no se sincronizan. Una habilidad que necesitas en ambos lugares debe crearse en cada lugar. Segundo, los scripts dentro de una habilidad subida que necesitan acceso a sitios web externos no son compatibles en Gemini. Una habilidad cuyo núcleo es una llamada web puede funcionar en un agente de programación y fallar en Gemini, aunque las instrucciones se carguen en ambos.
Paso 1: Escribe el archivo maestro SKILL.md
Acción: crea una carpeta con un nombre en letras minúsculas unidas por guiones, y luego crea un archivo llamado SKILL.md dentro de esa carpeta. La especificación de Agent Skills dice que el nombre de la carpeta debe coincidir con el campo name en el archivo, el nombre puede usar solo letras minúsculas, números y guiones, y no puede empezar ni terminar con un guion. La descripción puede tener hasta 1,024 caracteres como máximo, y debería decir lo que hace la habilidad y cuándo usarla.
Guarda este ejemplo como el archivo SKILL.md dentro de una carpeta llamada draft-product-description:
---
name: draft-product-description
description: Drafts product copy from supplied facts for an online shop. Use when preparing a new product page or rewriting catalogue copy from a list of facts, price and materials.
---
# Draft a product description
Use only the facts the user supplies in the chat. Never invent a price, a material, a size or a delivery claim.
## Steps
1. Read the supplied facts and list any fact that is missing for a complete description.
2. If the price or the material is missing, ask for it and stop.
3. Draft a title of eight words or fewer from the product name and its main use.
4. Write two short paragraphs. The first states what the product is and who it suits. The second states the materials, the size and the care facts, when supplied.
5. End with one plain line that gives the price exactly as supplied.
## Output shape
Return the title on its own line, then the two paragraphs, then the price line. Keep the tone plain and factual.
Resultado esperado: tienes una carpeta con un archivo, y el archivo tiene dos partes. El frontmatter entre las líneas de tres guiones lleva el nombre y la descripción. El cuerpo en Markdown debajo lleva las instrucciones, los pasos y la forma de salida. Mantén el cuerpo por debajo de 500 líneas, como aconseja la especificación, y mueve material de referencia largo a archivos separados solo cuando la habilidad realmente los necesite.
Paso 2: Sube el archivo a Gemini
Acción: abre la aplicación web de Gemini, ve a la página de Skills, y en la parte superior selecciona Create y luego Upload, como describe la página de ayuda de Gemini Apps. Selecciona el propio archivo SKILL.md, o selecciona la carpeta o un archivo zip que contenga SKILL.md en su carpeta principal. Selecciona Open, agrega cualquier archivo extra que el flujo ofrezca, y luego selecciona Upload. Revisa la habilidad, edita el nombre, la descripción o las instrucciones si la pantalla de revisión muestra un cambio que no esperabas, y luego selecciona Create en la parte superior.
Resultado esperado: la habilidad nueva aparece en tu página de Skills con el nombre draft-product-description. Google enumera un límite total de 100 MB para todos los archivos subidos con una habilidad, y solo se admiten archivos basados en texto simple para la ruta de subida. Si la subida falla, revisa si hay archivos ocultos en la carpeta, como un archivo .DS_Store, y elimínalos antes de intentarlo de nuevo.
También puedes construir una habilidad dentro de Gemini con Create manualmente, con una plantilla, o pidiéndole a Gemini en un chat que convierta una buena conversación en una habilidad. Esas rutas son más rápidas para una habilidad única. La ruta de archivo en este paso es la que te deja con una copia maestra que puedes reutilizar en otro lugar, que es el punto de este tutorial.
Paso 3: Usa la habilidad en un chat
Acción: abre un chat nuevo y escribe una barra, o el signo de arroba si tu cuenta muestra el atajo actualizado, y luego selecciona draft-product-description. Pega una lista corta de datos reales para un producto, con su nombre, material, tamaño y precio, y pide la descripción.
/draft-product-description
Facts: enamel mug, 350 ml, steel with enamel coat, white, price 18 dollars. For campers and desk use. Hand wash only.
Resultado esperado: Gemini sigue la forma de salida del archivo. Obtienes un título corto, dos párrafos y una línea de precio, y ninguna afirmación que estuviera ausente de tus datos. Deja un dato fuera en un segundo intento, como el precio. La habilidad debería pedir el dato faltante y detenerse, como dirigen sus instrucciones. Esa negativa es parte del diseño, no una falla.
Las habilidades también pueden aplicarse por su cuenta. Google dice que Gemini puede usar una habilidad activada cuando el contexto de una tarea encaja con ella, y puedes desactivar una habilidad en la página de Skills si quieres solo control manual. También puedes usar más de una habilidad en una sola tarea. Apila esta habilidad de texto con una segunda habilidad que contenga tu voz de marca, y el chat seguirá ambos conjuntos de instrucciones en una respuesta.
Paso 4: Reutiliza el mismo archivo en otras herramientas
Acción: conserva la carpeta draft-product-description como la maestra, y carga ese mismo SKILL.md en cada otro asistente que uses que admita el estándar Agent Skills. Google declara la promesa de reutilización en una línea en su publicación de Workspace: Skills se construyen sobre el estándar abierto SKILL.md, y eso te permite copiar habilidades que creaste en otras plataformas a la aplicación de Gemini y las aplicaciones de Workspace. La especificación en agentskills.io define la misma forma de archivo para cada cliente que la adopta.
Un archivo maestro, muchas salas: cada herramienta obtiene su propia copia, así que la carpeta que conservas es la fuente que importa. Ilustración: Dirty Static
Resultado esperado: las instrucciones viajan. El nombre, la descripción y el cuerpo deberían leerse igual en Claude, ChatGPT, un agente de programación o herramientas de estilo Gemini CLI que leen el estándar, sujeto a cada herramienta y su propia ruta de importación y reglas de carpeta. Sigue los pasos de importación que la propia herramienta documenta, coloca la carpeta donde esa herramienta lee habilidades, y ejecuta los mismos datos de producto del Paso 3 como tu entrada de prueba.
Lo que no viaja merece el mismo peso. Las herramientas no se sincronizan, así que una corrección que hagas dentro de Gemini nunca llega a la copia en otra herramienta, y una corrección en la carpeta maestra no llega a ninguna herramienta hasta que cargues el archivo de nuevo. El soporte de archivos, el soporte de scripts y el acceso a herramientas también varían según el cliente. La página de ayuda de Gemini limita las habilidades subidas a archivos de texto simple admitidos y bloquea scripts que necesitan sitios web externos. Espera que las palabras se transfieran. Prueba los extras en cada herramienta antes de confiar en ellos. Nuestra guía de revisiones de PlugVet para habilidades y plugins de agente es una lectura útil antes de cargar una habilidad escrita por otra persona.
Paso 5: Actualiza la maestra, y luego cárgala de nuevo
Acción: cuando la salida se desvíe, cambia primero el archivo maestro SKILL.md. Aclara el paso que falló, agrega el caso límite faltante a las instrucciones y guarda el archivo. Luego actualiza cada lugar donde vive la habilidad. En Gemini, Google señala que actualizar archivos en una habilidad significa subir toda la habilidad con sus archivos de nuevo. También puedes pedirle a Gemini que actualice una habilidad dentro de la aplicación, pero mantén ese cambio en sintonía con el archivo maestro o las copias se separarán.
Resultado esperado: cada copia se remonta a un archivo editado, y tus notas pueden nombrar la fecha de la última actualización. Si omites la maestra y editas solo dentro de una aplicación, ahora tienes dos habilidades que comparten un nombre y difieren en comportamiento, que es exactamente la deriva que este tutorial se propuso eliminar.
Verificación
Inicia un chat fresco en Gemini, llama a la habilidad con una barra y usa datos para un producto que la habilidad nunca ha visto. Revisa tres cosas en la respuesta. El título y los párrafos siguen la forma de salida. Cada afirmación en el texto aparece en los datos que aportaste. La línea de precio coincide con tu precio aportado exactamente, sin ninguna afirmación agregada sobre entrega o existencias.
Luego ejecuta los mismos datos en otra herramienta donde cargaste el archivo. La redacción puede diferir, ya que un modelo diferente escribe el texto. La forma, el comportamiento ante el dato faltante y la prohibición de afirmaciones inventadas deberían mantenerse en ambos lugares. Si se mantienen en ambos, el archivo funciona como una habilidad portable, no solo como un ajuste de Gemini.
Termina con la revisión de Gems. Si aún conservas Gems que te importan, abre las notas de transición de Skills en la ayuda de Gemini Apps. Google dice que Gems se mueven al panel de Settings el 17 de noviembre de 2026, y cualquier Gem que quede en la aplicación cuando termine el soporte se moverá a Skills en borrador por su cuenta. Una pasada manual ahora te permite convertir tus mejores Gems en archivos SKILL.md limpios mientras aún puedes comparar las formas antigua y nueva lado a lado.
Solución de problemas
| Problema | Causa probable | Solución |
|---|---|---|
| No aparece ninguna página de Skills en tu cuenta | El despliegue es gradual, o el tipo de cuenta aún no está cubierto | Confirma que usas una Cuenta de Google personal y que tienes 18 años o más, y luego revisa la aplicación web, la aplicación móvil y la aplicación de Mac. Espera el despliegue si ninguna muestra Skills aún |
| La subida se rechaza | SKILL.md no está en la raíz de la carpeta, el nombre rompe la regla de nomenclatura, o el tamaño total de archivos supera los 100 MB | Coloca SKILL.md en la carpeta principal, haz el nombre de la habilidad en minúsculas con guiones y coincidente con el nombre de la carpeta, elimina archivos ocultos y recorta archivos de referencia grandes |
| Gemini nunca aplica la habilidad por su cuenta | La descripción es demasiado vaga para que Gemini coincida con la tarea, o la habilidad está desactivada | Reescribe la descripción para nombrar lo que hace la habilidad, cuándo usarla y las palabras que usará una solicitud. En la página de Skills, activa la habilidad si quieres uso automático |
| La habilidad inventa un precio o un material | Las instrucciones no prohíben datos agregados, o la entrada de prueba dejó huecos sin una regla para huecos | Agrega una regla simple que nombre el comportamiento prohibido, más un paso que pida un precio o material faltante y se detenga. Prueba de nuevo con un dato eliminado |
| La habilidad funciona en Gemini pero está ausente en Workspace | Skills no se sincronizan entre la aplicación de Gemini y las aplicaciones de Workspace | Crea la habilidad de nuevo en Workspace desde el mismo archivo maestro. Mantén ambas copias vinculadas a ese único archivo para actualizaciones posteriores |
| Un script en la habilidad falla en Gemini | El script necesita acceso a un sitio web externo, que Gemini no admite para habilidades subidas | Mantén las instrucciones portables y mantén el script como una parte opcional para herramientas que lo admitan. Declara ese límite en el cuerpo de la habilidad para que ningún lector espere que el script se ejecute en todas partes |
| La misma habilidad da una forma diferente en una segunda herramienta | Esa copia es antigua, o esa herramienta lee solo parte del paquete | Carga el archivo maestro actual de nuevo en esa herramienta, y luego vuelve a ejecutar la entrada de prueba del Paso 3 y compara la forma, no la redacción exacta |
Próximos pasos
Construye una segunda habilidad pequeña que haga bien un trabajo estrecho, como una revisión de voz de marca, y apílala con la habilidad de texto de producto en un chat. Dos habilidades estrechas que se combinan superan a una habilidad gigante que trata de gobernar cada tarea, y cada una se mantiene fácil de probar por su cuenta.
Guarda las carpetas maestras con el proyecto al que sirven, en un repositorio o una carpeta de unidad compartida que tu equipo pueda leer. Cuando una habilidad se demuestra en dos herramientas, esa carpeta se convierte en parte del registro del proyecto, de la misma manera que lo hace una guía de estilo. Empieza con una habilidad, demuéstrala en dos lugares, y solo entonces construye la biblioteca.
Datos verificados contra la ayuda de Gemini Apps sobre crear y gestionar habilidades, la publicación de Google Workspace Updates del 30 de septiembre de 2026, con su actualización del 9 de noviembre de 2026, y la especificación de Agent Skills en agentskills.io, el 11 de noviembre de 2026. Este procedimiento se verificó contra esos documentos y no se presentó como una ejecución de prueba personal.
Fuentes
- Google, Gemini Apps Help: Create and manage skills for Gemini Apps
- Google, Gemini Apps Help: Write effective skills for Gemini Apps
- Google Workspace Updates, 30 de septiembre de 2026: Introducing skills in the Gemini app and Workspace, plus what is next for Gems
- Especificación de Agent Skills, agentskills.io
- Ilustraciones: Dirty Static
FIN DE LA TRANSMISIÓN
Mantén la curiosidad. Cuestiónalo todo.
