Skill
Skill 페이지에서는 재사용 가능한 작업 방법과 작업 절차를 찾고, 설치하고, 관리하며, 적합한 Skill을 Agent에 제공하여 사용하게 할 수 있습니다.
대상 독자: 작업 방법을 재사용하거나 유지 관리하는 사용자.
진입 경로: 기능 센터 → Skill.
검색 키워드: Skill, 스킬, Skill marketplace, 작업 절차, 가져오기, 버전, 공유.
Skill 찾기 및 선택
Skill은 특정 유형의 작업을 "언제, 어떻게, 어떤 기준까지" 수행할지 설명하며, 분석 절차, 작업 방법, 산출물 규격을 재사용하는 데 적합합니다. 먼저 용도와 사전 조건을 읽은 다음 현재 작업에 적합한지 판단합니다.
Skill은 방법을 제공하고, Agent는 작업을 실행하며, MCP는 도구 연결을 제공하고, 지식 베이스는 검색 가능한 자료를 제공합니다. 특정 공간의 배경과 규칙을 장기적으로 유지 관리해야 한다면 공간 메모리를 사용합니다.
- 시스템 스킬: 플랫폼에 사전 설정된 방법으로, 직접 편집하거나 삭제할 수 없습니다. 조정이 필요하면 개인 버전으로 복사할 수 있습니다.
- 회사 스킬: 회사 내부에서 공유하는 방법으로, 회사 리소스 관리 권한이 있는 관리자가 유지 관리합니다.
- 개인 Skill: 직접 생성하거나 복사하거나 공유를 수락하여 얻은 방법으로, 본인이 유지 관리합니다.
목록 페이지에서 Skill을 검색하고 출처와 기능 카테고리로 필터링할 수 있으며, 좋아요, 호출, 다운로드 또는 최신 순으로 정렬할 수도 있습니다. 카드를 클릭하면 상세가 열리며 설명, Skill 내용 및 부속 파일을 확인할 수 있습니다. 좋아요 기능을 지원하므로 팀이 우수한 콘텐츠를 발견하는 데 도움이 됩니다.
처음 사용하는 경우 먼저 시스템 스킬을 둘러본 다음 작업에 따라 회사 또는 개인 Skill을 선택하십시오. 모든 기능 유형을 둘러보려면 기능 센터로 이동합니다. 구체적인 사용 방법은 아래 내용을 이어서 보십시오.
Agent, 워크스페이스, 대화에서 사용
Skill 활성화, Agent에 Skill 설정, 공간 공용 기능에 추가, 대화에서 사용은 각각 역할이 다릅니다. Skill을 생성하거나 다운로드해도 이러한 설정이 자동으로 완료되지는 않습니다.
사용 가능한 방법 활성화. Skill 페이지에서 스위치를 확인합니다. 시스템 스킬과 회사 스킬의 스위치는 현재 사용자의 사용 선호만 조정하며 다른 멤버의 Skill을 비활성화하지 않습니다. 개인 Skill의 스위치는 본인의 버전을 관리합니다.
특정 Agent가 방법을 재사용하도록 하기. Agent의 기능 설정에서 Skill을 연결합니다. 설정된 Skill은 해당 Agent의 필수 기능이며, 대화에서 마음대로 해제할 수 있는 임시 선택이 아닙니다. 생성 및 설정 방법은 Agent를 참고하십시오.
워크스페이스에 공용 기능 제공. 공간 기능 설정 권한이 있는 멤버가 Skill을 선택합니다. 공유 공간의 공용 기능에는 개인 Skill을 추가할 수 없으므로 시스템 스킬 또는 회사 스킬을 선택해야 합니다. 공간 역할, 기능 범위 및 작업은 새 공간 생성하기를 참고하십시오. 공간 관리 권한이 회사 스킬의 편집 권한과 같은 것은 아닙니다.
특정 대화에서 사용. 대상 공간과 대화로 이동하여 현재 Agent와 사용 가능한 Skill을 먼저 확인합니다. 일반 대화에서는 Skill의 자동 사용 선호를 조정할 수 있고, 현재 메시지에 사용할 Skill을 선택할 수도 있습니다. 설정이 완료된 Agent를 사용할 때는 사용 가능한 Skill을 추가할 수 있지만 해당 Agent의 필수 항목은 해제할 수 없습니다. 보내기 전에 현재 메시지의 기능 선택을 확인하십시오. 자세한 작업은 대화를 참고하십시오.
Skill을 사용할 수 있다고 해서 매번 대화할 때마다 그 안의 모든 단계가 실행되는 것은 아니며, 데이터, 도구 또는 외부 서비스 권한이 자동으로 부여되지도 않습니다. 방법이 도구나 비즈니스 자료에 의존한다면 해당 MCP와 지식 베이스를 설정하고 필요한 권한 부여를 완료해야 합니다.
Skill 생성 또는 가져오기
Skill 페이지로 이동하여 생성 진입점을 클릭합니다. 일반 멤버는 개인 Skill을 생성할 수 있고, 회사 리소스 관리 권한이 있는 관리자(Agent 관리자, 시스템 관리자 포함)는 회사 스킬을 생성할 수 있습니다.
- 개인 또는 회사 범위 선택. 개인 범위는 방법을 먼저 검증하는 데 적합하고, 회사 범위는 팀이 재사용할 방법을 유지 관리하는 데 적합합니다.
- 콘텐츠 출처 선택. 직접 편집하거나, 단일
.md파일 또는 부속 파일이 포함된.zip/.skill패키지를 업로드할 수 있습니다. - 이름, 설명, 버전 확인. 이름에는 영문 소문자, 숫자를 사용하고 하이픈 하나로 구분하며 최대 48자입니다(예:
weekly-analysis). 한국어 이름은 표시 이름에 넣을 수 있습니다. 설명에는 적용 시나리오를 적고, 본문에는 사전 조건, 작업 단계, 예상 결과를 포함해야 합니다. 버전은주버전.부버전형식을 사용합니다(예:1.0). - 미리보기 확인 후 생성. 가져온 후 본문, 버전, 파일 목록을 확인하고 이름 충돌이나 형식 안내를 처리한 다음 제출합니다. 생성에 성공하면 활성화 상태를 확인하고 필요에 따라 Agent, 공간 또는 대화에 설정합니다.
파일 구성. 단일 Markdown 파일은 설명 본문만 있는 방법에 적합합니다. 부속 자료가 필요하면 ZIP 형식의 .zip 또는 .skill 패키지를 사용합니다. 루트 디렉터리에 SKILL.md를 두고 references/(참고 설명), assets/(템플릿과 소재), scripts/(스크립트)를 함께 넣을 수 있습니다. 최상위 폴더 하나로 전체를 감쌀 수도 있으며, 디렉터리를 여러 단계로 중첩하지 않도록 합니다.
패키지 크기는 5 MB를 넘을 수 없고, SKILL.md는 1 MiB를 넘을 수 없으며, 본문은 비워 둘 수 없습니다. 가져온 파일의 버전은 미리 채우는 데 사용됩니다. 버전 형식이 올바르지 않다는 안내가 표시되면 수정한 후 제출해야 하며, v1.0, 1.0.0 또는 앞자리에 0이 붙은 버전은 사용할 수 없습니다.
스크립트를 업로드했다고 해서 스크립트가 자동으로 실행되는 것은 아닙니다. 실제 실행 여부는 대화에서 사용할 수 있는 실행 환경, 도구, 권한 부여에 따라 달라집니다. 개인 Skill의 일부 작업은 개인 샌드박스를 사용할 수 있어야 합니다.
콘텐츠 및 버전 유지 관리
편집 권한. 개인 Skill은 본인이 편집하고 삭제합니다. 회사 스킬은 회사 리소스 관리 권한이 있는 관리자가 유지 관리합니다. 시스템 스킬은 직접 편집하거나 삭제할 수 없습니다. Skill을 둘러보거나 사용하거나 공간에 설정할 수 있다고 해서 그 내용을 수정할 권한이 있는 것은 아닙니다.
내용 수정. 편집 진입점에서 이름, 설명 또는 지시문 본문을 업데이트하고, 상세에서 references, assets, scripts 부속 파일을 확인하고 유지 관리합니다. 시스템 스킬이나 회사 스킬을 맞춤 조정해야 하는데 편집 권한이 없다면 먼저 개인 버전으로 복사합니다.
내용이 바뀌면 버전을 올려야 함. SKILL.md에서 버전 번호 이외의 내용(이름, 설명, 본문 포함)을 수정하면 저장할 때 현재 버전보다 엄격하게 높은 새 버전을 입력해야 합니다(예: 1.0 → 1.1). 내용은 바꾸지 않고 버전 번호만 바꾸어 빈 이력 버전을 만들 수는 없습니다. 표시 이름, 아이콘, 카테고리 또는 부속 파일의 변경은 본문 버전 업그레이드와 같지 않습니다.
이력과 차이 확인. 개인 Skill과 회사 스킬의 상세에서는 버전 기록을 제공하며, 각 버전의 내용과 이전 버전 대비 변경 사항을 비교해 볼 수 있습니다. 시스템 스킬에는 이와 같은 버전 기록 진입점이 없습니다. 또한 버전 비교가 원클릭 롤백을 의미하지는 않습니다.
파일 패키지로 교체할 때는 먼저 완전성 확인. 새 패키지는 내용을 교체하는 것이며 파일을 추가만 하는 것이 아닙니다. 새 패키지에 없는 기존 references/, assets/ 등의 내용은 제거될 수 있습니다. 유지해야 할 부속 파일을 함께 패키징하고 안내에 따라 새 버전을 입력하십시오. .md만 업로드하면 부속 파일 전체를 가져온 것이 아닙니다.
삭제 전 영향 확인. 삭제하면 Skill과 그 이력, 원본 파일이 제거되며, 현재 보기에서 숨기기만 하는 것이 아닙니다. Agent, 공간 또는 대화에서 아직 사용 중인지 먼저 확인하십시오. 잠시 사용하지 않으려는 것뿐이라면 활성화 상태나 대화 선호를 조정하는 것이 좋습니다.
공유 및 회사에 게시
개인 버전으로 복사. 시스템 스킬이나 회사 스킬을 개인 Skill로 복사할 수 있으며, 공유 원본을 수정하지 않고 방법을 조정할 때 적합합니다. 복사한 후 이름, 본문, 부속 파일을 확인하십시오. 사본은 독립적으로 유지 관리되며 원본의 업데이트를 자동으로 따르지 않습니다.
동료에게 공유. 직접 생성한 Skill을 같은 회사의 멤버에게 공유합니다. 상대방이 초대를 수락하면 독립된 개인 사본을 받게 되며, 공유는 같은 Skill을 공동 편집하는 것이 아닙니다.
개인 Skill의 공유 진입점에서 같은 회사의 멤버를 선택하고 초대를 보냅니다. 받는 사람은 심사 및 공유의 공유 페이지에서 초대를 처리하고, 수락한 후 개인 Skill 목록을 확인합니다. 공유 및 수락 작업에는 해당 개인 샌드박스를 사용할 수 있어야 합니다. 사본을 이후에 수정해도 다른 사람에게 자동으로 동기화되지 않습니다.
회사에 게시. 회사 멤버가 재사용하도록 하려면 본인의 개인 Skill에서 회사로 제출을 선택하고 양식에 정보를 입력하여 제출합니다. 심사 및 공유에서 심사 대기, 승인됨, 반려됨 또는 취소됨 상태를 확인합니다. 승인자는 제출 내용을 확인하고 승인하거나 반려할 수 있으며, 신청자는 아직 대기 중인 신청을 취소할 수 있습니다.
승인된 후에도 회사 사본의 게시를 완료해야 하며, 회사 스킬 목록에 사용 가능한 결과가 나타나는 것을 기준으로 합니다. 원래의 개인 Skill이 바로 회사 스킬로 바뀌지는 않으며, 개인 버전을 계속 수정해도 이미 게시된 회사 버전은 자동으로 업데이트되지 않습니다. 승인된 것으로 표시되는데 회사 목록에 사용 가능한 결과가 없다면 먼저 새로고침하여 확인한 다음 관리자에게 게시 상황 확인을 요청하십시오. 반복해서 제출하지 마십시오.
회사 스킬이 게시된 후에도 실제 용도에 맞게 Agent 또는 워크스페이스 공용 기능에 설정해야 하며, 모든 대화의 설정을 자동으로 대체하지는 않습니다.
다운로드, 외부 설치 및 자주 묻는 질문
파일 다운로드. Skill 카드나 상세에서 다운로드합니다. 기본적으로 ZIP으로 다운로드되며 .zip 또는 .skill 형식을 선택할 수도 있습니다. 다운로드한 것은 파일 패키지이며, 외부 클라이언트에 설치되었다는 의미가 아니고 플랫폼의 Agent나 워크스페이스에 자동으로 설정되지도 않습니다.
외부 클라이언트에 설치. 상세에 클라이언트에 추가 진입점이 있으면 안내에 따라 설치를 완료할 수 있습니다. 수동으로 설치하기 전에 대상 클라이언트가 Skill과 해당 파일 구조를 지원하는지 먼저 확인하십시오. 의존하는 도구, 실행 환경, 권한 부여는 대상 환경에서 별도로 준비해야 하며, 다운로드에 성공했다는 것만으로 방법이 실행 가능하다고 판단할 수 없습니다.
- 목록에서 Skill을 찾을 수 없음: 검색어와 필터 조건을 지우고 시스템, 회사, 개인 출처와 현재 신분을 확인합니다. 공유 공간의 공용 기능은 개인 Skill을 받지 않으므로, 공유하여 재사용해야 한다면 먼저 회사 게시를 완료하십시오.
- 활성화했는데 대화에서 사용되지 않음: 현재 공간, Agent 설정, 대화의 자동 사용 선호와 현재 메시지의 선택을 확인한 다음, 작업이 설명과 일치하는지, 의존 항목을 사용할 수 있는지 확인합니다. 다운로드 완료를 설정 완료로 간주하지 마십시오. 작업 방법은 대화를 참고하십시오.
- 업로드 실패 또는 내용 누락: 형식, 패키지 크기, 루트 디렉터리의
SKILL.md, 비어 있지 않은 본문, 부속 파일의 패키징 여부를 확인하고, 미리보기 안내에 따라 이름과 버전을 수정합니다. - 저장할 때 버전 충돌 안내가 표시됨: 새로고침하여 현재 내용, 버전 및 다른 사람의 변경 사항을 확인한 다음, 유지해야 할 내용을 병합하고 더 높은 버전을 입력합니다. 이전 버전으로 반복해서 덮어쓰지 마십시오.
- 편집, 공유 또는 회사 생성 진입점이 없음: 먼저 리소스 출처, 소유자, 회사 리소스 관리 권한, 샌드박스 상태를 확인합니다. 시스템 스킬은 읽기 전용이며, 회사 관리 권한과 공간 관리 권한은 별개입니다.