# Skills

> Cree, versione e implemente skills de IA reutilizables, prompts estructurados que se ejecutan sobre contactos, empresas, campañas y documentos.

Source: https://docs.graph8.com/es/studio/skills/

Las habilidades son bloques reutilizables de IA. Cada habilidad es un prompt con nombre y versión que puede ejecutarse desde cualquier registro, campaña o flujo de trabajo, lo que permite a su equipo obtener resultados consistentes sin reescribir prompts cada vez.

## Qué es una Habilidad

Una habilidad es:

- **Un prompt con nombre**, para que cualquier miembro del equipo pueda encontrarla y ejecutarla
- **Con plantillas**, con variables que se completan con los datos del registro sobre el que se ejecuta
- **Con versiones**: las ediciones generan versiones nuevas y las anteriores siguen funcionando para todo lo que las referencia
- **Con control de roles**: los administradores definen quién puede editar, ejecutar y publicar habilidades
- **Respaldada por su contexto**: cada habilidad recibe automáticamente el Contexto Global y los datos del registro activo

Considere las habilidades como GPTs internos, adaptados al conocimiento de su empresa y seguros para implementar en todo el equipo.

## Crear una Habilidad

1. Vaya a **Studio → Habilidades** y haga clic en **Nueva Habilidad**
2. Asígnele un nombre y una descripción
3. Elija el tipo de habilidad:

| Tipo | Se ejecuta sobre | Ejemplo |
|------|-----------------|---------|
| **Contacto** | Un único contacto | "Generar un mensaje de apertura en LinkedIn" |
| **Empresa** | Una única empresa | "Resumir noticias recientes de financiamiento" |
| **Oportunidad** | Una única oportunidad | "Redactar un correo de seguimiento tras la reunión de descubrimiento" |
| **Lista / Audiencia** | Una lista de contactos | "Puntuar cada contacto según nuestro ICP" |
| **Documento** | Un documento de Studio | "Reescribir esta página de destino para compradores enterprise" |
| **Ad-hoc** | Sin contexto de registro | "Escribir un correo en frío para una persona que pegaré aquí" |

4. Escriba el prompt con variables (ver más abajo)
5. Haga clic en **Guardar como borrador**
6. Pruébelo con un registro real antes de publicarlo

## Plantillas de Prompts

Las habilidades utilizan la sintaxis `{{variable}}` para referenciar datos de registros y contexto global.

### Variables de Registro

Variables habituales que puede utilizar:

| Variable | Valor |
|----------|-------|
| `{{contact.first_name}}` | Nombre del contacto |
| `{{contact.last_name}}` | Apellido del contacto |
| `{{contact.job_title}}` | Cargo |
| `{{contact.email}}` | Dirección de correo electrónico |
| `{{contact.linkedin_url}}` | URL de LinkedIn |
| `{{company.name}}` | Nombre de la empresa |
| `{{company.domain}}` | Dominio principal |
| `{{company.industry}}` | Industria |
| `{{company.employee_count}}` | Número de empleados |
| `{{company.description}}` | Descripción de la empresa |
| `{{deal.stage}}` | Etapa actual de la oportunidad |
| `{{deal.amount}}` | Tamaño de la oportunidad |
| `{{deal.close_date}}` | Fecha de cierre estimada |

### Variables de Contexto Global

| Variable | Valor |
|----------|-------|
| `{{global.brand_brief}}` | Su brief de marca en Studio → Global |
| `{{global.value_props}}` | Sus propuestas de valor |
| `{{global.icp}}` | Su definición de ICP |
| `{{global.personas}}` | Todos los perfiles de persona |
| `{{global.persona.vp_sales}}` | Un perfil de persona específico |
| `{{global.offer_brief}}` | Precios y empaquetado |

### Campos Personalizados

Cualquier campo personalizado de un registro es accesible mediante `{{contact.custom.field_name}}` o `{{company.custom.field_name}}`.

## Probar Habilidades

Antes de publicar una habilidad, pruébela con registros reales:

1. Abra el borrador de la habilidad
2. Haga clic en **Probar**
3. Seleccione un registro (contacto, empresa u oportunidad)
4. Ejecútela: el resultado aparece en el panel de pruebas
5. Ajuste el prompt y vuelva a ejecutarlo hasta obtener el resultado deseado

Las pruebas se registran, pero no afectan al registro (no se guardan notas ni se sincroniza con el CRM).

### Pruebas A/B de Prompts

Compare dos versiones de la misma habilidad antes de confirmar:

1. Haga clic en **Prueba A/B** en un borrador
2. Cree los prompts de la versión A y la versión B
3. Seleccione 10 registros
4. Ejecute ambas versiones
5. Compare los resultados en paralelo
6. Elija la ganadora: se convierte en la versión publicada

## Versiones

