5.5. 내 스킬을 허브에 게시

개요

내가 만든 스킬을 스킬 허브에 게시하면 같은 CogentAI AAS(이하 AAS)의 다른 사람이 「스킬 허브」 화면에서 설치해 쓸 수 있습니다. 스킬 허브의 뜻은 5.1. 스킬 목록의 「낱말 정리」를 봅니다. 이 장은 게시 요청을 내는 방법, 이름과 버전 정하기, 승인 상태 읽기, 게시된 스킬을 설치하는 방법을 설명합니다. 팀이 같은 스킬을 쓰게 하고 싶을 때, 내 다른 프로파일에도 같은 스킬을 넣고 싶을 때, 새 버전을 퍼뜨릴 때 게시합니다.

권한: 게시 요청은 AI 에이전트 작업공간의 소유자, 팀 관리자, 관리자가 냅니다. 승인과 반려는 관리자만 합니다. 내가 소유자인지 확인하는 법은 5.1. 스킬 목록의 「누가 할 수 있는 일인가」를 봅니다.

게시 요청 권한이 없으면 스킬 이름과 게시하려는 이유를 관리자에게 알립니다. 요청 문장 예시는 다음과 같습니다.

제 AI 에이전트(프로파일 이름: main)의 weekly-report 스킬을 스킬 허브에 게시하고 싶습니다. 팀원이 같은 스킬을 설치해 쓰게 하려는 것입니다. 소유자 권한이 없어 게시 요청을 낼 수 없습니다.

주의: 게시한 버전은 되돌릴 수 없습니다. 지우거나 이전 버전으로 내릴 수 없습니다. 잘못 올렸으면 관리자에게 「허브에서 숨기기」를 요청합니다. 숨기면 그 패키지의 모든 버전이 허브 목록에서 사라지고, 이미 설치한 스킬은 그대로 남습니다. 버전 하나만 내릴 수는 없습니다. 게시 구역이 「외부 공개」이면 회사 밖에서도 볼 수 있으므로, 요청하기 전에 SKILL.md 와 스크립트를 한 번 더 읽습니다.

그림 5.5-1 은 게시 요청을 보낸 뒤 다른 프로파일이 설치하기까지의 순서를 그린 것입니다.

그림 5.5-1. 스킬을 허브에 게시하는 순서

게시할 수 있는 스킬과 승인

「스킬 목록」의 「출처」에 따라 게시 가능 여부와 승인 방식이 다릅니다.

출처	게시	관리자 승인
직접 만듦, AI 에이전트가 만듦	가능	소유자가 이 AAS 에서 만들고 그 뒤 바뀌지 않았으면 관리자 검토 없이 바로 게시됩니다. 그 밖에는 필요합니다.
기본(바뀜)	가능	필요합니다.
스킬 허브	직접 고친 것만 가능	필요합니다. 「제한」 구역의 패키지를 고친 것은 올릴 수 없습니다.
Hermes 기본, AAS 기본	불가	고치지 않은 기본 스킬은 올리지 않습니다.
다른 프로파일에서 가져온 공용 스킬	불가	원래 프로파일에서 올려야 합니다.

관리자 검토 없이 게시되려면 다음 조건을 모두 만족해야 합니다.

• 요청한 사람이 이 AI 에이전트 작업공간의 소유자입니다.
• 스킬이 「AI 에이전트가 만듦」이거나, 이 AAS 에서 사람이 만든 기록이 있고 그 뒤 바뀌지 않은 「직접 만듦」입니다.
• 관리자가 「주인 스킬 자동 승인」을 끄지 않았습니다.

관리자 검토 없이 게시된 버전은 패키지 서랍에 「올린 사람 … 관리자 검토 없이 게시된 버전입니다」 안내가 붙습니다. 「스킬 허브에 게시」 구역이 서랍에 보이지 않으면 위 조건에 해당하지 않는 스킬이거나 게시 요청을 낼 수 없는 사용자입니다.

게시 요청 보내기

1. 게시하기 전에 스킬 폴더를 점검합니다. 아래 「게시되지 않는 경우」를 먼저 읽습니다.
2. 왼쪽 메뉴의 「스킬 › 스킬 목록」에서 게시할 스킬 줄을 눌러 서랍을 엽니다.
3. 서랍의 「스킬 허브에 게시」 구역으로 갑니다.
4. 「스킬 허브 이름」을 확인하고 필요하면 고칩니다.
5. 「버전」을 확인하고 필요하면 고칩니다.
6. 「게시 요청」을 누릅니다.

그림 5.5-2. 「스킬 허브에 게시」 구역

이름과 버전

