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

> Source: https://docs.wrks.ai/admin-help/features/skills · Last updated: 2026-11-05

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

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

### 스킬이 뭔가요

**자주 반복하는 업무를 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. 스킬을 쓰면 요금이 더 나오나요?**

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

### 이럴 땐 문의해 주세요

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