Skills

Una skill es el método de trabajo de tu empresa escrito para un agente: los pasos de una tarea, las reglas que hay que respetar y el formato del resultado. Puede llevar archivos de apoyo, como ejemplos, tablas o plantillas. La escribes una vez y la conectas a todos los agentes que la necesiten, en lugar de repetirla en el prompt de cada uno.

Cómo la usa el agente

El agente no lee todas sus skills enteras en cada paso. Al empezar solo ve el nombre y la descripción de cada una. Cuando un encargo coincide con una descripción, abre esa skill, la lee completa y la sigue. Gracias a eso puedes conectar varias skills a un agente sin que se haga más lento ni más caro.

Por eso la descripción es lo más importante de una skill: si no dice para qué sirve, el agente no sabrá cuándo abrirla.

Dónde se crean

Tus skills, en Mis Skills (dentro de Configuración). Puedes escribir la instrucción en la propia página o subir una skill ya hecha en un .zip o .skill. Ver Mis Skills. En el flujo se conectan con Stored Skill.
Skills de NappAI, ya preparadas para servicios y tareas habituales: Slack, WhatsApp y Telegram, Google Workspace, Microsoft 365, HubSpot, Jira, comercio electrónico, análisis de datos, investigación y otras. Están en la familia Skills de la paleta (ManagedSkill).

En los dos casos, la salida Skills del componente se conecta a la entrada Skills del Deep Agent, que aparece al activar Enable Skills.

En un agente de voz

Las mismas skills sirven para un Voice Agent: activa Enable Skills en su pestaña Avanzado y conéctalas al conector Skills que aparece. El agente funciona igual que con el Deep Agent: ve los nombres y las descripciones y abre una skill cuando lo que pide el llamante encaja con ella. Hay tres diferencias:

Solo lee los textos de la skill. En una llamada no se ejecuta ningún script.
Lo que lee se queda con él el resto de la llamada, así que no la vuelve a abrir.
La primera vez que usa una skill en una llamada tarda un poco más en responder ese turno, normalmente menos de un segundo.

Para la voz conviene que la skill sea corta y vaya al grano: los pasos, las reglas y los datos que el agente tiene que decir. El Voice Agent Realtime no admite skills.

Cómo escribir una buena skill

Un nombre y una descripción que digan cuándo usarla. «Método de la casa para proponer el nombre de un negocio nuevo y comprobar sus dominios» funciona; «naming» no.
Pasos numerados y en orden. El agente los convierte en su plan de trabajo.
Reglas concretas y comprobables. «Dos palabras unidas, fáciles de pronunciar en español y en inglés» se cumple o no se cumple; «un nombre bonito» no se puede comprobar.
Qué hacer cuando algo sale mal. «Si los dos dominios están ocupados, cambia ese nombre por otro y compruébalo también.» Sin esta frase, el agente entrega lo que encontró aunque no sirva.
Qué hacer cuando una herramienta falla. «Si una comprobación da error, escribe “sin comprobar”: nunca lo des por libre ni por ocupado.» Un modelo tiende a rellenar el hueco con lo más probable; una regla así lo obliga a decir lo que de verdad sabe.
El formato de la entrega. Secciones, columnas de una tabla, extensión. Así todos los informes salen iguales.
Las herramientas, por lo que hacen, no por su nombre técnico. «Busca en internet» y «comprueba los dominios» valen aunque mañana cambies de buscador.
Una tarea por skill. Si una skill empieza a explicar dos trabajos distintos, divídela en dos.

Una skill tiene esta forma (es la del ejemplo):

# Estudio de nombre

Cuando te pidan el nombre de un negocio nuevo, sigue estos pasos en este orden:

1. Busca en internet tres negocios parecidos de la misma ciudad, para no repetir ni imitar sus nombres.
2. Propón cinco nombres de dos palabras unidas, fáciles de pronunciar en español y en inglés, sin el nombre de la ciudad.
3. Comprueba los dominios .com y .net de cada nombre, escrito en minúsculas, sin espacios ni tildes. Si los dos están ocupados, cambia ese nombre por otro y compruébalo también, hasta tener cinco nombres con algún dominio libre. Si una comprobación da error, escribe «sin comprobar»: nunca lo des por libre ni por ocupado.
4. Entrega el informe con este formato:
   - **Competencia**: los tres negocios encontrados, una línea cada uno.
   - **Nombres**: una tabla con las columnas Nombre, .com, .net y Por qué funciona.
   - **Recomendación**: el nombre con más dominios libres y una frase con el motivo.

Skills y prompt: qué va en cada sitio

En el System Prompt del agente	En una skill
Quién es el agente y para quién trabaja	Cómo se hace una tarea concreta
Reglas que valen para todo (idioma, no inventar datos)	Pasos, reglas y formato de esa tarea
«Antes de empezar, mira si una skill explica la tarea y síguela»	Lo que se repite en varios agentes

Un prompt corto y varias skills bien descritas dan agentes más fáciles de mantener: para cambiar cómo se hace una tarea, cambias la skill y todos los agentes que la usan lo aplican en su siguiente ejecución.