칸	규칙
스킬 허브 이름	소문자, 숫자, 하이픈으로 2자에서 63자. 처음에는 스킬 이름에서 자동으로 만들어 줍니다. 스킬 자체의 이름은 바뀌지 않습니다.
버전	1.2.3 꼴. 처음에는 1.0.0 이 채워져 있습니다.

• 허브에 같은 이름이 이미 있으면 다른 이름을 쓰거나, 더 큰 버전을 적습니다. 이미 있는 이름에 새 버전을 올릴 수 있는 사람은 처음 올린 사람과 관리자뿐입니다.
• 같은 이름의 게시 요청이 이미 기다리고 있으면 새 요청을 낼 수 없습니다.
• 외부에 이미 같은 이름의 패키지가 있으면 다른 이름을 씁니다.
• 스킬 설명(SKILL.md 머리말의 description)은 20자 이상이어야 합니다. 짧으면 5.6. 스킬 연결도의 「스킬 문서 고치기」에서 설명을 늘립니다.

게시되지 않는 경우

AAS 는 요청을 받을 때 스킬 폴더를 검사합니다. 다음에 해당하면 요청이 거절되고 이유가 나옵니다.

• 게시되는 파일은 스킬 폴더 안의 일반 파일뿐입니다. 숨김 파일과 링크는 빠집니다.
• 비밀값처럼 보이는 문자열(키, 토큰, 비밀번호)이 있으면 게시할 수 없습니다.
• 사내 도메인이나 사설 IP 주소가 있으면 외부에 공개되는 구역에는 게시할 수 없습니다. 「사내 도메인이나 사설 IP 가 있습니다: …」가 나옵니다. 구성원에게만 보이는 구역은 경고만 나옵니다.

거절 문구에 나온 파일과 문자열을 5.6. 스킬 연결도의 「스킬 문서 고치기」로 열어 지운 뒤 다시 요청합니다. SKILL.md 가 아닌 파일은 그 장에서 고칠 수 없으므로, 서랍의 「고치기 요청」으로 AI 에이전트에게 부탁합니다.

승인 상태 보기

요청한 뒤에는 서랍의 「스킬 허브에 게시」 구역 아래에 「이름@버전」과 상태가 한 줄로 나옵니다. 「스킬 허브」 화면의 「게시 요청」 카드에서도 같은 요청을 봅니다.

상태	뜻
승인 기다림	관리자가 내용을 보고 승인할 때까지 기다립니다.
게시 중	스킬 허브에 올리는 중입니다.
스킬 허브 검토 중	스킬 허브가 검토하는 중입니다. 검토가 끝나면 게시됩니다. 기다리면 되고, 오래 바뀌지 않으면 관리자에게 문의합니다.
게시됨	스킬 허브에 올라갔습니다.
반려됨	관리자가 반려했습니다. 반려 사유를 읽고 고쳐서 새 버전으로 다시 요청합니다.
게시 실패	올리지 못했습니다. 메시지를 읽습니다. 관리자가 같은 묶음으로 다시 게시할 수 있습니다.

요청한 직후에는 두 가지 중 하나가 나옵니다.

• 「스킬 {이름} 게시를 요청했습니다. 관리자가 승인하면 게시됩니다.」: 관리자 승인이 필요한 경우입니다.
• 「스킬 {이름} 을 관리자 검토 없이 게시합니다 · {네임스페이스}({공개 범위})」: 자동 승인된 경우입니다. 중괄호 자리에는 게시 구역(네임스페이스) 이름이 들어갑니다. 공개 범위는 「외부 공개」 또는 「구성원만 보임」으로 나옵니다.

게시한 뒤

• 게시된 스킬은 「스킬 허브」의 「패키지」 카드에 나타납니다. 허브 목록에 반영되기까지 잠시 걸릴 수 있습니다.
• 다른 프로파일에 설치하려면 5.3. 스킬 허브에서 설치의 설치 절차를 따릅니다. 설치할 프로파일을 고르고 「이 프로파일에 설치」를 누릅니다.
• 같은 스킬을 설치한 프로파일에는 새 버전 알림이 갑니다. 올리는 방법은 5.3. 스킬 허브에서 설치의 「새 버전으로 올리기」를 봅니다.
• 스킬을 고치면 버전을 올려서 다시 게시 요청을 냅니다. 이름은 같게 둡니다.
• 잘못 올린 패키지는 관리자에게 「허브에서 숨기기」를 요청합니다. 자세한 내용은 이 장 앞의 주의를 봅니다.

관련 문서

• 5.3. 스킬 허브에서 설치
• 5.4. 내 스킬 만들기
• 5.6. 스킬 연결도