> For the complete documentation index, see [llms.txt](https://docs.wrks.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wrks.ai/admin-help/features/skills.md).

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

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

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

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

### 스킬이 뭔가요

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

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

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

### 스킬 종류

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

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

### 화면에 있는 것

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

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

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

### 등록하는 방법

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

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

**올릴 수 있는 파일**

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

| 종류  | 확장자                                       |
| --- | ----------------------------------------- |
| 서식  | docx · xlsx · pptx · pdf · **hwp · hwpx** |
| 데이터 | csv · json · yaml                         |
| 이미지 | png · jpg                                 |

* 스크립트·텍스트·CSV 파일은 **한 개당 1MB 이하**
* 전부 합쳐 **30MB 이하**, **최대 30개**

**넣으면 안 되는 것**

화면에도 안내가 있어요.

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

### 고치고 지우기

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

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

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

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

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

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

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

직원은 계정 메뉴의 **`스킬 관리`** 에서 스킬을 봅니다. 탭이 네 개예요.

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

***

### 자주 묻는 질문

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

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

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

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

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

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

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

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

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

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

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

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

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

**Q. "SKILL.md를 찾을 수 없습니다" 라고 나와요.**

올린 파일 안에 `SKILL.md` 가 있어야 합니다. 파일 이름과 위치를 확인해 주세요.

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

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

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

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

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

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

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

아래를 확인해 주세요.

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

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

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

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

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

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

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

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

없어요. 웍스 공식 스킬은 **항상 켜져 있고** 수정·삭제할 수 없어요. `상세` 에서 내용을 참고해 우리회사 스킬로 새로 만드시는 방법이 있습니다.

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

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

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

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

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

어느 AI 모델에서나 쓸 수 있는 스킬이라는 뜻이에요. 펼친 줄과 `상세` 에서 확인할 수 있어요.

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

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

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

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.wrks.ai/admin-help/features/skills.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.