Skill Registry
스킬 레지스트리 섹션은 사용자가 AI 에이전트를 위한 재사용 가능한 스킬을 생성, 발견 및 관리할 수 있도록 합니다. 스킬은 에이전트 행동을 표준화하는 재사용 가능한 명령 세트(SKILL.md 파일에 정의됨)입니다. 스킬은 워크플로 정의, 도구 사용 패턴 및 도메인 특정 지식을 포함할 수 있습니다. 이들은 명령어를 표준화하고 팀 간에 에이전트 행동을 일관되게 만드는 데 도움을 줍니다.
스킬 레지스트리 대시보드
스킬 레지스트리 대시보드는 사용 가능한 스킬에 대한 개요와 생성 및 필터링 기능에 대한 빠른 액세스를 제공합니다.
스킬 탐색
메인 레지스트리 에서 다음을 탐색할 수 있습니다:
- Trending Skills: 순위 지표 및 참여 메트릭이 있는 강조된 스킬.
- Skill cards: 각 카드에는 스킬 이름, 버전, 가시성 태그(예: 비공개 또는 제한됨), 짧은 설명 및 상호작용 작업이 표시됩니다.
스킬 필터링 및 정렬
기본 제공된 컨트롤을 사용하여 관련 스킬을 빠르게 찾습니다:
- Tabs: 전체, 내 스킬, 나와 공유된 스킬, 공개.
- Search: 이름이나 키워드로 스킬 찾기.
- Category chips: 카테고리 태그(예: 에이전트, 사용자, DevOps, 모니터링)로 결과 좁히기.
- Sort: 필드별로 결과 재정렬.
- View switcher: 그리드 및 목록 표시 모드 간 전환 토.
스킬 작업
레지스트리의 각 스킬에는 스킬을 관리 및 사용을 위한 빠른 작업을 제공하는 컨텍스트 메뉴(세 점 아이콘을 통해 접근 가능)가 있습니다.
수정
스킬 상세 페이지를 열어 다음과 같은 정보를 수정할 수 있습니다:
- 기본 정보(이름, 카테고리, 설명, 커버 이미지)
- SKILL.md 내용
- 첨부 파일
스킬을 생성한 후 이 작업을 사용하여 명령어나 메타데이터를 재정의니다.
스킬 복사
전체 SKILL.md 마크다운 내용을 클립보드에 복사합니다.
Use case: 다음과 같은 목적을 위해 스킬 명령어를 빠르게 내보냅니다:
- 채팅이나 이메일로 팀원과 공유
- 새로운 스킬의 템플릿으로 사용
- 로컬 백업 생성
다운로드
전체 스킬을 패키지 파일로 다운로드하며, 포함된 내용은 다음과 같습니다:
- 메타데이터 (이름, 카테고리, 설명)
- SKILL.md 내용
- 모든 첨부 파일 (스크립트, 참조, 자산)
- 버전 기록
Use case: 스을 아카이브하거나 다른 NPO Studio 인스턴스로 마이그레이션합니다.
공유
다른 사용자에게 스킬에 대한 접근 권한을 부여하기 위해 공유 대화 상자를 엽니다.
다음과 같은 작업을 수행할 수 있습니다:
- 특정 사용자 또는 그룹과 공유
- 권한 수준 설정 (보기 전용, 편집 등)
- 가시성 제어 (비공개, 공유, 공개)
이를 통해 팀원들이 중복 작업 없이 스킬을 발견하고 재사용할 수 있습니다.
복제
스킬의 모든 내용과 메타데이터를 포함한 복사본을 생성합니다.
복제된 스킬은:
- 새로운 이름을 갖습니다 (예: "원본 스킬 복사본")
- 기본적으로 Private로 표시됩니다
- 모든 SKILL.md 내용과 첨부 파일을 유지합니다
- 새로운 버전 기록을 시작합니다
Use case: 기존 스킬을 변형 또는 전문화된 버전의 시작점으로 사용합니다.
삭제
레지스트리에서 스킬을 영구적으로 제거합니다.
Warning: 이 작업은 취소할 수 없습니다. 삭제하기 전에 다음을 확인할 필요가 있습니다:
- 이 스킬을 참조하는 활성 에이전트가 없습니다.
- 필요한 경우 중요한 내용을 백업했는지 확인합니다.
- 스킬이 더 이상 다른 팀과 공유되거나 사용되지 않는지 확인합니다.
삭제된 스킬은 복구할 수 없습니다.
새 스킬 생성
New Skill를 클릭하여 생성 양식을 엽니다. 새 스킬 생성 페이지에는 메타데이터, 내용 및 지원 파일을 위한 구조화된 섹션이 포함되어 있습니다.
기본 정보
필수 메타데이터 필드를 작성합니다:
- Name (필수): 스킬의 표시 이름.
- System Name: 시스템 사용을 위해 생성되거나 입력된 내부 식별자.
- Categories (필수): 기존 카테고리를 선택하거나 새로 생성합니다.
- Description (필수): 스킬이 수행하는 작업에 대한 간략한 요약.
- Upload cover: 다음 중 하나의 커버 옵션을 선택합니다:
- Default image
- From URL
- Custom
이 페이지의 오른쪽 상단 작업:
- Back: 이전 페이지로 돌아가기.
- Share: 스킬 초안 또는 게시된 스킬을 다른 사람과 공유하기.
- Save: 현재 변경 사항 저장하기.
Skill.md 편집기
SKILL.md 섹션은 핵심 스킬 명령어가 작성되는 곳입니다.
사용 가능한 기능:
- Write / Preview tabs: 마크다운 편집과 렌더링된 출력 간 전환하기.
- Edit with AI: 개선을 위한 AI 지원 편집 열기.
- On this page panel: 기본 정보, SKILL.md 및 파일과 같은 섹션으로 빠르게 이동하기.
AI 편집 도우미
Edit with AI를 사용할 때, 도우미는 구조를 검토하고 개선 사항을 제안할 수 있습니다. 일반적인 피드백에는 다음이 포함됩니다:
- 범위 및 책임의 명확성.
- 의도된 스킬 목적과의 관련성.
- 명령어를 최종화하기 전에 명확한 질문.
제안 사항을 검토한 후, SKILL.md에 직접 업데이트를 적용할 수 있습니다.
파일 섹션
파일 영역은 스킬에서 사용되는 추가 리소스를 저장합니다.
파일 유형
이 페이지는 세 가지 리소스 그룹을 지원합니다:
- Scripts: 스킬 동작을 확장하는 실행 파일.
- References: 맥락 지식으로 사용되는 지원 문서.
- Assets: 이미지나 지원 미디어와 같은 참조 데이터 파일.
업로드 및 상태
- Upload를 사용하여 각 그룹에 파일을 추가합니다.
- 새로 추가된 파일은 사용 가능하기 전에 처리 상태(예: 대기 중)로 표시될 수 있습니다.
버전 기록
버전 기록 섹션은 시간에 따라 스킬에 대해 이루어진 모든 변경 사항을 추적하여 과거 버전을 검토하고, 차이점을 비교하며, 특정 버전을 기본값으로 고정할 수 있도록 합니다.
버전 기록 보기
버전 기록 페이지는 모든 스킬 버전을 최신순으로 나열합니다. 각 버전 기록은 다음을 표시합니다:
- Version timestamp: 버전이 생성된 날짜 및 시간(예: 2026.04.29 16:08).
- Creator: 버전을 만든 사용자 계정(예: cloudzcp-admin).
- Actions: 버전을 관리하는 버튼:
- Pin / Pinned: 버전을 기본값으로 설정하거나 고정을 해제합니다.
- Eye icon: 버전을 봅니다.
- Copy icon: 버전 참조 또는 메타데이터를 복사합니다.
버전을 기본값으로 고정
기본적으로 에이전트는 스킬의 최신 버전을 참조합니다. 이전 버전을 기본값으로 사용하기 위해 고정할 수 있습니다.
버전을 고정하려면:
- 목록에서 원하는 버전을 찾습니다.
- Pin 버튼을 클릭합니다.
- 이제 버전이 Pinned로 표시되며 에이전트가 이 스킬을 참조할 때 사용됩니다.
Note: 하나의 버전만 고정할 수 있습니다.
고정된 버전 정보 보기
버전이 고정되면 페이지 하단에 다음과 같은 노트가 나타납니다:
"고정된 버전 [version label]은 에이전트가 이 스킬을 참조할 때 기본값으로 사용됩니다. 최신 버전을 항상 사용하려면 고정을 해제하세요."
이 알림은 모든 에이전트 참조에 대해 어떤 버전이 활성화되어 있는지 확인하는 데 도움이 됩니다.
변경 사항 뷰로 버전 비교
버전을 클릭하면 변경 사항 뷰어가 열리며, 버전 간의 콘텐츠 변경 사항을 나란히 비교하여 표시합니다.
변경 사항은 다음과 같습니다:
-Left column: 이전 버전의 콘텐츠.
-Right column: 이후 버전의 콘텐츠.
-Highlighted differences: 추가, 제거 또는 수정된 텍스트와 같은 변경 사항이 빠르게 식별할 수 있도록 강조 표시됩니다.
이것은 각 업데이트에서 무엇이 변경되었는지, 추가되었는지 또는 제거되었는지를 이해하는 데 도움이 됩니다.