Skills

Las skills son capacidades y conocimientos especializados que se asignan a los agentes para potenciar sus habilidades.

¿Qué es una skill?

Una skill es un módulo de conocimiento que:

• Define un área de expertise específica
• Proporciona contexto adicional al agente
• Puede incluir ejemplos y patrones
• Es reutilizable entre múltiples agentes

graph LR
    S1[Skill: Git] --> A1[Agente DevOps]
    S1 --> A2[Agente Backend]
    S2[Skill: SQL] --> A2
    S2 --> A3[Agente DBA]
    S3[Skill: Docker] --> A1
    S3 --> A2

Catálogo de skills

Ver todas las skills

1. Ve a Skills en el menú lateral
2. Verás una tabla con todas las skills disponibles

┌─────────────────────────────────────────────────────────────────┐
│ Skills                                              [🔄 Sync]   │
├─────────────────────────────────────────────────────────────────┤
│ 🔍 Buscar...                    Categoría: [Todas ▼]           │
├─────────────────────────────────────────────────────────────────┤
│ Nombre              │ Categoría    │ Descripción        │ Usos │
├─────────────────────┼──────────────┼────────────────────┼──────┤
│ git-operations      │ DevOps       │ Operaciones Git    │  8   │
│ sql-optimization    │ Database     │ Optimización SQL   │  5   │
│ docker-compose      │ DevOps       │ Docker Compose     │  4   │
│ api-design          │ Architecture │ Diseño de APIs     │  6   │
│ error-handling      │ Development  │ Manejo de errores  │ 12   │
└─────────────────────┴──────────────┴────────────────────┴──────┘

Columnas de la tabla

Columna	Descripción
Nombre	Identificador de la skill
Categoría	Área temática
Descripción	Breve explicación
Usos	Número de agentes que la utilizan

Categorías de skills

DevOps

Skills relacionadas con operaciones y despliegue:

• git-operations - Comandos y flujos Git
• docker-compose - Orquestación de contenedores
• ci-cd-pipelines - Integración y despliegue continuo
• kubernetes - Orquestación Kubernetes

Database

Skills de bases de datos:

• sql-optimization - Optimización de consultas
• postgresql - Específico de PostgreSQL
• migrations - Migraciones de esquema
• indexing - Estrategias de indexación

Architecture

Skills de arquitectura de software:

• api-design - Diseño de APIs REST/GraphQL
• microservices - Patrones de microservicios
• clean-architecture - Arquitectura limpia
• domain-driven-design - DDD

Development

Skills de desarrollo:

• error-handling - Manejo de errores
• logging - Estrategias de logging
• testing - Testing y TDD
• code-review - Revisión de código

Security

Skills de seguridad:

• oauth-oidc - Autenticación OAuth/OIDC
• encryption - Cifrado y secrets
• security-headers - Headers de seguridad
• input-validation - Validación de entrada

Asignar skills a un agente

Desde la página del agente

1. Abre el agente en la sección Agentes
2. Ve a la pestaña Skills
3. Haz clic en + Añadir Skill
4. Selecciona la skill del listado
5. La skill se asigna inmediatamente

Panel de Skills

┌─────────────────────────────────────────────────────────────────┐
│ Skills del agente: dotnet-architect          [+ Añadir Skill]  │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │ 🧠 api-design                                      [✕]   │  │
│  │ Diseño y documentación de APIs REST                      │  │
│  └──────────────────────────────────────────────────────────┘  │
│                                                                 │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │ 🧠 clean-architecture                              [✕]   │  │
│  │ Patrones de arquitectura limpia                          │  │
│  └──────────────────────────────────────────────────────────┘  │
│                                                                 │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │ 🧠 entity-framework                                [✕]   │  │
│  │ Entity Framework Core y migraciones                      │  │
│  └──────────────────────────────────────────────────────────┘  │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Quitar skill de un agente

1. En la pestaña Skills del agente
2. Localiza la skill que quieres quitar
3. Haz clic en junto a la skill
4. Confirma la eliminación

Sin confirmación

La skill se quita inmediatamente. Si te equivocas, puedes volver a añadirla.

Ver detalles de una skill

1. En la lista de Skills
2. Haz clic en el nombre de la skill
3. Verás:
4. Descripción completa
5. Contenido/documentación
6. Agentes que la usan
7. Ejemplos de uso

Sincronizar skills

El botón Sync actualiza las skills desde los archivos de configuración:

1. Haz clic en Sync
2. El sistema lee los archivos .md de skills
3. Actualiza la base de datos
4. Muestra resumen de cambios

Impacto de las skills

En el comportamiento del agente

Las skills proporcionan:

• Contexto adicional: Información que el agente puede usar
• Patrones: Ejemplos de cómo resolver problemas
• Restricciones: Guías sobre qué hacer y qué evitar

En las respuestas

Un agente con más skills relevantes:

• Da respuestas más precisas en su área
• Puede manejar casos más complejos
• Sigue mejores prácticas documentadas

Mejores prácticas

Selección de skills

Calidad sobre cantidad

• Asigna solo skills relevantes para el propósito del agente
• Evita sobrecargar con skills no relacionadas
• Revisa periódicamente y elimina las no utilizadas

Combinaciones efectivas

Tipo de agente	Skills recomendadas
Backend	api-design, error-handling, sql-optimization
DevOps	git-operations, docker-compose, ci-cd-pipelines
DBA	sql-optimization, postgresql, indexing, migrations
Security	oauth-oidc, encryption, input-validation

Evitar conflictos

• No asignes skills contradictorias
• Si dos skills cubren lo mismo, elige la más específica
• Revisa el contenido de las skills para evitar redundancias

Preguntas frecuentes

¿Puedo crear mis propias skills?

Sí, las skills se definen como archivos Markdown en el repositorio. Contacta al administrador para añadir nuevas skills.

¿Las skills afectan al rendimiento?

Mínimamente. Las skills se incluyen en el contexto del agente, lo que puede aumentar ligeramente el tiempo de respuesta.

¿Qué pasa si quito una skill de un agente?

El agente dejará de tener ese conocimiento especializado. Las respuestas en esa área pueden ser menos precisas.

---

Siguiente: Triggers - Configura activadores automáticos para agentes.