Herramientascopilot skills
Copilot skills: crea una instrucción reutilizable
Descubre qué son las skills de GitHub Copilot y crea un ejemplo sencillo en SKILL.md, con rutas, pruebas y precauciones de seguridad verificadas.
- Autor: humAIns
- 9 min de lectura
índice · 6 apartados
Las Agent Skills de GitHub Copilot son carpetas que reúnen instrucciones reutilizables y, si hacen falta, scripts y recursos para una tarea concreta. Cuando el agente considera que una skill es pertinente, puede cargar su SKILL.md; no hace falta pegar todo el procedimiento en cada conversación. En esta guía crearás una lista de comprobación ficticia, la guardarás en una ruta de proyecto y verificarás la detección sin ejecutar código de terceros.
Qué son las Agent Skills y cuándo se activan
Una skill es una unidad de trabajo especializada: instrucciones para una tarea recurrente, acompañadas opcionalmente por plantillas, ejemplos o scripts. Por ejemplo, un equipo puede describir cómo revisar documentación técnica: qué secciones comprobar, qué enlaces probar y cómo informar de los hallazgos. El agente lee las instrucciones relevantes cuando la tarea coincide con su propósito; no es una garantía de que cada ejecución las siga perfectamente.
GitHub describe Agent Skills como un estándar abierto usado por distintos sistemas de IA. Que exista un estándar común no significa que todos los productos acepten las mismas rutas o funciones opcionales. GitHub enumera como superficies compatibles la aplicación GitHub Copilot, Copilot CLI, Copilot cloud agent y code review en GitHub.com, además del modo agente de VS Code, Visual Studio y JetBrains. En los IDE, la compatibilidad depende de la versión.
En Visual Studio Code, la documentación indica que el agente descubre primero el nombre y la descripción de cada skill; carga el archivo SKILL.md cuando el trabajo parece pertinente y accede a otros recursos cuando las instrucciones los referencian. Esa carga progresiva evita incluir todo el material de todas las skills en cada petición. El comportamiento exacto puede cambiar según la superficie y versión, así que sigue la guía del entorno en el que trabajas.
No confundas esta función de GitHub Copilot con Microsoft 365 Copilot. Aquí hablamos de personalización de agentes para flujos de trabajo, no de asistentes dentro de Word o Excel. Para conocer otras formas de personalizar agentes de programación puedes leer cómo usar GitHub Copilot en VS Code y GitHub Copilot CLI; para una perspectiva más amplia, consulta cómo crear agentes de IA.
Diferencia entre instrucciones, skills y MCP
Las instrucciones personalizadas expresan criterios generales: convenciones de estilo, arquitectura que debe respetarse o pautas para revisar cambios. En VS Code pueden estar siempre activas o dirigirse a archivos según patrones, conforme al formato elegido. Son útiles cuando la regla debe acompañar muchas tareas, por ejemplo, «mantén los mensajes de interfaz en español».
Una skill describe un procedimiento concreto que el agente puede reutilizar cuando la tarea lo requiere. Puede contener pasos, listas de comprobación, ejemplos y scripts. La skill «auditar documentación», por ejemplo, podría indicar que se compruebe el título, la fecha y los enlaces, y proporcionar una plantilla de informe. Su descripción debe ser lo bastante clara para que el agente sepa cuándo resulta útil.
MCP, en cambio, es un protocolo para conectar un agente con herramientas o fuentes externas. No es un formato de instrucciones ni equivale a una carpeta de procedimientos. Una skill podría explicar cuándo consultar una herramienta MCP disponible, pero la conexión y los permisos se configuran por separado. No incluyas credenciales en el archivo de la skill.
| Elemento | Para qué sirve | Ejemplo |
|---|---|---|
| Instrucción personalizada | Define reglas generales o por tipo de archivo | Respetar el tono y formato del repositorio |
| Agent Skill | Enseña un flujo especializado que se carga cuando es pertinente | Revisar documentación con una lista de comprobación |
| MCP | Conecta con herramientas o servicios externos configurados | Consultar una fuente autorizada mediante una herramienta |
Crear una skill mínima y verificar que el agente la detecta
Este ejemplo es para un repositorio de proyecto con GitHub Copilot. GitHub documenta las skills de proyecto en .github/skills, .claude/skills o .agents/skills; la guía de VS Code también explica ubicaciones y controles propios de ese producto. Para el tutorial elegimos .github/skills/revisar-documentacion/, una carpeta dentro del repositorio. No supongas que esa ubicación personaliza todas las superficies: la compatibilidad depende del agente.
Crea la carpeta y, dentro, un archivo llamado SKILL.md. Empieza con un bloque YAML de metadatos que identifique la skill, seguido por instrucciones claras. La especificación abierta describe el formato; la siguiente versión mínima ilustra su estructura:
---
name: revisar-documentacion
description: Comprueba una página de documentación ficticia antes de publicarla.
---
# Revisar documentación
1. Lee el borrador completo antes de sugerir cambios.
2. Comprueba que el título describe el objetivo.
3. Busca enlaces sin destino y fechas sin fuente.
4. No inventes hechos: marca lo que no se pueda verificar.
5. Devuelve hallazgos con ubicación, motivo y propuesta.
6. No publiques ni modifiques archivos salvo que el usuario lo pida.
En el cuerpo del archivo explica el procedimiento, los límites y el formato de salida. Empieza con instrucciones concisas; si el flujo crece, puedes separar plantillas o scripts en la misma carpeta y referenciarlos desde SKILL.md. No añadas herramientas de ejecución solo para que la skill parezca más completa.
Para comprobar la detección, abre el repositorio en la superficie de Copilot compatible, inicia una conversación y pide algo inequívoco, como «Revisa este borrador de documentación con la lista de comprobación del repositorio». Observa si el agente utiliza las instrucciones esperadas. En VS Code, la página de Agent Skills incluye una sección para verificar la skill; los comandos y paneles pueden variar según versión. Si no se activa, confirma la ubicación admitida, el nombre del archivo, la descripción y que la tarea coincide con ella. Una prueba no demuestra compatibilidad con otras superficies.
Ejemplo de lista de comprobación de documentación ficticia
Imagina que un equipo prepara una página interna que explica cómo solicitar material de oficina. El borrador y los datos son inventados: no se conecta a compras, no manda solicitudes y no cambia sistemas. La skill puede pedir al agente que compruebe los elementos siguientes y señale incertidumbres en vez de rellenarlas por intuición.
- ¿El título explica qué debe hacer la persona lectora?
- ¿Se indica quién puede usar el procedimiento y en qué contexto?
- ¿Los pasos están ordenados y cada acción se entiende?
- ¿Hay fechas, cantidades o nombres que necesiten una fuente?
- ¿Los enlaces tienen destino y parecen corresponder a la frase?
- ¿Se distinguen los hechos comprobados de las propuestas editoriales?
- ¿El resumen final indica qué queda pendiente de verificar?
Una petición de prueba podría ser: «Usa la skill de revisión de documentación con este texto ficticio. No abras enlaces externos, no ejecutes comandos y no edites el archivo; devuelve observaciones con una cita breve del pasaje y explica qué dato requeriría confirmación». Así se puede comprobar que las instrucciones orientan el resultado sin convertir un experimento editorial en una acción real.
Para revisar la calidad de la skill, evalúa el resultado con ejemplos distintos: una página clara, otra con un enlace roto escrito a propósito y otra con una fecha no respaldada. ¿Señala cada problema? ¿Evita inventar la fecha correcta? ¿Respeta la instrucción de no modificar archivos? Si no, aclara el procedimiento o el alcance. Las skills funcionan mejor con criterios observables y límites explícitos que con indicaciones vagas como «hazlo bien».
Seguridad de scripts y repositorios
Una skill puede incluir scripts. Eso amplía lo que el flujo puede hacer y exige más cuidado: abre cada archivo, entiende sus entradas y salidas, identifica dependencias y comprueba si accede a red, archivos fuera de la carpeta o variables de entorno. Revisa también los cambios posteriores; un script puede comportarse de forma distinta a lo que promete su descripción.
No instales una skill de terceros directamente en un repositorio de trabajo sin leer todos sus archivos. Un SKILL.md puede sugerir acciones peligrosas aunque parezca documentación. Empieza en una copia desechable, limita permisos, no ejecutes órdenes desconocidas y no proporciones contraseñas, tokens, datos personales o material confidencial. Si el agente puede editar, aprobar comandos o usar herramientas externas, confirma el alcance antes de permitirlo.
En equipos, trata las skills como código sujeto a los mismos controles que el resto del repositorio: revisión de cambios, control de versiones y pruebas del comportamiento. Una carpeta compartida puede influir en tareas de varias personas. Mantén la descripción honesta, elimina instrucciones obsoletas y deja claro qué no debe hacer la skill. La instalación o detección no certifica que el contenido sea seguro.
Preguntas frecuentes
¿Skills son lo mismo que instrucciones personalizadas?
No. Las instrucciones suelen expresar pautas generales o aplicarse a determinados archivos; una skill empaqueta un flujo especializado y puede incluir recursos o scripts. La distinción y las funciones concretas varían entre productos.
¿Dónde se guarda SKILL.md?
El archivo se guarda dentro de la carpeta de la skill. En GitHub Copilot, las ubicaciones de proyecto documentadas incluyen .github/skills, .claude/skills y .agents/skills; para uso personal, ~/.copilot/skills y ~/.agents/skills. El soporte de rutas depende de la superficie. En sesiones cloud de sandbox, GitHub documenta además un caso para dotfiles en .copilot/skills, que no se aplica a sesiones basadas en GitHub Actions.
¿Funcionan en todos los planes y entornos?
No hay que generalizar. GitHub indica que Copilot CLI está disponible en todos los planes, aunque una organización puede desactivar la política correspondiente, y que Copilot cloud agent está disponible en planes de pago. IDEs y otras superficies tienen condiciones y versiones propias. Confirma la documentación y la matriz de funciones actual.
¿Puedo instalar skills de terceros con seguridad?
Puedes explorar repositorios que las comparten, pero la procedencia no garantiza seguridad. Inspecciona el contenido y cada script, verifica dependencias y prueba con permisos mínimos en un repositorio aislado. No compartas secretos ni datos de trabajo durante la prueba.
La automatización útil empieza por instrucciones claras y una revisión proporcionada al riesgo. Si trabajas en marketing y quieres aprender a aplicar IA a procesos de esa área, consulta el curso de IA para marketing; no es una formación técnica sobre GitHub Copilot ni programación. Para valorar tu punto de partida, completa ¿Cuánto te queda?.
Fuentes oficiales: Agent skills en GitHub Copilot, Agent Skills en VS Code y especificación abierta de Agent Skills.
Sigue leyendo en humAIns