Habilidades

Las Skills son paquetes de instrucciones reutilizables para los agentes de LibreChat. Una skill se centra en un archivo SKILL.md: el frontmatter describe cuándo debe utilizarse la skill, y el cuerpo en markdown proporciona al agente el procedimiento, las reglas, los ejemplos o las referencias a seguir.

Las Skills son útiles para trabajos repetibles tales como:

• Aplicación de directrices de marca o escritura
• Siguiendo las listas de verificación de revisión interna
• Ejecución de un flujo de trabajo de investigación estándar
• Preparación de un flujo de trabajo de herramientas especializado
• Empaquetado de scripts, referencias y activos reutilizables con un archivo de instrucciones

Habilitar Skills

La capacidad de agente skills está habilitada de forma predeterminada. Los administradores pueden eliminarla de la lista de capacidades del endpoint de agentes para ocultar Skills a los usuarios.

endpoints:
  agents:
    capabilities:
      - 'deferred_tools'
      - 'execute_code'
      - 'file_search'
      - 'web_search'
      - 'artifacts'
      - 'subagents'
      - 'actions'
      - 'context'
      - 'skills'
      - 'tools'
      - 'chain'
      - 'ocr'

Los permisos de rol también controlan quién puede usar, crear, compartir y compartir públicamente habilidades.

Habilidades de despliegue

Los administradores pueden implementar Skills de solo lectura desde el sistema de archivos con DEPLOYMENT_SKILLS_DIR.

DEPLOYMENT_SKILLS_DIR=./skill

El directorio predeterminado es ./skill en la raíz del proyecto. LibreChat carga los Skills de despliegue al inicio y los expone a los usuarios que tienen habilitada la capacidad de Skills.

Habilidades de despliegue:

• Son de solo lectura en la interfaz de usuario
• Utilice deployment como su fuente
• Tienen prioridad sobre las Skills persistentes con el mismo nombre
• Requiere un reinicio de LibreChat después de que los archivos sean añadidos, eliminados o modificados

Sincronización de habilidades de GitHub

Los administradores pueden replicar Skills desde repositorios de GitHub con skillSync.github en librechat.yaml.

skillSync:
  github:
    enabled: true
    intervalMinutes: 60
    runOnStartup: true
    sources:
      - id: librechat-skills
        owner: your-org
        repo: your-skills-repo
        ref: main
        paths:
          - skills
        skillDiscoveryDepth: 2
        token: '${GITHUB_SKILLS_TOKEN}'

Sincronización de habilidades de GitHub:

• Escanea las rutas del repositorio configuradas en busca de SKILL.md
• Importa archivos incluidos junto a cada skill
• Almacena Skills reflejadas con source: "github"
• Actualiza las Skills reflejadas cuando el repositorio upstream cambia
• Elimina las Skills reflejadas que ya no existen en la fuente configurada
• Admite ejecuciones programadas, al inicio y activadas manualmente por el administrador

Utilice un personal access token de GitHub de grano fino con permisos de solo lectura para Contents y Metadata para el repositorio seleccionado. Consulte Skill Sync Object Structure para ver todos los campos, opciones de credenciales, alcance de inquilino (tenant scoping) y endpoints de sincronización de administrador.

Crear una Skill

Abre Skills desde el panel lateral. Puedes escribir una skill directamente en LibreChat o subir un archivo .md, .zip o .skill que contenga SKILL.md.

SKILL.md mínimo:

---
name: brand-guidelines
description: Use when writing public-facing content that must follow the company voice and terminology.
---
 
# Brand Guidelines
 
Write in a concise, practical tone.
Prefer active voice.
Use product terminology consistently.

Frontmatter

Modos de invocación

Las Skills pueden llegar a un agente de tres maneras:

• Manual: el usuario escribe $ en el chat y selecciona una habilidad desde el menú emergente.
• Model-invoked: el modelo elige una habilidad del catálogo de habilidades inyectado y llama a la herramienta de habilidad.
• Always apply: la habilidad se prepara en cada turno cuando está activa.

La invocación manual es una intención explícita del usuario. Puede utilizar habilidades que están ocultas para la invocación del modelo con disable-model-invocation: true, siempre y cuando user-invocable no sea false.

Alcance del Agente

Los Agents deben tener Skills habilitadas antes de poder usar el catálogo.

• Si skills_enabled es false o no está configurado en un agente persistido, las skills están inactivas para ese agente.
• Si skills_enabled es true y no se ha configurado una lista de permitidos (allowlist) de skills, el agente puede utilizar el catálogo activo completo visible para el usuario.
• Si skills_enabled es true y skills contiene IDs de habilidades específicos, el agente se limita a esa lista.

Esto permite a los administradores exponer la función Skills globalmente mientras mantienen enfocado el conjunto de habilidades utilizables de cada agente.

Habilidades activas y compartidas

Los usuarios pueden activar o desactivar las habilidades. Las habilidades propias están activas de forma predeterminada. Las habilidades compartidas utilizan el valor predeterminado configurado por el administrador hasta que el usuario las anula.

Las habilidades inactivas se excluyen de:

• El popover $
• El catálogo de habilidades invocadas por el modelo
• Aplicar siempre el priming

Archivos incluidos

Los paquetes de habilidades cargados pueden incluir archivos junto con SKILL.md, tales como:

• references/...
• scripts/...
• assets/...

El backend almacena esos archivos con la skill. El agente puede resolver los archivos de la skill cuando esta se encuentra activa y dentro del alcance.