Habilidades

Skills são pacotes de instruções reutilizáveis para Agentes do LibreChat. Uma skill é centrada em um arquivo SKILL.md: o frontmatter descreve quando a skill deve ser usada, e o corpo em markdown fornece ao agente o procedimento, regras, exemplos ou referências a serem seguidos.

Skills são úteis para trabalhos repetíveis, tais como:

• Aplicando diretrizes de marca ou escrita
• Seguindo checklists de revisão interna
• Executando um fluxo de trabalho de pesquisa padrão
• Preparando um fluxo de trabalho de ferramenta especializada
• Empacotando scripts, referências e ativos reutilizáveis com um arquivo de instrução

Habilitar Skills

A capacidade de agente skills está habilitada por padrão. Administradores podem removê-la da lista de capacidades do endpoint de agentes para ocultar as Skills dos usuários.

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

As permissões de função também controlam quem pode usar, criar, compartilhar e compartilhar publicamente skills.

Habilidades de Implantação

Admins podem disponibilizar Skills somente leitura a partir do sistema de arquivos com DEPLOYMENT_SKILLS_DIR.

DEPLOYMENT_SKILLS_DIR=./skill

O diretório padrão é ./skill na raiz do projeto. O LibreChat carrega as Skills de implantação na inicialização e as expõe aos usuários com a funcionalidade de Skills habilitada.

Habilidades de Implantação:

• São somente leitura na UI
• Use deployment como sua fonte
• Têm precedência sobre Skills persistidas com o mesmo nome
• Requer uma reinicialização do LibreChat após arquivos serem adicionados, removidos ou alterados

GitHub Skill Sync

Admins podem espelhar Skills de repositórios do GitHub com skillSync.github no 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}'

Sincronização de Habilidades do GitHub:

• Verifica caminhos de repositório configurados em busca de SKILL.md
• Importa arquivos agrupados ao lado de cada skill
• Armazena Skills espelhadas com source: "github"
• Atualiza as Skills espelhadas quando o repositório upstream é alterado
• Remove Skills espelhadas que não existem mais na fonte configurada
• Suporta execuções agendadas, na inicialização e acionadas manualmente pelo administrador

Use um personal access token do tipo fine-grained do GitHub com permissões de leitura (read-only) para Contents e Metadata no repositório selecionado. Consulte Skill Sync Object Structure para todos os campos, opções de credenciais, escopo de tenant e endpoints de sincronização de administrador.

Criar uma Skill

Abra Skills no painel lateral. Você pode escrever uma skill diretamente no LibreChat ou fazer upload de um arquivo .md, .zip ou .skill que contenha 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 Invocação

As Skills podem chegar a um agente de três maneiras:

• Manual: o usuário digita $ no chat e seleciona uma skill a partir do popover.
• Model-invoked: o modelo escolhe uma skill do catálogo de skills injetado e chama a ferramenta da skill.
• Sempre aplicar: a skill é preparada em cada turno quando ativa.

A invocação manual é uma intenção explícita do usuário. Ela pode usar skills que estão ocultas da invocação do modelo com disable-model-invocation: true, desde que user-invocable não seja false.

Escopo do Agente

Agentes devem ter Skills habilitadas antes que possam usar o catálogo.

• Se skills_enabled for false ou não estiver definido em um agente persistido, as skills estarão inativas para esse agente.
• Se skills_enabled for true e nenhuma lista de permissões (allowlist) de skill estiver definida, o agente pode usar o catálogo ativo completo visível para o usuário.
• Se skills_enabled for true e skills contiver IDs de habilidades específicos, o agente será limitado a essa lista.

Isso permite que administradores exponham o recurso de Skills globalmente, mantendo o conjunto de habilidades utilizáveis de cada agente focado.

Habilidades Ativas e Compartilhadas

Os usuários podem alternar as skills entre ativas ou inativas. Skills próprias são ativas por padrão. Skills compartilhadas usam o padrão configurado pelo administrador até que o usuário as substitua.

Habilidades inativas são excluídas de:

• O popover $
• O catálogo de habilidades invocadas pelo modelo
• Sempre aplicar priming

Arquivos Agrupados

Os pacotes de habilidades (skill bundles) enviados podem incluir arquivos juntamente com o SKILL.md, tais como:

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

O backend armazena esses arquivos com a skill. O agente pode resolver arquivos de skill quando a skill estiver ativa e no escopo.