.md

스킬 관리 화면에서 할 수 있는 것

관리자 > 스킬 관리 에서 우리 회사 구성원 모두가 쓸 '우리회사 스킬'을 등록하고, 켜고 끕니다.

관리자 왼쪽 메뉴의 사내 에이전트 > 스킬 관리 에 있어요.

스킬이 뭔가요

자주 반복하는 업무를 AI가 똑같이 따라 하도록 정리해둔 설명서예요.

예를 들어 "고객 CS 이메일 초안 만들기" 를 스킬로 만들어 두면, 직원이 매번 형식과 말투를 설명하지 않아도 회사 기준에 맞는 초안이 나옵니다.

직원은 에이전트 대화창에서 /스킬이름 을 적거나, 입력창의 스킬 버튼으로 불러와 써요.

스킬 종류

종류 누가 만드나 누가 쓰나 관리자 화면에서
웍스 공식 스킬 웍스AI가 기본 제공 모든 구성원 보기만 (항상 켜져 있음)
우리회사 스킬 관리자가 이 화면에서 등록 우리 회사 구성원 모두 등록·편집·삭제·켜고 끄기
내 스킬 직원이 직접 만든 사람만 보이지 않아요

회사 업무 기준을 담으시려면 우리회사 스킬로 등록하시면 됩니다.

화면에 있는 것

목록에는 우리회사 스킬과 웍스 공식 스킬이 함께 보여요. 이름 옆 라벨로 구분합니다.

항목 무엇을 하나
파일로 등록 오른쪽 위 버튼. 새 우리회사 스킬을 등록해요
이름·설명 검색 스킬이 많을 때 이름이나 설명으로 찾기
이름 / 설명 무엇을 하는 스킬인지
허용 여부 직원이 쓸 수 있게 할지 켜고 끄는 스위치 (우리회사 스킬만)
줄을 누르면 아래로 펼쳐져 범위·지원 모델·등록일·수정일과 상세 / 편집 / 삭제 버튼이 보여요 (우리회사 스킬)

목록 맨 위에는 웍스 공식 스킬 skill-creator 가 항상 먼저 보여요.

웍스 공식 스킬은 스위치가 잠겨 있어요. 옆 아이콘에 "웍스 공식 스킬은 수정·삭제할 수 없고 항상 켜져 있어요." 라고 나옵니다.

웍스 공식 스킬은 설명 칸에 짧은 안내만 보여요. 줄을 펼치면 범위 만 나오고, 상세 에서도 지원 모델과 SKILL.md 는 보이지 않아요.

등록하는 방법

  1. 오른쪽 위 파일로 등록 을 누릅니다
  2. 이름, 설명, 스킬 파일을 넣습니다
  3. 등록 을 누릅니다

등록이나 저장이 안 되면 서랍 맨 위 빨간 상자에 이유가 나와요. 화면이 그 상자로 올라가니 내용을 보고 고쳐 주세요.

칸 규칙
이름 영어 소문자·숫자·하이픈(-)만, 64자 이하, 맨 앞뒤에 하이픈은 안 돼요
설명 꼭 넣어야 해요. 언제 쓰는 스킬인지 떠올릴 말(예: 메일, 보고서, 응답)을 넉넉히 적으면 잘 불러와져요
스킬 파일 SKILL.md 가 꼭 들어 있어야 해요. 클릭 또는 드래그하여 파일 첨부

올릴 수 있는 파일

ZIP 1개, 또는 SKILL.md 와 함께 쓸 파일들을 올려요.

종류 확장자
서식 docx · xlsx · pptx · pdf · hwp · hwpx
데이터 csv · json · yaml
이미지 png · jpg
  • 스크립트·텍스트 파일은 한 개당 1MB 이하
  • 전부 합쳐 30MB 이하, 최대 30개

회사 파일 통제가 스킬 파일에도 걸려요

올린 파일은 등록 전에 관리자 > 파일 통제 설정대로 검사해요. 관리자 화면에서 등록할 때도 같아요.

  • 업로드 가능한 파일 형식 제한 에 없는 서식 파일(docx 등)은 올릴 수 없어요. 스크립트·텍스트 파일은 이 제한을 받지 않아요
  • 개인정보 등 민감한 내용이 발견되면 등록되지 않아요. 가려서 저장하지 않고, 어느 파일인지 이유가 함께 나와요. 그 내용을 지우고 다시 올려 주세요
  • 확장자만 바꾼 파일(예: 압축 파일 이름을 .txt 로 바꾼 것)은 파일 내용이 확장자와 맞지 않습니다 로 막혀요
  • 파일이 많거나 커서 검사가 오래 걸리면 파일 검사가 60초 안에 끝나지 않았습니다 가 떠요. 파일 수를 줄여 다시 올려 주세요

