# Habilidades (Skills)

> Instala Skills en un Agent para que domine herramientas, procesos y reglas de negocio.

Source: https://docs.syfo.ai/es/docs/skills

## Qué es una Skill

Una Skill (habilidad) es una descripción de capacidades para un Agent. Le indica qué herramientas puede usar, qué proceso debe seguir, cómo conectarse a los sistemas de la empresa y, a veces, incluye scripts o configuración.

El Agent es un miembro del equipo; las Skills son las capacidades que puede usar. Las Skills se instalan en la computadora donde se ejecuta el Agent y las carga el runtime que usa el Agent (Claude Code, Codex, etc.).

## Cuándo necesitas una Skill

Si solo quieres que el Agent lea el contexto del canal, ordene textos o redacte propuestas, normalmente no necesita Skills adicionales.

Considera instalarle Skills en estos casos:

-   Necesita acceder a sistemas externos como Feishu, CRM, ERP, BI, sistemas de tickets o bases de datos.
-   Necesita un flujo de trabajo fijo, como recopilar inteligencia de mercado cada día, generar informes semanales o hacer revisiones de código.
-   Debe cumplir normas del proyecto, como guías de estilo de frontend, convenciones de commits o el proceso de publicación.
-   Necesita llamar a herramientas de línea de comandos (CLI), API, MCP o scripts internos de la empresa.

Si solo quieres conectar un servicio de herramientas externo, también puedes gestionarlo de forma centralizada con [conexiones MCP](https://docs.syfo.ai/es/docs/mcp-connections) y activarlo para los Agents que lo necesiten.

## Cómo instalarlas

Syfo todavía no tiene un mercado de Skills integrado. Para añadir una Skill a un Agent, explica el objetivo en la conversación y deja que el Agent la instale, configure y verifique por sí mismo.

### Instalar la Skill de guía de uso de Syfo

Envía esto a tu Agent por mensaje directo:

```text
@research-assistant instala https://syfo-docs.tool.reorc.cloud/skill.md y, de ahora en adelante, úsala primero cuando respondas preguntas sobre Syfo
```

Una vez instalada, el Agent consultará primero esta Skill al responder preguntas sobre el uso de Syfo, el diseño de canales, el avance de tareas o la colaboración en equipo.

### Instalar otras Skills

En el canal donde está el Agent, o por mensaje directo, explica qué quieres hacer:

```text
@research-assistant necesito que instales una Skill de mensajes de Feishu para leer chats de grupo concretos, ordenar las preguntas de clientes y escribirlas en una tabla multidimensional.
Si necesitas permisos o configuración, enuméralos primero para que yo los confirme.
```

El Agent debería decirte primero:

-   el nombre de la Skill que va a instalar o activar;
-   a qué sistemas necesita acceder;
-   qué API Key, sesión iniciada o archivo de configuración necesita;
-   qué datos va a leer y escribir;
-   qué operaciones requieren confirmación de una persona.

Cuando confirmes, el Agent completa la instalación, la configuración y la verificación en su computadora. Si hace falta una clave, no la pegues en la conversación: usa la [bóveda](https://docs.syfo.ai/es/docs/vault).

### Si ya tienes scripts, CLI o flujos de trabajo

Muchos equipos ya tienen sus propios prompts, scripts, CLI, MCP o flujos de Codex. No hace falta reescribirlos de inmediato:

1.  Pide al Agent anterior o a un compañero que haga una lista de las capacidades existentes.
2.  Ordénalas por escenario de negocio: cuáles son de seguimiento de clientes, cuáles de desarrollo y cuáles de análisis de datos.
3.  Pide al Agent en Syfo que instale o referencie esas capacidades una por una.
4.  Verifica entradas, salidas, permisos y manejo de errores con una tarea real.

Si esas capacidades dependen de archivos locales, de una sesión iniciada en el navegador o de la red interna de la empresa, haz que el Agent se ejecute en una computadora que tenga acceso a esos recursos.

## Comprobar en la pestaña "Skills"

Abre la pestaña "Skills" en la página de detalles del Agent para ver el catálogo de Skills que informa la computadora del Agent. Está dividido en dos grupos, "Workspace" (espacio de trabajo) y "Global", y también puedes buscar.

-   Una vez instalada, la Skill debería aparecer aquí. Si no aparece, pide al Agent que compruebe si la ubicación de instalación es correcta.
-   El catálogo de Skills lo informa la computadora del Agent. Si la computadora está desconectada, la lista puede aparecer vacía.

Junto a ella, en la página de detalles del Agent, está la pestaña "MCP", donde se activan las conexiones MCP. Consulta [Conexiones MCP](https://docs.syfo.ai/es/docs/mcp-connections).

## Asignar Skills por función

No instales todas las Skills en un solo Agent; es mejor separarlas por función:

-   Agent de feedback de clientes: registros de Feishu / WeChat, tablas multidimensionales, reglas de clasificación.
-   Agent de desarrollo: repositorio de código, comandos de prueba, reglas de revisión de código.
-   Agent de marketing: búsqueda, extracción de datos, plantillas de informes.
-   Agent de operaciones: proceso de publicación, calendario de contenidos, reglas de aprobación.

Así los permisos quedan más claros y es más fácil localizar un problema. Para proyectos sensibles, crea un Agent y un canal aparte y, si hace falta, usa una computadora aparte; activa las conexiones MCP solo para los Agents que las necesitan.

## Límites de seguridad

Antes de instalar una Skill, confirma tres cosas:

-   qué datos va a leer;
-   qué sistemas va a escribir o modificar;
-   quién confirma y revierte si algo sale mal.

Enviar correos, publicar hacia fuera, hacer pagos, eliminar, cambiar producción o asumir compromisos con clientes: para este tipo de operaciones, el Agent debe preparar primero la información de confirmación y ejecutarlas solo después de que una persona las apruebe. Consulta [Aprobaciones](https://docs.syfo.ai/es/docs/approvals).

Los compañeros de primera línea pueden empezar con Skills de bajo riesgo, como ordenar preguntas de clientes, informes diarios o plantillas de informes. Las Skills que escriben en sistemas internos o asumen compromisos con clientes requieren que un administrador confirme los permisos.