Skill 관리
조직 내 모든 에이전트 및 사용자가 활용할 수 있는 공용 스킬을 등록하고 관리하는 기능입니다. 등록된 스킬은 에이전트에 직접 연결하거나, 사용자가 자신의 개인 스킬 메뉴로 복제하여 사용할 수 있습니다.
개요
개별 사용자가 매번 스킬을 생성할 필요 없이, 관리자가 검증된 유용한 스킬을 배포하여 조직 전체의 업무 효율성을 높일 수 있습니다.
주요 기능
- 공식 라이브러리: 플랫폼으로부터 제공되는 검증된 스킬을 조회하고, 조직 내 사용자에게 제공할 스킬을 선택하여 관리할 수 있습니다.
- 공용 스킬 등록:
.zip또는.skill형식의 스킬 패키지를 업로드하거나, GitHub URL을 입력하여 스킬을 가져옵니다. - 에이전트 연동: 특정 에이전트가 해당 스킬을 사용하도록 설정할 수 있습니다.
- 사용자 복제 허용: 사용자가 관리자 스킬을 사용자 페이지의 Skills 메뉴로 복제하여 사용할 수 있습니다.
- 복제된 스킬은 관리자 버전과 독립적으로 관리됩니다.
- 관리자가 원본 스킬을 업데이트해도 사용자가 이미 복제한 스킬은 영향을 받지 않습니다. 사용자가 직접 수정한 스킬이 그대로 유지됩니다.
- 원본 스킬이 업데이트되면 사용자의 Skills Library에서 업데이트가 필요한 목록을 확인할 수 있어, 필요시 최신 버전을 다시 복제할 수 있습니다.
- 시크릿 관리: Skill에서 외부 API를 실행할 때 필요한 API Key, Access Token 같은 시크릿 정보를 안전하게 등록하고 참조할 수 있습니다.
설정 방법
1단계: Skills 메뉴 접속
관리자 페이지 좌측 메뉴에서 Skills를 클릭합니다.

2단계: Skill 추가
우측 상단의 New Skill 버튼을 클릭하여 스킬 등록 화면으로 진입합니다.

3단계: Skill 등록 방식 선택
스킬은 파일 업로드 또는 GitHub URL 가져오기 방식으로 등록할 수 있습니다.
파일 업로드
스킬 파일(.zip, .skill)을 업로드합니다. 파일에 포함된 스킬 이름과 설명이 자동으로 입력되며, 필요시 수정할 수 있습니다.
GitHub URL 가져오기
GitHub 저장소 또는 스킬 폴더 URL을 입력하여 스킬을 가져올 수 있습니다.
- GitHub URL을 입력합니다.
- 비공개 저장소인 경우 Personal Access Token을 입력합니다.
- 가져올 브랜치를 선택합니다.
- 가져오기가 완료되면 스킬 정보가 자동으로 입력됩니다.
- User Library Visibility: 이 옵션을 활성화하면 사용자가 자신의 Skills 메뉴에서 해당 스킬을 조회하고 복제할 수 있습니다. 비활성화 시 에이전트 연동 전용으로만 사용됩니다.

4단계: 저장
설정이 완료되면 Save 버튼을 눌러 저장을 완료합니다. 등록된 스킬은 목록에서 확인할 수 있습니다.
- Hide/Show: 이 옵션을 통해 사용자 Skills Library 목록 내 노출 여부를 설정할 수 있습니다. 에이전트 Skill 설정 목록에서는 영향이 없습니다.
- Download: 스킬 파일을 .zip 형식으로 다운로드할 수 있습니다.
- Delete: 스킬 삭제 시 사용자가 이미 복제한 스킬에는 영향이 없으나, 해당 스킬을 사용 중인 에이전트에서는 자동으로 제거됩니다.

Skill 시크릿 관리

Skill에서 외부 API를 호출해야 하는 경우 API Key, Access Token 같은 시크릿 정보를 안전하게 관리할 수 있습니다. 시크릿을 Skill 코드나 업로드 파일에 직접 포함하지 않고 별도 설정으로 저장한 뒤, Skill 실행 시 참조하도록 구성합니다.
SKILL.md의 frontmatter에 다음과 같이secrets를 정의합니다.
---
name: test-secret-printer
description: Uses TEST_KEY from organization secrets.
secrets:
- ref: ${secrets.TEST_KEY}
---- 정의한
secrets를 테이블에 추가합니다.
공식 라이브러리
플랫폼으로부터 제공되는 검증된 스킬을 관리할 수 있습니다. 관리자 페이지의 Skills 메뉴에서 공식 라이브러리 목록을 조회하고, 조직 내 사용자에게 제공할 스킬을 선택할 수 있습니다.
공식 라이브러리 관리:
- 플랫폼으로부터 제공되는 검증된 스킬 목록을 확인할 수 있습니다.
- 필요한 스킬을 조직 스킬로 추가해 구성원에게 제공할 수 있습니다.
스킬 샌드박스의 네트워크 접근 제어는 샌드박스 관리 페이지에서 설정할 수 있습니다.