넣으면 안 되는 것

화면에도 안내가 있어요.

  • 개인정보·비밀번호·인증키는 넣지 마세요
  • 이 스킬을 쓸 수 있는 사람은 모두 내용을 볼 수 있어요. 특정 사람만 봐야 하는 자료는 드라이브에 두세요
  • 스킬 내용은 답변을 만드는 AI 모델로 전송돼요

고치고 지우기

목록에서 스킬 줄을 눌러 펼친 뒤 버튼을 누릅니다.

버튼 무엇을 하나
상세 스킬 상세 창에서 설명과 SKILL.md 를 확인해요. SKILL.md 복사 도 여기 있어요 (우리회사 스킬만)
편집 스킬 편집 창의 메타데이터 탭에서 이름·설명·파일을, SKILL.md 본문 탭에서 본문을 고쳐요
삭제 스킬을 지워요 (스킬 삭제 확인 창이 떠요)

편집 화면에는 지금 올라가 있는 파일이 기존 파일 로 표시되고(없으면 파일 없음), ZIP 다운로드 로 내려받을 수 있어요.

번들 교체 (옵션) 로 파일을 새로 올릴 때는

  • ZIP 을 올리면 새 ZIP 에 없는 기존 파일은 지워져요
  • 파일을 하나씩 올리면 기존 파일에 합쳐져요. SKILL.md 를 같이 안 올리면 지금 것이 그대로 남아요
  • 하위 폴더(scripts/ 등) 안의 파일을 바꾸려면 ZIP 으로 올려 주세요
  • 비워 두면 이름·설명만 바뀌어요

등록·수정 뒤 "확인할 내용이 있어요" 가 뜨면, 저장은 됐지만 살펴볼 점이 있다는 뜻이에요. 안내를 읽고 확인했어요 를 누르세요.

SKILL.md 가 너무 길면 저장은 되지만 "확인할 내용이 있어요" 에 SKILL.md 가 …KB 로 상한 …KB 를 넘어요. 가 떠요. 진행 순서와 핵심 규칙만 SKILL.md 에 남기고, 자세한 설명·예시·양식은 별도 파일로 나눠 주세요.

직원 화면에서는 이렇게 보여요

직원은 왼쪽 메뉴 새 대화 아래 스킬 줄이나 계정 메뉴의 스킬 관리 에서 스킬을 봅니다. 스킬 줄에 마우스를 올리면 짧은 사용법 카드가 떠요.

직원 화면 맨 위에는 설명과 만드는 길 카드 세 개가 있어요. 대화로 만들기 를 누르면 새 대화 입력창에 /skill-creator 가 들어가요. 파일로 등록 은 등록 창을 열고, 웍스 공식 스킬 둘러보기 는 웍스 공식 탭으로 옮겨 줘요.

그 아래에는 1분 사용법 영상이 소리 없이 반복 재생돼요. 튜토리얼 숨기기 로 접고 1분 만에 살펴보기 로 다시 펼쳐요.

탭 옆에는 스킬 수가 나오고(예: 전체 · 10), 최근 사용순 · 최신 등록순 으로 정렬할 수 있어요. 카드의 대화에서 쓰기 를 누르면 새 대화 입력창에 /스킬이름 이 들어가요.

대화로 스킬을 등록하면 답변 끝에 스킬을 등록했어요 카드가 붙어요. 스킬 열기 · 지금 시험 · 에이전트에 연결 을 바로 누를 수 있어요.

탭은 네 개예요.

탭 보이는 것
전체 아래 셋 모두
내 스킬 직원 본인이 만든 스킬. 본인이 고치고 지울 수 있어요
우리회사 스킬 관리자가 등록한 스킬. 직원은 보기만 해요
웍스 공식 스킬 웍스AI가 제공하는 스킬. 보기만 해요

파일 업로드를 막아 둔 회사(파일 통제 에서 파일(문서) 업로드 를 차단 한 회사. 이미지 업로드만 막은 경우는 해당 없어요)에서는 직원이 스킬 화면에서 파일을 올릴 수 없어요. 만들기 창에는 회사 설정으로 파일을 올릴 수 없어요. 스킬을 만들려면 대화에서 "/skill-creator 스킬 만들어 줘"라고 요청해 보세요. 가 보이고, 편집 창에서는 파일 교체 대신 SKILL.md 본문 탭에서 내용을 바로 고칠 수 있어요.


