# Enseñar UTILIA OS a tu asistente con una skill

Instala en tu asistente las skills de UTILIA OS, la del día a día y la de migración, para que trabaje en UTILIA OS como lo harías tú.

Una skill es un manual que le das a tu asistente: con ella trabaja en UTILIA OS como lo harías tú. La conexión le da acceso a tus datos; la skill le explica cómo se conecta todo, qué paso va después de cada cosa y qué puedes hacer tú con tu plan y tus permisos. Así no tienes que explicárselo en cada conversación.

UTILIA OS tiene dos skills, y las dos son solo texto: no llevan programas ni se conectan a ningún sitio por su cuenta.

## Las dos skills

**Las skills de UTILIA OS**

### Día a día (Para todo el equipo)

Para que tu asistente trabaje en tus clientes, tus proyectos y tus facturas como lo harías tú: qué conexión usar para cada cosa, el siguiente paso de cada flujo, cómo subir archivos y las mejoras que te puede ofrecer. Lo explica [Usar la skill del día a día](https://os.utilia.ai/docs/guides/connect-ai/daily-skill).

### Migración y puesta en marcha (Para quien prepara la empresa)

Trae lo que tengas en otros programas o monta tu empresa desde cero, y deja listo todo UTILIA OS por fases que apruebas tú. Lo explica [Preparar tu empresa con la skill de migración](https://os.utilia.ai/docs/guides/getting-started/migration-skill).

La de migración solo te la ofrecemos si puedes preparar la empresa: si eres Super Administrador o tienes el permiso «Importar datos» o «Editar organización». Tu asesoría ve solo la del día a día.

## Antes de empezar

- **Tu asistente conectado** al menos a un área de UTILIA OS, como explica [Cómo conectar](https://os.utilia.ai/docs/guides/connect-ai/overview#cómo-conectar). La skill no da acceso a nada: sin conexión, tu asistente sabe cómo funciona UTILIA OS, pero no puede tocar tus datos.
- **El permiso «Conectar asistentes de IA externos»**, el mismo que hace falta para conectar.
- **Un ordenador.** Las skills se instalan desde el ordenador, no desde el móvil.

## Dónde se descargan

- **En Prepara tu asistente**, la forma más rápida. En **Ajustes › Integraciones › Conecta tu IA** o en **Mi perfil › IA y aplicaciones**, pulsa **Preparar mi asistente**: eliges tu asistente y para qué lo quieres, lo conectas, instalas la skill con los pasos de tu asistente y compruebas que funciona, todo en la misma pantalla.
- **En «Preparar mi espacio»**: el apartado **Conecta tu IA** de cada persona abre Prepara tu asistente con la del día a día, y el apartado **Importar datos** de la empresa, con la de migración.
- **En Importar datos**, al elegir **Con tu asistente de IA**: abre Prepara tu asistente con la de migración y te devuelve a la importación al terminar.
- **Aquí**: [la del día a día (ZIP)](https://os.utilia.ai/docs/skills/utilia-os.zip) y [la de migración y puesta en marcha (ZIP)](https://os.utilia.ai/docs/skills/utilia-migracion.zip).

En la aplicación del móvil no se descargan: Prepara tu asistente te deja enviarte el enlace al ordenador, que es donde se instalan.

## Instalarla en tu asistente

**¿Dónde instalas la skill?**

¿Usas Claude?

- Sí: ¿Para ti o para toda tu empresa?
  - Para mí: ¿En la aplicación o en la terminal?
    - En la aplicación: **Súbela a Claude**. En la web o en la aplicación de escritorio, desde el ZIP.
    - En la terminal: **Cópiala en Claude Code**. En tu carpeta de skills.
  - Para toda la empresa: **Súbela a la organización**. En Claude Team o Enterprise; la sube quien es propietario.
- No: ¿Tu asistente admite skills?
  - Sí: **Súbela igual**. El formato de las skills es abierto.
  - No: **Pégala en sus instrucciones**. El contenido de SKILL.md.

Los menús de Claude salen en el idioma que tengas puesto. Aquí van en castellano y, cuando ayuda, en inglés entre paréntesis.

### En Claude, en la web o en el escritorio

Vale para los planes Free, Pro, Max y Ultra.

1. **Activa la creación de archivos**

   En **Ajustes › Capacidades** (Settings › Capabilities), activa **Ejecución de código y creación de archivos**. En el diseño nuevo de Claude se llama **Crear y editar archivos**.
2. **Abre la subida de skills**

   En **Personalizar › Skills** (Customize › Skills), pulsa **+**, **Crear skill** y **Subir una skill**.
3. **Elige el ZIP**

   Elige el archivo tal como lo descargaste, sin descomprimirlo.
4. **Déjala activada**

   Queda en tu lista de skills. Mientras esté activada, Claude la usa cuando le pides algo de UTILIA OS.

### En Claude Team y Enterprise, para toda la empresa

Solo pueden hacerlo los propietarios de la organización en Claude.

1. **Activa las skills en la política**

   En **Ajustes de la organización › Plugins y skills**, pestaña **Política**, activa **Ejecución de código en la nube y creación de archivos** y **Skills**. En Team ya vienen activadas.
2. **Sube la skill**

   Pulsa **Añadir** y **Subir una skill**, y elige el ZIP sin descomprimirlo.

Llega a todas las personas de la organización, que pueden desactivarla para sí. También se sincroniza con Claude Code.

### En Claude Code

Descomprime el ZIP en tu carpeta de skills personales. En macOS y Linux, con el ZIP en tu carpeta de descargas:

```bash
unzip ~/Downloads/utilia-os.zip -d ~/.claude/skills/
unzip ~/Downloads/utilia-migracion.zip -d ~/.claude/skills/
```

En Windows, en PowerShell:

```powershell
Expand-Archive "$HOME\Downloads\utilia-os.zip" -DestinationPath "$HOME\.claude\skills"
Expand-Archive "$HOME\Downloads\utilia-migracion.zip" -DestinationPath "$HOME\.claude\skills"
```

Usa solo la línea de la skill que hayas descargado y, si guardaste el ZIP en otra carpeta, cambia la ruta. Si prefieres que la vea un único proyecto, descomprímela en la carpeta `.claude/skills/` de ese proyecto. Claude Code la encuentra en la siguiente sesión que abras.

### En otros asistentes

Si tu asistente admite skills, súbela igual: el formato SKILL.md es abierto. Si no las admite, descomprime el ZIP, abre `SKILL.md` y pega su contenido en las instrucciones de tu asistente, las de un proyecto o las personalizadas. Si más adelante te pide un documento de la carpeta `references/`, pégaselo también.

## Comprobar que tu asistente la usa

No tienes que comprobarlo a mano: al empezar, la skill le pide a tu asistente que pregunte a UTILIA OS qué puede hacer con tu conexión. Con esa pregunta, UTILIA OS sabe que ya la usas y con qué versión.

**Cómo sabe UTILIA OS que la usas**

Participantes: Tú, Tu asistente y UTILIA OS.

1. Tú → Tu asistente: Le pides algo de UTILIA OS. Por ejemplo: «¿Qué tengo hoy en UTILIA OS?».
2. Tu asistente → UTILIA OS: Pregunta qué puede hacer tu conexión. Lo pide la skill, con su nombre y su versión.
3. UTILIA OS → Tu asistente (respuesta): Lo que puede hacer y lo que le falta. Según tu plan y tus permisos.
4. UTILIA OS (por su cuenta): Anota que usas esa skill y su versión.
5. UTILIA OS → Tú: «Tu asistente ya la usa». En Conecta tu IA, con la versión.

En Conecta tu IA, la tarjeta **Enséñale UTILIA OS a tu asistente**, la primera de la pantalla, dice cómo va, y en Prepara tu asistente lo ves encenderse en el momento:

- **Tu asistente ya la usa**, con su versión: lo ha notado UTILIA OS. Si tienes la pantalla abierta, lo verás en cuanto pase.
- **Instalada**: la marcaste tú con **Ya la tengo instalada**, y tu asistente aún no la ha usado con UTILIA OS.
- **Hay una versión nueva**: la que usa tu asistente, o la que marcaste como instalada, es anterior a la de ahora.
- Si todavía no has conectado tu asistente, Prepara tu asistente empieza por ahí. Si ya lo está, ese paso sale hecho: ábrelo para ver a qué áreas está conectado y, con **Conectar más áreas**, añadir las que falten.

Lo ve cada persona en su Conecta tu IA: que tu asistente use una skill no dice nada de los de tus compañeros.

## Ponerla al día

Las skills cambian cuando cambia UTILIA OS. Cuando hay una versión nueva, Conecta tu IA te lo dice con **Hay una versión nueva**; en **Preparar mi asistente** la descargas. Después, sustituye la anterior en tu asistente:

- **En Claude**, súbela como la primera vez y deja activada solo la nueva.

- **En Claude Code**, descomprímela encima de la anterior, con el nombre de su ZIP. En macOS y Linux:

  ```bash
  unzip -o ~/Downloads/utilia-os.zip -d ~/.claude/skills/
  ```

  En Windows, en PowerShell:

  ```powershell
  Expand-Archive -Force "$HOME\Downloads\utilia-os.zip" -DestinationPath "$HOME\.claude\skills"
  ```

- **En otros asistentes**, pega el contenido nuevo de `SKILL.md` en lugar del anterior.

La próxima vez que tu asistente la use, Conecta tu IA vuelve a decir **Tu asistente ya la usa**, con la versión nueva.

## Si algo falla

- **Claude no acepta el ZIP.** Comprueba que tienes activada la ejecución de código y la creación de archivos y súbelo sin descomprimir. Si lo descomprimiste y lo volviste a comprimir, la carpeta `utilia-os` o `utilia-migracion` tiene que quedar en la raíz, con `SKILL.md` dentro.
- **No ves Subir una skill en los ajustes de la organización.** Solo lo tienen los propietarios de la organización en Claude. Pídeselo a quien lo sea, o súbela para ti en **Personalizar › Skills**.
- **Tu asistente no usa la skill.** Nómbrala en el mensaje: «Usa la skill utilia-os» o «Usa la skill utilia-migracion». En Claude, comprueba que está activada.
- **Conecta tu IA no dice «Tu asistente ya la usa».** Tu asistente aún no la ha usado con una conexión de UTILIA OS. Pídele algo de UTILIA OS nombrando la skill. Si ya lo has hecho, marca **Ya la tengo instalada** para que deje de proponértela.
- **Conectaste UTILIA OS desde el directorio de Claude o de ChatGPT.** Con esa conexión, UTILIA OS no puede notar que tu asistente usa la skill. Márcala tú con **Ya la tengo instalada**.
- **No ves Enséñale UTILIA OS a tu asistente en Conecta tu IA.** Te falta el permiso «Conectar asistentes de IA externos» o tu plan no incluye ninguna área que puedas conectar. Una skill no sirve sin un área conectada.
- **No ves la skill de migración.** Es para quien prepara la empresa: Super Administrador, o con «Importar datos» o «Editar organización». Si te toca prepararla a ti, pide a quien administra tu organización que te dé uno de esos permisos.
- **Tu asistente dice que su conexión no puede hacer algo.** No es cosa de la skill: le falta un permiso de la conexión, de tu usuario o del plan. Lo explica [Si tu asistente necesita un permiso más](https://os.utilia.ai/docs/guides/connect-ai/overview#si-tu-asistente-necesita-un-permiso-más).

## Siguiente paso

- [Preparar tu empresa con la skill de migración](https://os.utilia.ai/docs/guides/getting-started/migration-skill): Trae lo que tengas en otros programas o empieza de cero, por fases que apruebas tú.
- [Migrar con tu asistente de IA](https://os.utilia.ai/docs/guides/getting-started/migrate-with-ai): El recorrido completo, fase a fase, con los mensajes para tu asistente.
