Vaardigheden

Skills zijn herbruikbare instructiebundels voor LibreChat Agents. Een skill is gecentreerd rond een SKILL.md bestand: frontmatter beschrijft wanneer de skill moet worden gebruikt, en de markdown-body geeft de agent de procedure, regels, voorbeelden of referenties om te volgen.

Skills zijn nuttig voor herhaalbaar werk zoals:

• Merk- of schrijfrichtlijnen toepassen
• Het volgen van interne controlelijsten
• Een standaard onderzoeksworkflow uitvoeren
• Het voorbereiden van een gespecialiseerde tool-workflow
• Het verpakken van herbruikbare scripts, referenties en assets met een instructiebestand

Skills inschakelen

De skills agent-functionaliteit is standaard ingeschakeld. Beheerders kunnen deze verwijderen uit de lijst met functionaliteiten van het agents endpoint om Skills te verbergen voor gebruikers.

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

Rolmachtigingen bepalen ook wie skills kan gebruiken, aanmaken, delen en openbaar kan delen.

Deployment Skills

Admins kunnen read-only Skills vanuit het bestandssysteem verzenden met DEPLOYMENT_SKILLS_DIR.

DEPLOYMENT_SKILLS_DIR=./skill

De directory staat standaard ingesteld op ./skill in de hoofdmap van het project. LibreChat laadt deployment Skills bij het opstarten en stelt deze beschikbaar aan gebruikers met de Skills-functionaliteit ingeschakeld.

Deployment-vaardigheden:

• Zijn alleen-lezen in de UI
• Gebruik deployment als hun bron
• Krijgen voorrang op opgeslagen Skills met dezelfde naam
• Een herstart van LibreChat is vereist nadat bestanden zijn toegevoegd, verwijderd of gewijzigd

GitHub Skill Sync

Beheerders kunnen Skills spiegelen vanuit GitHub-repositories met skillSync.github in 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}'

GitHub Skill Sync:

• Scant geconfigureerde repository-paden op SKILL.md
• Importeert gebundelde bestanden naast elke skill
• Slaat gespiegelde Skills op met source: "github"
• Werkt gespiegelde Skills bij wanneer de upstream repository wijzigt
• Verwijdert gespiegelde Skills die niet langer bestaan in de geconfigureerde bron
• Ondersteunt geplande, opstart- en handmatig door de beheerder geactiveerde uitvoeringen

Gebruik een GitHub fine-grained personal access token met read-only Contents en Metadata permissies voor de geselecteerde repository. Zie Skill Sync Object Structure voor alle velden, credential-opties, tenant-scoping en admin sync-endpoints.

Een Skill aanmaken

Open Skills vanuit het zijpaneel. Je kunt een skill rechtstreeks in LibreChat schrijven of een .md-, .zip- of .skill-bestand uploaden dat SKILL.md bevat.

Minimaal SKILL.md:

---
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

Aanroepmodi

Skills kunnen een agent op drie manieren bereiken:

• Handmatig: de gebruiker typt $ in de chat en selecteert een skill uit het popover-menu.
• Model-invoked: het model kiest een vaardigheid uit de geïnjecteerde vaardighedencatalogus en roept de vaardigheidstool aan.
• Altijd toepassen: de skill wordt in elke beurt geactiveerd wanneer deze is ingeschakeld.

Handmatige aanroeping is expliciete gebruikersintentie. Het kan skills gebruiken die verborgen zijn voor modelaanroeping met disable-model-invocation: true, zolang user-invocable niet op false staat.

Agent Scope

Agents moeten Skills ingeschakeld hebben voordat ze de catalogus kunnen gebruiken.

• Als skills_enabled false is of niet is ingesteld op een opgeslagen agent, dan zijn skills inactief voor die agent.
• Als skills_enabled op true staat en er geen skill allowlist is ingesteld, kan de agent de volledige actieve catalogus gebruiken die zichtbaar is voor de gebruiker.
• Als skills_enabled op true staat en skills specifieke skill-ID's bevat, wordt de agent beperkt tot die lijst.

Hiermee kunnen beheerders de Skills-functie globaal beschikbaar maken, terwijl de bruikbare vaardighedenset van elke agent gericht blijft.

Actieve en Gedeelde Skills

Gebruikers kunnen skills in- of uitschakelen. Eigen skills zijn standaard actief. Gedeelde skills gebruiken de door de beheerder geconfigureerde standaardinstelling totdat de gebruiker deze overschrijft.

Inactieve skills worden uitgesloten van:

• De $ popover
• De door het model aangeroepen skill-catalogus
• Altijd-toepassen priming

Gebundelde bestanden

Geüploade skill-bundels kunnen naast SKILL.md ook bestanden bevatten, zoals:

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

De backend slaat die bestanden op bij de skill. De agent kan skill-bestanden oplossen wanneer de skill actief is en binnen het bereik valt.