자주 묻는 질문

Q. 스킬과 에이전트가 뭐가 다른가요?

  • 에이전트 — 회사 자료를 알고 답하는 대화 상대
  • 스킬 — 특정 업무를 어떻게 처리할지 정해둔 방법

에이전트가 "누구"라면 스킬은 "어떻게"에 가까워요.

Q. 직원은 스킬을 어떻게 쓰나요?

에이전트 대화창에서 /스킬이름 을 적거나, 입력창의 스킬 버튼에서 고르면 돼요.

Q. 스킬을 만들려면 개발을 알아야 하나요?

SKILL.md 라는 문서 형식으로 작성합니다. 코딩은 아니지만 형식을 맞춰야 해요. 어려우시면 문의해 주세요.

Q. 예전에 '전사 스킬', '공용 스킬' 이라고 보였어요.

같은 것이에요. 지금은 전사 스킬 → 우리회사 스킬, 공용 스킬 → 웍스 공식 스킬 로 보여요.

Q. 관리자 화면에 내 스킬이 안 보여요.

정상이에요. 관리자 화면에는 우리회사 스킬과 웍스 공식 스킬만 나와요. 본인이 만든 내 스킬은 직원 화면 계정 메뉴의 스킬 관리 에서 보세요.

Q. 직원 화면에서 우리회사 스킬을 고칠 수 없어요.

직원 화면에서는 내 스킬만 고치고 지울 수 있어요. 관리자여도 마찬가지예요. 우리회사 스킬은 관리자 > 스킬 관리 에서 고쳐 주세요.

Q. SKILL.md 내용을 불러오지 못했어요 라고 나와요.

옛 문구 SKILL.md를 찾을 수 없습니다 와 같은 안내예요. 이 문구는 등록할 때가 아니라 상세 창에서 스킬 본문이 비어 있을 때 나와요. 편집 의 SKILL.md 본문 탭에서 내용을 채우거나, SKILL.md 가 든 파일을 다시 올려 주세요.

Q. 스킬 번들이 유효하지 않습니다 라고 나와요.

올린 파일 묶음(ZIP 또는 여러 파일)에 문제가 있다는 뜻이에요. 문구 뒤 괄호 안에 실제 이유가 함께 나오니 그 내용을 보고 고쳐 주세요. 자주 나오는 이유는 이래요.

이유 이렇게 고쳐요
SKILL.md 가 번들에 없음 SKILL.md 를 맨 위에 두세요. ZIP 안에 폴더가 하나만 있으면 그 안의 SKILL.md 도 알아봐요. 맨 위에 폴더가 둘 이상이거나 다른 파일이 섞여 있으면 찾지 못해요
머리말이 없거나 깨짐 SKILL.md 맨 위 --- 로 감싼 부분에 name 과 description 을 넣어 주세요. 이름 규칙은 아래 "이름에 한글을 쓸 수 있나요?" 를 보세요
허용되지 않은 확장자 위 등록하는 방법의 허용 형식만 올릴 수 있어요
파일 내용과 확장자가 다름 보안 프로그램(DRM)이 걸린 파일이면 해제한 뒤 올려 주세요
크기·개수 초과 모두 합쳐 30MB, 최대 30개까지예요
암호가 걸렸거나 손상된 ZIP 암호 없이 다시 압축해 올려 주세요
스크립트 검사에서 막힘 들어 있는 스크립트가 안전 검사를 통과하지 못했어요. 내용을 확인해 주세요

Q. 다른 AI 서비스에서 쓰던 프로젝트를 그대로 가져올 수 있나요?

가져오는 기능은 따로 없어요. SKILL.md 형식에 맞춰 ZIP 이나 파일로 올려 주세요.

Q. "설명은 필수입니다" 라고 나와요.

설명란을 채워주세요. 직원이 보고 무엇에 쓰는지 알 수 있게 적으시면 됩니다.

Q. 이름에 한글을 쓸 수 있나요?

없어요. 이름은 영어 소문자·숫자·하이픈(-) 만 돼요. 무엇을 하는 스킬인지는 설명에 한글로 적어 주세요.

Q. 한글 파일(hwp)이나 PDF 양식을 넣을 수 있나요?

