Skills de Siri: Apple adopta el formato SKILL.md

Las skills de Siri usan SKILL.md, el mismo formato que los agentes de código. Qué abrió Apple el 3 de noviembre y por qué la seguridad sigue yendo en el código.

Siri también lee SKILL.md

El 3 de noviembre de 2026 Apple abrió un Developer Preview: cualquier app puede integrar su contenido y sus acciones con Siri AI a través de App Intents, en las betas de iOS, iPadOS, macOS y visionOS 27.3. Para las peticiones que necesitan varias acciones, introducen las skills de Siri, que Apple llama app skills. Y aquí viene lo que me ha llamado la atención: cada skill es una carpeta con un SKILL.md.

Si trabajas con agentes de código, ese nombre te suena. Es el mismo patrón de Agent Skills que ya usamos para enseñar a un agente cómo hacer una tarea compleja. Apple lo dice en la documentación: un subconjunto del formato Agent Skills. Un fichero, dos runtimes: el asistente del teléfono y el agente que escribe código.

No lo he probado en la beta. Lo que sigue es lo que cuentan el anuncio de Apple, su documentación de app skills y un recorrido técnico de Gabriel Anhaia, más mi lectura de qué implica para quien construye agentes y apps.

App Intents como tools, skills como guía

La pieza básica es marcar un App Intent con @AppIntent(.tool). Ese intent pasa a ser una herramienta que Siri puede elegir mientras atiende una petición. El título y la descripción del intent (y de cada parámetro) son ahora el esquema que lee el modelo: hay que escribirlos para que un modelo los distinga, no para una pantalla de ajustes.

Cuando una petición pide varios pasos, entra el skill. Añades un Skills.skillsbundle por target y, dentro, una carpeta por skill con su SKILL.md. El frontmatter solo admite name (1 a 64 caracteres: minúsculas, dígitos y guiones; tiene que coincidir con el nombre de la carpeta) y description (una línea, hasta 1.024 caracteres). El cuerpo, como máximo 10.000 caracteres. Sin scripts, sin references, sin otros ficheros al lado. Más estrecho que el formato Agent Skills completo.

Apple pide referirse a los intents por lo que hacen (su ejemplo es “la herramienta del tiempo” en lugar de GetWeatherIntent), no por el nombre de la clase. Siri lee el frontmatter para decidir si aplica el skill y carga el cuerpo después. La descripción hace el enrutado: si es vaga, el skill puede no entrar nunca.

9to5Mac recoge un ejemplo de la documentación en el que se le pide a Siri que envíe a tu pareja tus zapatillas favoritas a través de una app de mensajería (traducción mía; el original es “Hey Siri, send my favorite sneakers to my partner”). Siri encuentra el contenido en una app, entiende quién es la pareja, lo localiza en Contactos y lo envía. Según el recorrido de Anhaia, tampoco hace falta nombrar la app si está en primer plano o tiene una Live Activity activa.

La guía no obliga a nada

Aquí está, para mí, la lección que más me importa. Apple lo deja por escrito: no puedes usar app skills para imponer un comportamiento determinista, y Siri no ejecuta los intents en una secuencia fija. El SKILL.md es una guía. El modelo elige el camino.

Eso es exactamente lo mismo que vemos con AGENTS.md y con los guardrails de agentes de código. La regla escrita ayuda, pero lo crítico va en el código. En App Intents eso significa authenticationPolicy (por ejemplo exigir autenticación local en un saldo bancario), políticas a nivel de intent cuando se devuelven datos sensibles, y visibility: .internal en propiedades que Siri y Shortcuts no deben ver. El valor por defecto importa: las entidades no exigen autenticación hasta que tú la pones.

Si estás añadiendo @AppIntent(.tool) a intents escritos antes de que Siri pudiera llamarlos, revisa esas entidades primero. Lo conté en el mismo sentido en guardrails para agentes de código: la instrucción orienta, y el control en el código es lo que de verdad protege.

Evalúas porque el modelo elige

Como el camino no es fijo, Apple mete en la beta Siri Evaluations y el Siri Integration Advisor en Xcode. Puedes scriptar escenarios de varios turnos y comprobar qué intents se llaman, qué entidades se encuentran, qué skills se cargan y qué dice Siri. Las respuestas pueden variar entre ejecuciones, así que hay que correr el juego más de una vez.

Eso es una suite de evals. Es el hábito correcto para cualquier función en la que un modelo decide qué código ejecuta. Si ya registras lo que hace tu agente, como defendía en monitorizar agentes, este marco te resultará familiar: no asumas el camino, mídelo.

Un formato, dos runtimes (y un subconjunto más estrecho)

Lo que me llevo, con opinión mía encima:

  • Apple adopta el patrón Agent Skills. No inventa otro lenguaje de “cómo combinar acciones”. Reutiliza SKILL.md. Eso baja la fricción mental para equipos que ya escriben skills para agentes de código.
  • Es un subconjunto más estrecho. Solo name y description en el frontmatter, un cuerpo corto y sin scripts ni referencias. Un mismo fichero no servirá tal cual para Claude Code y para Siri sin adaptar.
  • La skill orienta; el código decide. La autenticación, las comprobaciones y la visibilidad van en el intent y en la entidad, no en el Markdown. Igual que con llamadas programáticas a herramientas: el modelo propone y tu runtime acota.
  • Sin evals, no sabes qué hace. Si Siri (o tu agente) elige el camino, un checklist de “funciona en mi demo” no basta.

El preview es temprano: builds firmados para desarrollo y TestFlight interno. Apple dice que Siri AI llegará a clientes en unos meses y que el envío a la App Store se abre en primavera. Siri AI está en inglés, francés, japonés, coreano, portugués y español; no está disponible en la UE en iOS, iPadOS y watchOS; no para menores de 13; y hay límites diarios en funciones que dependen de modelos en la nube. Los términos de uso detallados, dice Apple, vendrán después.

Si construyes agentes y apps a la vez

Para mí el anuncio no es “Siri se pone al día”. Es que el formato con el que ya enseñamos a los agentes de código empieza a aparecer en el asistente del teléfono, con las mismas reglas de oro: describe bien las tools, guía los flujos de varios pasos, protege en código lo que no puede fallar y evalúa porque el modelo elige.

En onext ayudamos a equipos a adoptar agentes con una metodología clara. Si quieres revisar cómo encajan skills, herramientas y controles en tu producto, escríbenos.

Fuentes

  1. Siri AI is now open to all developers - Latest News - Apple Developer (se abre en una pestaña nueva)
  2. Orchestrating complex actions with app skills | Apple Developer Documentation (se abre en una pestaña nueva)
  3. Siri AI Opens to Every App in the iOS 27.3 Beta. Its App Skills Are SKILL.md Files (se abre en una pestaña nueva)
  4. Developers can now create advanced 'app skills' for Siri AI - 9to5Mac (se abre en una pestaña nueva)

Etiquetas

Más artículos de Herramientas