Cada equipo tiene tareas que alguien explica una y otra vez: desplegar una aplicación, investigar un cobro duplicado, preparar un informe regulatorio o migrar datos. Cuando la orientación vive en un chat o en la memoria de una persona, el agente repite preguntas y omite detalles.
El 12 de noviembre de 2026, GitHub publicó una guía sobre agent skills: directorios versionados centrados en SKILL.md que capturan trabajo repetible. Las instrucciones pueden viajar entre agentes, mientras herramientas, credenciales, contexto y permisos siguen perteneciendo al entorno de ejecución.
Qué es una agent skill
Es un paquete de conocimiento operativo que enseña cuándo y cómo realizar una actividad. Puede incluir instrucciones, scripts, ejemplos, plantillas y referencias. Frente a un prompt aislado, aporta estructura, versión, revisión y condiciones de uso.
Una skill que explica cómo consultar una base de datos no concede acceso. El host debe aportar herramienta, identidad y autorización. Así se comparte el método sin distribuir secretos.
Contenido recomendado
Activación y resultado
Indica cuándo se aplica, qué artefacto produce y cuándo no debe usarse. “Preparar una migración Laravel sin parada” es más útil que “skill de despliegue”.
Precondiciones
Enumera datos, herramientas, permisos, versión y aprobaciones. El agente debe detenerse si falta una condición esencial.
Procedimiento y decisiones
Ordena pasos, controles y alternativas. Explica criterios y qué decisiones necesitan a una persona.
Evidencias
Define comandos, pruebas, consultas o checklist. Un backup debe demostrar restauración; una integración, contrato, idempotencia y logs.
Recursos
Añade scripts pequeños, plantillas y ejemplos. Mantén el archivo principal conciso y dirige a los detalles cuando sean necesarios.
Skill, herramienta, prompt y agente
- prompt: solicitud de una ejecución;
- skill: método reutilizable;
- herramienta: capacidad de leer o modificar un sistema;
- agente: coordina modelo, instrucciones, contexto, herramientas y política.
La separación evita skills con credenciales o herramientas que deciden sin política. La skill orienta; la herramienta actúa con autorización.
Ejemplo: alta de un cliente
Una empresa de software recibe contrato, plan, responsables e integraciones. La skill valida campos, crea tenant, configura permisos, importa datos, prueba accesos y prepara la entrega.
El método sirve en un agente del IDE, una automatización interna o un asistente de operaciones. Cada host aporta solo las herramientas permitidas. Producción requiere aprobación; pruebas puede permitir creación automática. La skill es portable porque no depende de un token ni de una interfaz.
Versionado y confianza
Las skills cambian el comportamiento del agente. Una modificación silenciosa puede alterar comandos o destinos. Trátalas como código: pull request, revisión del dominio, pruebas, release inmutable y rollback.
El 3 de noviembre, GitHub incorporó actualizaciones de Agent Package Manager a Dependabot. Puede abrir pull requests y regenerar el lockfile. No son actualizaciones de seguridad, por lo que origen, revisión y pinning siguen siendo necesarios.
Controles
- fijar versión o commit;
- revisar scripts y permisos;
- no guardar claves ni datos personales;
- ejecutar código en aislamiento;
- limitar red y herramientas;
- registrar skill y versión;
- probar entradas adversarias y paradas;
- asignar propietario e incidentes.
Cómo conseguir portabilidad
Describe capacidades en lugar de clics de un producto. En vez de “pulsa el botón azul”, indica “crea un registro mediante el conector CRM y valida el identificador”. Mantén adaptadores específicos separados.
Usa formatos abiertos, rutas relativas y dependencias declaradas. No presupongas sistema operativo, shell o ubicación. Si algo depende del entorno, documenta la capacidad y una alternativa segura.
Gobierno para equipos
La biblioteca necesita catálogo, búsqueda, responsables y ciclo de vida. Clasifica por dominio, riesgo y herramientas. Diferencia experimental, aprobada y retirada. Evita duplicados y conserva una fuente principal con extensiones controladas.
La persona experta valida la regla; ingeniería revisa scripts y efectos; seguridad comprueba permisos y datos.
Métricas
- tareas terminadas sin reexplicar;
- tiempo e intervención humana;
- fallos por etapa y versión;
- reutilización entre proyectos y agentes;
- tiempo para actualizar un cambio de proceso;
- incidentes y skills sin propietario.
Plan de adopción
- Elige tres tareas frecuentes.
- Observa a especialistas y registra decisiones.
- Escribe activación, precondiciones, pasos y evidencias.
- Separa instrucciones de herramientas y credenciales.
- Prueba casos normales y fallos.
- Publica una versión revisada y fíjala.
- Mide y convierte correcciones en revisiones.
Conocimiento que no se pierde
Las agent skills reducen repetición y hacen más consistente la IA, pero requieren revisión, versionado y límites del entorno. No congelan el proceso: crean una base evolutiva y trazable.
ProativaIA desarrolla agentes y automatizaciones empresariales, plataformas a medida y bibliotecas de instrucciones conectadas con sistemas corporativos. Podemos mapear procesos, crear skills y aplicar controles.