네. docx · xlsx · pptx · pdf · hwp · hwpx 서식과 csv · json · yaml 데이터, png · jpg 이미지를 함께 올릴 수 있어요. 전부 합쳐 30MB, 최대 30개까지예요.

Q. 파일이 올라가지 않아요.

아래를 확인해 주세요.

  • 위 표에 없는 확장자는 아닌지
  • 스크립트·텍스트 파일이 한 개에 1MB 를 넘지 않는지
  • 전체가 30MB, 30개를 넘지 않는지

Q. 직원 화면에 '회사 설정으로 파일을 올릴 수 없어요' 가 떠요.

회사에서 파일 통제 의 파일(문서) 업로드 를 차단 해 두셨기 때문이에요(이미지 업로드만 막은 경우는 해당 없어요). 스킬 파일 올리기에도 같은 차단이 걸려요. 직원은 대화에서 "/skill-creator 스킬 만들어 줘" 라고 요청하면 AI가 만들어 내 스킬로 등록해 줘요. 이미 있는 스킬은 SKILL.md 탭에서 내용을 고칠 수 있어요.

Q. 등록하려니 개인정보 같은 민감한 내용이 발견됐다며 안 돼요.

회사 파일 통제의 검사에서 걸린 거예요. 스킬 파일은 가려서 저장하지 않고 등록을 막아요. 이유에 나온 파일에서 그 내용을 지우고 다시 올려 주세요.

Q. 기존 스킬을 고치려면?

목록에서 스킬을 눌러 펼친 뒤 편집 을 누르세요. 파일을 바꾸시려면 번들 교체 (옵션) 를 쓰세요.

Q. 만든 스킬을 백업하고 싶어요.

편집 화면의 ZIP 다운로드로 내려받으실 수 있어요.

Q. 잠깐 못 쓰게 하려면요?

허용 여부 스위치를 끄세요. 직원이 쓸 수 없게 되고, 다시 켜면 쓸 수 있어요. 삭제하지 않아도 돼요.

Q. 웍스 공식 스킬을 끄거나 고칠 수 있나요?

없어요. 웍스 공식 스킬은 항상 켜져 있고 수정·삭제할 수 없어요. 웍스 공식 스킬은 이름과 짧은 안내만 보여요. 비슷한 스킬이 필요하면 우리회사 스킬로 새로 만들어 주세요.

Q. 웍스 공식 스킬의 SKILL.md 는 볼 수 없나요?

볼 수 없어요. 웍스 공식 스킬은 목록과 상세 모두 이름과 짧은 안내만 보여요.

Q. 스킬 추가 버튼이 안 보여요.

같은 버튼이 파일로 등록 으로 보여요. 관리자 > 스킬 관리 오른쪽 위에 있어요.

Q. 스킬에 회사 자료를 넣어도 되나요?

회사 기준·양식은 넣을 수 있어요. 다만 이 스킬을 쓸 수 있는 사람은 모두 내용을 볼 수 있어요. 개인정보·비밀번호·인증키는 넣지 마시고, 특정 사람만 봐야 하는 자료는 드라이브에 두세요.

Q. 스킬 사용 횟수를 볼 수 있나요?

관리자 화면에서는 스킬별 사용 횟수를 보여드리지 않아요. 필요하시면 고객지원으로 문의해 주세요.

Q. '지원 모델' 에 '전체 모델' 이라고 나와요.

어느 AI 모델에서나 쓸 수 있는 스킬이라는 뜻이에요. 펼친 줄과 상세 에서 확인할 수 있어요. 우리회사 스킬에서만 보이는 칸이에요.

Q. 스킬을 에이전트에 붙일 수 있나요?

네. 에이전트 만들기·수정 창의 스킬 선택 에서 고르시면 돼요. 회사 직원이 함께 쓰는 에이전트에는 내 스킬 을 붙일 수 없어요. 직원이 공식 에이전트 등록을 신청할 때도 내 스킬은 함께 가지 않으니, 같이 쓰려면 회사 스킬로 먼저 등록해 주세요.

Q. 누가 스킬을 등록·수정했는지 볼 수 있나요?

관리자 > 이용 기록 에서 유형 스킬 로 골라 보시면 돼요.

Q. 스킬을 쓰면 요금이 더 나오나요?

스킬 자체에는 요금이 없어요. 직원이 쓴 만큼만 나갑니다.

이럴 땐 문의해 주세요

  • 스킬을 만들고 싶은데 작성이 어려울 때
  • 등록이 계속 실패할 때

Last updated