Skills de agentes en producciónSerieSistemas IA que sí llegan a producción

Agent skills portables: contratos de producción

Google Cloud llevó skills componibles a operaciones HPC con herramientas deterministas, validación previa y aprobación humana. Esta guía traduce ese avance en siete contratos para reutilizar procedimientos entre agentes sin heredar privilegios, rutas ni confianza implícita.

Agent skillsInteroperabilidad de agentesGobierno de IAEvaluación de agentes
Wasyra Lab
Arquitectura de sistemas IA y operaciones
Publicado
min de lectura
7 min de lectura
Categoría
Sistemas IA
7contratos para portar una skill con control
Un módulo de conocimiento reusable cruza controles de procedencia, aprobación, pruebas y rollback antes de conectarse a tres runtimes con permisos distintos.

Capítulo 01

¿Cómo haces portable una agent skill sin trasladar confianza?

Porta el procedimiento, pero vuelve a vincular herramientas, permisos, aprobaciones y pruebas en cada runtime.

Una agent skill es portable cuando conserva la intención y el procedimiento al moverse entre hosts, no cuando ejecuta ciegamente el mismo comando en todos. El paquete debe tener una fuente versionada, declarar cuándo aplica, cargar referencias solo cuando hacen falta y describir capacidades sin asumir rutas, credenciales ni herramientas. Cada runtime debe resolver esas capacidades contra su inventario real, negar lo que no existe, ejecutar un preflight determinista y pedir aprobación antes de una mutación. Después, una matriz de evaluaciones debe comprobar resultados e invariantes en cada host; la telemetría debe registrar skill, versión, herramientas y aprobador; y el despliegue debe poder revertirse. Esos siete contratos separan conocimiento reusable de autoridad local. Sin esa separación, mover un SKILL.md solo replica instrucciones: no demuestra compatibilidad, seguridad ni fiabilidad operativa.

Google Cloud anunció el 13 de noviembre de 2026 skills componibles para operar cargas HPC mediante Cluster Toolkit. La propuesta es más concreta que una biblioteca de prompts: verifica cuotas y capacidad, selecciona blueprints validados, espera aprobación humana antes de desplegar, opera dentro de IAM y presupuestos, y conserva procedencia en Cloud Logging. La noticia tiene tres días calendario al publicarse este artículo en America/Lima. Google no presenta estas propiedades como un benchmark universal ni como prueba de que cualquier skill funcione en cualquier agente; son decisiones de arquitectura para ese entorno.

Capítulo 02

¿Qué siete contratos debe cumplir una skill portable?

La unidad de portabilidad no es un archivo aislado: es un paquete, un adaptador por host y evidencia repetible.

El contrato de fuente fija un owner, una licencia, una revisión y una versión inmutable. El contrato de activación define con precisión qué solicitudes deben cargar la skill y cuáles deben rechazarse o usar otra. El contrato de capacidades traduce verbos del dominio —inspeccionar cuota, validar blueprint, desplegar— a herramientas reales del host, sin esconder dependencias. El contrato de autoridad mantiene credenciales y políticas fuera del paquete, y exige una aprobación explícita para acciones consecuenciales. Esos cuatro contratos evitan que portabilidad signifique copiar autoridad o activar instrucciones fuera de contexto.

Los tres restantes cierran el ciclo. Evaluación compara los mismos fixtures e invariantes en todos los hosts soportados. Observabilidad conserva la versión de skill, entradas relevantes, herramienta resuelta, decisión de política, aprobación y resultado, con minimización de datos sensibles. Reversibilidad permite desactivar una versión, restaurar la anterior y saber qué ejecuciones fueron afectadas. Un README puede explicar estos principios; CI y el runtime deben hacerlos exigibles.

Contrato, evidencia mínima y fallo que debe bloquear promoción
ContratoEvidencia mínimaBloquear cuando
1. FuenteOwner, revisión, licencia y versiónEl origen o la revisión no son verificables
2. ActivaciónCasos de uso, exclusiones y ejemplos de routingLa misma solicitud activa skills incompatibles
3. CapacidadesMapa explícito entre intención y herramientaUna dependencia se resuelve por suposición
4. AutoridadPolítica local, mínimo privilegio y aprobaciónEl paquete amplía permisos del host
5. EvaluaciónFixtures, invariantes y matriz por hostUn host omite un gate o cambia el resultado
6. ObservabilidadSkill, versión, tool call, decisión y resultadoNo puede reconstruirse una acción
7. ReversibilidadPin, rollout gradual, kill switch y rollbackNo existe retorno probado a una versión segura
Portabilidad es equivalencia de intención bajo controles locales, no identidad de ejecución.

Capítulo 03

Skill, herramienta y permiso son capas distintas

La especificación abierta de Agent Skills define una carpeta con un SKILL.md obligatorio y recursos opcionales como scripts, referencias y assets. El agente descubre primero nombre y descripción, carga las instrucciones cuando la tarea coincide y solo después consulta recursos o ejecuta código. Esa divulgación progresiva reduce contexto innecesario, pero no crea una sandbox ni concede acceso. El paquete enseña cómo proceder; el host decide qué herramientas existen; la política decide si pueden usarse; y el sistema de identidad determina con qué alcance.

Por eso una skill que dice “despliega el clúster” no debería contener credenciales, asumir un binario global ni reinterpretar la disponibilidad de una herramienta como autorización. Declara la capacidad deploy-cluster y sus precondiciones. El adaptador del runtime puede resolverla a una herramienta estructurada, un script revisado o un flujo que termina en solicitud de aprobación. Si no puede demostrar cuota, región, blueprint, identidad y plan, debe devolver un estado bloqueado y evidencia faltante, no improvisar una ruta alternativa con más privilegios.

