Keterampilan

Skills adalah bundel instruksi yang dapat digunakan kembali untuk Agen LibreChat. Sebuah skill berpusat pada file SKILL.md: frontmatter menjelaskan kapan skill tersebut harus digunakan, dan isi markdown memberikan prosedur, aturan, contoh, atau referensi yang harus diikuti oleh agen.

Skills berguna untuk pekerjaan yang dapat diulang seperti:

• Menerapkan pedoman merek atau penulisan
• Mengikuti daftar periksa tinjauan internal
• Menjalankan alur kerja riset standar
• Menyiapkan alur kerja alat khusus
• Mengemas skrip, referensi, dan aset yang dapat digunakan kembali dengan file instruksi

Mengaktifkan Skills

Kemampuan agen skills diaktifkan secara default. Admin dapat menghapusnya dari daftar kemampuan endpoint agents untuk menyembunyikan Skills dari pengguna.

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

Izin peran juga mengontrol siapa yang dapat menggunakan, membuat, membagikan, dan membagikan keterampilan secara publik.

Keterampilan Deployment

Admin dapat mengirimkan Skill bersifat read-only dari sistem berkas dengan DEPLOYMENT_SKILLS_DIR.

DEPLOYMENT_SKILLS_DIR=./skill

Direktori defaultnya adalah ./skill di root proyek. LibreChat memuat Skills deployment saat startup dan mengeksposnya kepada pengguna dengan kapabilitas Skills yang diaktifkan.

Keterampilan Deployment:

• Adalah read-only di UI
• Gunakan deployment sebagai sumbernya
• Mengambil prioritas di atas Skills yang tersimpan dengan nama yang sama
• Memerlukan restart LibreChat setelah file ditambahkan, dihapus, atau diubah

GitHub Skill Sync

Admin dapat mencerminkan Skills dari repositori GitHub dengan skillSync.github di 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}'

Sinkronisasi Skill GitHub:

• Memindai jalur repositori yang dikonfigurasi untuk SKILL.md
• Mengimpor file yang dibundel di samping setiap skill
• Menyimpan Skills yang dicerminkan dengan source: "github"
• Memperbarui Skills yang dicerminkan saat repositori hulu berubah
• Menghapus Skills yang dicerminkan (mirrored) yang tidak lagi ada di sumber yang dikonfigurasi
• Mendukung eksekusi terjadwal, saat startup, dan manual yang dipicu oleh admin

Gunakan GitHub fine-grained personal access token dengan izin Contents dan Metadata read-only untuk repositori yang dipilih. Lihat Skill Sync Object Structure untuk semua field, opsi kredensial, tenant scoping, dan endpoint admin sync.

Membuat Skill

Buka Skills dari panel samping. Anda dapat menulis skill secara langsung di LibreChat atau mengunggah file .md, .zip, atau .skill yang berisi SKILL.md.

SKILL.md minimum:

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

Mode Pemanggilan

Skills dapat menjangkau agen melalui tiga cara:

• Manual: pengguna mengetik $ di obrolan dan memilih skill dari popover.
• Model-invoked: model memilih skill dari katalog skill yang disuntikkan dan memanggil alat skill tersebut.
• Selalu terapkan: skill tersebut disiapkan ke dalam setiap giliran saat aktif.

Pemanggilan manual adalah maksud pengguna yang eksplisit. Pemanggilan ini dapat menggunakan skill yang disembunyikan dari pemanggilan model dengan disable-model-invocation: true, selama user-invocable tidak bernilai false.

Cakupan Agen

Agen harus mengaktifkan Skills sebelum mereka dapat menggunakan katalog.

• Jika skills_enabled bernilai false atau tidak diatur pada agen yang persisten, maka skills tidak aktif untuk agen tersebut.
• Jika skills_enabled bernilai true dan tidak ada daftar izin (allowlist) skill yang ditetapkan, agen dapat menggunakan katalog aktif penuh yang terlihat oleh pengguna.
• Jika skills_enabled bernilai true dan skills berisi ID skill tertentu, agen akan dibatasi pada daftar tersebut.

Ini memungkinkan admin untuk mengekspos fitur Skills secara global sambil tetap menjaga agar kumpulan skill yang dapat digunakan oleh setiap agen tetap terfokus.

Skill Aktif dan Bersama

Pengguna dapat mengaktifkan atau menonaktifkan skill. Skill yang dimiliki secara default berstatus aktif. Skill yang dibagikan menggunakan pengaturan default yang dikonfigurasi admin hingga pengguna mengubahnya.

Skill yang tidak aktif dikecualikan dari:

• Popover $
• Katalog keterampilan yang dipanggil model
• Selalu terapkan priming

Berkas Terbundel

Bundel skill yang diunggah dapat menyertakan file di samping SKILL.md, seperti:

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

Backend menyimpan file-file tersebut bersama skill. Agen dapat menyelesaikan file skill saat skill tersebut aktif dan berada dalam cakupan.