기술

Skills는 LibreChat 에이전트를 위한 재사용 가능한 명령어 번들입니다. Skill은 SKILL.md 파일을 중심으로 구성됩니다. 프런트매터(frontmatter)는 해당 Skill을 언제 사용해야 하는지 설명하며, 마크다운 본문은 에이전트가 따라야 할 절차, 규칙, 예시 또는 참조 정보를 제공합니다.

Skills는 다음과 같은 반복 가능한 작업에 유용합니다:

• 브랜드 또는 작성 가이드라인 적용하기
• 내부 검토 체크리스트 따르기
• 표준 연구 워크플로우 실행하기
• 특화된 도구 워크플로우 준비하기
• 재사용 가능한 스크립트, 참조 자료 및 에셋을 지침 파일과 함께 패키징하기

스킬 활성화

skills 에이전트 기능은 기본적으로 활성화되어 있습니다. 관리자는 에이전트 엔드포인트 기능 목록에서 이를 제거하여 사용자에게서 Skills를 숨길 수 있습니다.

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

역할 권한은 누가 스킬을 사용, 생성, 공유 및 공개 공유할 수 있는지도 제어합니다.

배포 기술

관리자는 DEPLOYMENT_SKILLS_DIR을 사용하여 파일 시스템에서 읽기 전용 Skills를 배포할 수 있습니다.

DEPLOYMENT_SKILLS_DIR=./skill

디렉터리는 프로젝트 루트의 ./skill로 기본 설정되어 있습니다. LibreChat은 시작 시 배포된 Skills를 로드하고, Skills 기능이 활성화된 사용자에게 이를 노출합니다.

배포 기술:

• UI에서 읽기 전용입니다
• deployment를 소스로 사용하세요
• 동일한 이름을 가진 기존 Skills보다 우선합니다
• 파일이 추가, 제거 또는 변경된 후에는 LibreChat을 다시 시작해야 합니다.

GitHub Skill Sync

관리자는 librechat.yaml의 skillSync.github를 사용하여 GitHub 저장소에서 Skills를 미러링할 수 있습니다.

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:

• SKILL.md에 대해 구성된 저장소 경로를 스캔합니다.
• 각 스킬 옆에 번들된 파일을 가져옵니다
• source: "github"을 사용하여 미러링된 Skills를 저장합니다.
• 업스트림 저장소가 변경될 때 미러링된 Skills를 업데이트합니다
• 구성된 소스에 더 이상 존재하지 않는 미러링된 Skills를 제거합니다.
• 예약 실행, 시작 시 실행, 그리고 관리자가 수동으로 트리거하는 실행을 지원합니다

선택한 저장소에 대해 읽기 전용 Contents 및 Metadata 권한이 있는 GitHub 세분화된 개인 액세스 토큰(fine-grained personal access token)을 사용하세요. 모든 필드, 자격 증명 옵션, 테넌트 범위 지정 및 관리자 동기화 엔드포인트에 대한 자세한 내용은 Skill Sync Object Structure를 참조하세요.

스킬 생성하기

사이드 패널에서 Skills를 엽니다. LibreChat에서 직접 스킬을 작성하거나 SKILL.md를 포함하는 .md, .zip 또는 .skill 파일을 업로드할 수 있습니다.

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

호출 모드 (Invocation Modes)

Skills는 다음 세 가지 방식으로 에이전트에 도달할 수 있습니다:

• Manual: 사용자가 채팅창에 $를 입력하고 팝오버에서 스킬을 선택합니다.
• Model-invoked: 모델이 주입된 스킬 카탈로그에서 스킬을 선택하고 해당 스킬 도구를 호출합니다.
• Always apply: 활성화 시 모든 턴에 해당 스킬이 적용됩니다.

수동 호출은 명시적인 사용자 의도입니다. user-invocable이 false가 아닌 한, disable-model-invocation: true로 설정되어 모델 호출에서 숨겨진 스킬을 사용할 수 있습니다.

Agent Scope

에이전트가 카탈로그를 사용하려면 먼저 Skills가 활성화되어 있어야 합니다.

• 지속된 에이전트에서 skills_enabled가 false이거나 설정되지 않은 경우, 해당 에이전트의 스킬은 비활성화됩니다.
• skills_enabled가 true이고 스킬 허용 목록(allowlist)이 설정되지 않은 경우, 에이전트는 사용자에게 표시되는 전체 활성 카탈로그를 사용할 수 있습니다.
• skills_enabled가 true이고 skills에 특정 스킬 ID가 포함되어 있으면, 에이전트는 해당 목록으로 제한됩니다.

이를 통해 관리자는 Skills 기능을 전역적으로 노출하면서도 각 에이전트가 사용할 수 있는 스킬 세트를 집중적으로 관리할 수 있습니다.

활성 및 공유된 스킬

사용자는 스킬을 활성 또는 비활성 상태로 전환할 수 있습니다. 소유한 스킬은 기본적으로 활성 상태입니다. 공유된 스킬은 사용자가 재정의하기 전까지 관리자가 구성한 기본값을 사용합니다.

비활성 스킬은 다음에서 제외됩니다:

• $ 팝오버
• 모델이 호출하는 스킬 카탈로그
• 항상 프라이밍 적용

번들 파일 (Bundled Files)

업로드된 스킬 번들에는 SKILL.md와 함께 다음과 같은 파일이 포함될 수 있습니다:

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

백엔드는 해당 파일들을 스킬과 함께 저장합니다. 에이전트는 스킬이 활성화되어 있고 범위 내에 있을 때 스킬 파일을 해석할 수 있습니다.