Capítulo 04

Ejemplo hipotético: una skill de despliegue en tres agentes

Imagina, de forma hipotética, una empresa que mantiene una skill para preparar un clúster de simulación. La fuente canónica describe el orden: inspeccionar cuotas, comprobar capacidad regional con un canary, seleccionar un blueprint aprobado, generar un plan, pedir aprobación y desplegar. En el agente A, quota-check y capacity-canary son tools nativas. En el agente B, un script revisado produce el mismo esquema JSON. En el agente C, no existe capacity-canary. La skill sigue siendo portable entre A y B porque ambos satisfacen el contrato de capacidad; en C debe detenerse antes del plan. Copiar el texto no convierte una dependencia ausente en compatibilidad.

Los tres hosts reciben el mismo fixture: región sin capacidad y cuota suficiente. La expectativa no es que produzcan frases iguales, sino que ninguno llegue a deploy, que ambos hosts compatibles emitan capacity_unavailable y que el evento incluya versión, región consultada y evidencia del canary. Otro fixture cambia el blueprint después de aprobar; la aprobación debe invalidarse. Un tercero simula timeout del deploy; el agente consulta estado con un identificador idempotente en vez de repetir la mutación. Esa suite prueba semántica y seguridad, no estilo de respuesta.

Capítulo 05

¿Cómo evitas que el empaquetado multiagente se desvíe?

GitHub publicó el 12 de noviembre una guía que mantiene skills/*/SKILL.md como fuente y genera artefactos específicos para Claude Code, Cursor y GitHub Copilot. El punto importante no es la lista de clientes, sino la dirección del flujo: una fuente produce adaptadores; los adaptadores no se editan como copias independientes. Un modo check en CI vuelve a generar y falla si el repositorio contiene salidas desactualizadas. Así, cambiar un gate en la fuente obliga a revisar todos los paquetes que lo materializan.

Aun así, generación no prueba equivalencia. El empaquetador puede conservar instrucciones y romper rutas relativas, variables de entorno, framing de un servidor o sintaxis de aprobación. Añade validaciones estáticas del manifiesto, arranque del paquete en cada host soportado y evaluaciones de comportamiento con fixtures compartidos. Publica una matriz clara: versión de la fuente, versión del adaptador, runtime probado y fecha. Si un cliente no soporta una capacidad crítica, marca esa combinación como no soportada; no escondas el gap detrás de una instrucción en lenguaje natural.

Capítulo 06

¿Qué debes evaluar antes de promover una skill?

Empieza con routing: solicitudes positivas, negativas y ambiguas deben activar la skill correcta o escalar. Continúa con lectura: referencias requeridas cargadas, referencias irrelevantes omitidas y ninguna ruta fuera del paquete. Luego evalúa planificación contra un estado conocido. La salida debe enumerar precondiciones, distinguir observación de mutación y no inventar flags. Para acciones consecuenciales, prueba rechazo por falta de permiso, aprobación caducada, cambio del recurso después de aprobar, redelivery, timeout y resultado parcial. Exige que cada host preserve los mismos invariantes aunque sus tools difieran.

Promueve por etapas: validación estática, entorno sin credenciales, sandbox con recursos desechables, shadow mode contra solicitudes reales anonimizadas y un canary con límites estrictos. Compara fallos por categoría, no solo una tasa agregada: routing incorrecto, herramienta equivocada, argumento inválido, gate omitido, mutación duplicada y trazabilidad incompleta. Define antes del rollout qué señal detiene la versión y ensaya el rollback. Una mejora en respuestas felices no compensa perder una aprobación o duplicar una acción.

  • Todas las mutaciones tienen preflight, aprobación vigente e idempotencia.
  • Cada host soportado pasa los mismos invariantes con sus adaptadores reales.
  • Cada ejecución puede atribuirse a una versión y reconstruirse sin exponer secretos.
  • El rollback fue probado antes de necesitarlo.

Capítulo 07

La decisión: estandariza conocimiento, localiza autoridad

Adopta una skill compartida cuando el procedimiento sea estable, repetido y suficientemente valioso para sostener owner, pruebas y versiones. Mantén fuera del paquete credenciales, decisiones de acceso y detalles que pertenecen al runtime. Si un flujo todavía cambia cada semana o depende de intuición no documentada, primero conviértelo en un runbook observable. Si requiere una herramienta exclusiva de un host, declara esa dependencia en vez de vender portabilidad nominal. El objetivo es reducir divergencia de procedimiento sin crear una falsa equivalencia de seguridad.

El avance de Google Cloud importa porque muestra skills operando cerca de infraestructura costosa con validación, aprobación y trazabilidad explícitas. La lección para un CTO no es instalar más carpetas de prompts. Es tratar cada skill como una dependencia de producción: fuente verificable, capacidades resueltas, autoridad local, evaluación cruzada, observabilidad y rollback. Wasyra puede ayudarte a diseñar esa capa para agentes a medida sin confundir el servicio de implementación con el producto Agents.

Escrito por

Wasyra Lab

Arquitectura de sistemas IA y operaciones

Wasyra Lab publica marcos prácticos para diseñar agentes de IA, automatizaciones y flujos operativos que sí sobreviven producción.

Agentes IAGuardrailsOperaciones
Más de este autor

Serie

Sistemas IA que sí llegan a producción

Una serie sobre agentes, copilots y guardrails para llevar IA al trabajo real sin romper confianza ni operación.

Posts de esta serie

Sigue leyendo

Sigue leyendo