Cada edición de una habilidad publicada crea una versión nueva. Las versiones anteriores permanecen disponibles para:

- Flujos de trabajo que referencian versiones anteriores
- Registros de auditoría (quién ejecutó qué versión y cuándo)
- Revertir cambios si una versión nueva reduce la calidad

| Estado de la versión | Significado |
|----------------------|-------------|
| **Borrador** | Aún no publicada; solo el autor puede ejecutarla |
| **Publicada** | Activa; todos los usuarios habilitados pueden ejecutarla |
| **Obsoleta** | Oculta en el selector de habilidades, pero sigue ejecutándose para todo lo vinculado a esta versión |
| **Archivada** | Retirada por completo; no se permiten nuevas ejecuciones |

### Fijación de Versiones

Los flujos de trabajo y las secuencias pueden fijarse a una versión específica. Cuando publica una versión nueva, las referencias fijadas no se actualizan automáticamente: permanecen en su versión fijada hasta que usted las actualice explícitamente. Esto evita cambios de comportamiento inesperados.

## Publicación y Permisos

### Publicar una Habilidad

1. Con un borrador seleccionado, haga clic en **Publicar**
2. Establezca la visibilidad:
   - **Privada**: solo usted
   - **Equipo**: usuarios específicos
   - **Organización**: todos en su organización
3. Defina quién puede ejecutarla:
   - **Todos los usuarios habilitados**
   - **Roles específicos** (Administrador, Miembro, roles personalizados)
4. Haga clic en **Publicar**

### Controles de Roles

| Capacidad | Administrador | Miembro | Visor |
|-----------|--------------|---------|-------|
| Ejecutar habilidades publicadas | ✓ | ✓ | — |
| Crear borradores | ✓ | ✓ | — |
| Publicar | ✓ | Requiere aprobación del administrador | — |
| Editar habilidades de otros | ✓ | Solo con acceso de escritura compartido | — |
| Archivar habilidades | ✓ | — | — |

## Ejecutar Habilidades

Las habilidades aparecen en varios lugares:

| Ubicación | Comportamiento |
|-----------|---------------|
| **Página de detalle del contacto** | El ícono de rayo abre un selector de habilidades |
| **Página de detalle de la empresa** | El mismo selector, filtrado por habilidades de empresa |
| **Página de detalle de la oportunidad** | Solo habilidades de oportunidad |
| **Acción masiva en listas** | Ejecutar una habilidad sobre todos los contactos de una lista |
| **Paso de campaña** | Usar una habilidad como paso de una secuencia |
| **Disparador de flujo de trabajo** | Ejecutar una habilidad automáticamente cuando se cumple una condición |
| **Copilot** | "/nombre_habilidad" invoca la habilidad en el chat |

## Costo en Créditos

| Nivel del modelo | Costo por ejecución |
|-----------------|---------------------|
| Rápido | 1 crédito |
| Estándar | 3-5 créditos |
| Profundo (acceso web) | 10-20 créditos |
| Razonamiento | 15-40 créditos |

Configure el nivel del modelo en cada habilidad. El nivel Rápido es suficiente para plantillas simples; el nivel Profundo es necesario para habilidades con investigación intensiva; el nivel Razonamiento se usa para tareas de puntuación o análisis lógico.

## Solución de Problemas

| Problema | Solución |
|----------|----------|
| La habilidad produce resultados inconsistentes | Agregue más estructura al prompt: secciones explícitas, plantillas de formato o ejemplos few-shot |
| La variable aparece como `{{contact.x}}` en el resultado | El campo está vacío en ese registro: enriquézcalo primero o haga que la variable sea opcional |
| La habilidad supera el tiempo de espera | Reduzca el tamaño del contexto o cambie a un nivel de modelo más rápido |
| El resultado no coincide con la plantilla | Aumente el nivel del modelo; agregue "Responda exactamente en este formato:" al prompt |
| La habilidad publicada desapareció | Es posible que un administrador la haya archivado; revise la pestaña Archivadas |

> **Tip:**
> Construya una biblioteca de habilidades pequeñas y enfocadas en lugar de una habilidad única y extensa. "Generar un mensaje de apertura en LinkedIn" es mejor que "Gestionar toda la prospección": las habilidades pequeñas son más fáciles de probar, ajustar y combinar en flujos de trabajo.

## Relacionados

- [Copilot →](https://docs.graph8.com/studio/copilot/): las habilidades se pueden invocar directamente en el chat de Copilot
- [Ejecutar Acciones →](https://docs.graph8.com/studio/entity-action-execution/): cómo se ejecutan las habilidades desde las páginas de detalle
- [Flujos de Trabajo →](https://docs.graph8.com/ai-features/workflows/): ejecutar habilidades automáticamente mediante disparadores
- [Contexto Global →](https://docs.graph8.com/studio/global/): el contexto compartido que utiliza cada habilidad