Formato oficial de Anthropic

AI Studio guarda las skills, los agentes y los comandos en el formato oficial que usa Anthropic para Claude Code. Por eso puedes importar lo que ya tienes y descargar lo que creas sin convertir nada.

Los tres comparten la misma idea: un archivo Markdown que empieza con un bloque YAML (la cabecera, entre dos líneas ---) y sigue con las instrucciones. En el editor no hace falta escribir ese bloque a mano: el formulario lo rellena por ti.

Skills

Una skill es una carpeta con, al menos, un archivo SKILL.md. Puede llevar subcarpetas con scripts, documentos de referencia o recursos.

• SKILL.md: la cabecera y las instrucciones. Es lo que lee Claude.
• scripts/: scripts opcionales. AI Studio los guarda y los incluye en el ZIP, pero no los ejecuta.
• references/: documentos que Claude puede consultar cuando activa la skill.
• assets/: plantillas, imágenes y otros archivos de apoyo.

Los archivos adjuntos de una skill se ven y se gestionan en la pestaña Archivos de su ficha.

Cabecera de SKILL.md

---
name: auditor-verifactu
description: Audita facturas según VeriFactu y devuelve un informe con los errores encontrados.
allowed-tools:
  - Read
  - Grep
---

nametextoobligatorio

Identificador en minúsculas con guiones.

descriptiontextoobligatorio

Qué hace la skill y cuándo debe activarse. Claude la lee para decidir si la usa.

allowed-toolslista

Herramientas que la skill puede usar en un entorno que las ofrezca, como Claude Code.

Tras la cabecera van las instrucciones en Markdown: pasos, ejemplos de entrada y salida, enlaces a los archivos de references/ ([guía](references/guia-estilo.md)) y bloques de código.

Agentes

Un agente es un único archivo .md cuyo cuerpo son las instrucciones del subagente.

---
name: revisor-contratos
description: Revisa contratos y marca cláusulas de riesgo con una redacción alternativa.
tools:
  - Read
  - Grep
model: inherit
---

nametextoobligatorio

Identificador del agente.

descriptiontextoobligatorio

Para qué sirve y cuándo debe usarse. El editor pide al menos 80 caracteres.

toolslista

Herramientas a las que tiene acceso. En el editor se eligen en «Herramientas del agente».

modeltexto

Modelo preferido. Se elige en «Modelo de IA», dentro de las opciones avanzadas.

En el cuerpo conviene describir el papel del agente, su objetivo, lo que no debe hacer y el formato de respuesta esperado. El color del activo no va en la cabecera: es el campo Color de acento de la ficha.

Comandos

Un comando es un archivo .md corto y parametrizable, como los comandos de barra de Claude Code (/resumir-reunion).

---
name: resumir-reunion
description: Redacta un acta con puntos tratados, decisiones y tareas a partir de la transcripción.
---

El cuerpo es el propio texto del comando y admite variables {{nombre_variable}}, igual que los prompts.

Requisitos al activar y al guardar

• Para activar un activo, la cabecera debe tener name (y, en skills y agentes, también description). Si faltan, AI Studio los completa con el nombre y la descripción de la ficha.
• Declarar la herramienta Bash en tools o en allowed-tools desde el editor solo lo puede hacer un Super Administrador. Al importar un ZIP se respeta lo que trae, salvo el comodín Bash(*), que se rechaza.
• El editor revisa el texto y te avisa si faltan tildes o si hay emojis.

Llevar un activo a Claude Code

Una skill o un agente de AI Studio funciona en Claude Code sin tocar nada:

Buenas descripciones

La description decide cuándo se activa una skill o un agente. Una descripción vaga hace que Claude no la use o la use cuando no toca.

• Di qué hace en una frase corta.
• Di cuándo debe activarse («cuando el usuario pida...»).
• Evita frases vacías como «herramienta muy útil».

Siguiente paso

Mira cómo se conectan los activos con el resto de UTILIA OS en Integración con el ecosistema.