# 스킬 관리
> Source: https://docs.wrks.ai/admin-guide/admin-agents/skills · Last updated: 2026-11-05
스킬은 **자주 반복하는 업무를 AI가 똑같이 따라 하도록 정리해 둔 설명서**예요. 스킬 관리 화면에서 **우리회사 스킬**을 등록해 두면, 우리회사 구성원 누구나 에이전트 대화창에서 `/스킬이름` 으로 불러와 쓸 수 있어요.
### 시작하기 전에
* 이 기능은 **관리자**가 사용할 수 있어요.
* 관리자 왼쪽 메뉴의 **사내 에이전트 > 스킬 관리**에서 들어갈 수 있습니다.
### 스킬은 두 가지예요
| 표시 | 무엇인가요 | 관리자가 할 수 있는 것 |
| ------------ | ------------------ | -------------------- |
| **우리회사 스킬** | 우리 회사 관리자가 등록한 스킬 | 등록 · 편집 · 삭제 · 켜고 끄기 |
| **웍스 공식 스킬** | 웍스AI가 기본으로 넣어 둔 스킬 | 보기만 (항상 켜져 있어요) |
### 따라하기
**1단계. 스킬 목록 보기**
등록된 스킬이 표로 보여요. 이름 옆 배지로 **우리회사 스킬**인지 **웍스 공식 스킬**인지 구분할 수 있어요. 오른쪽 위 **이름·설명 검색** 칸으로 찾을 수 있어요.
웍스 공식 스킬은 설명 칸에 짧은 안내만 보이고, 목록 맨 위에는 `skill-creator` 가 먼저 나와요.
**허용 여부** 스위치로 우리회사 스킬을 켜고 끌 수 있어요. 웍스 공식 스킬은 스위치가 잠겨 있고, 옆 아이콘에 마우스를 올리면 "웍스 공식 스킬은 수정·삭제할 수 없고 항상 켜져 있어요." 라고 나와요.
1단계 화면
**2단계. 스킬 자세히 보기·고치기**
표에서 스킬 줄을 누르면 아래로 펼쳐져요. **\[상세]** 로 우리회사 스킬의 내용(SKILL.md)을 확인할 수 있어요. 웍스 공식 스킬은 이름과 짧은 안내만 보여요. 우리회사 스킬은 **\[편집]** · **\[삭제]** 도 할 수 있어요.
**3단계. 스킬 등록하기**
오른쪽 위의 **\[파일로 등록]** 버튼을 누르면 오른쪽에 입력 칸이 열려요.
| 칸 | 이렇게 넣어요 |
| --------- | --------------------------------------------------------------------- |
| **이름** | 영소문자 · 숫자 · 하이픈(-)만, 64자까지 (맨 앞뒤에 하이픈은 안 돼요). 구성원은 이 이름으로 `/이름` 을 불러요 |
| **설명** | 언제 쓰는 스킬인지 적어요. 메일·보고서 같은 업무 키워드를 넉넉히 넣으면 잘 불려요 |
| **스킬 파일** | ZIP 1개, 또는 SKILL.md 와 부속 파일들. **SKILL.md 는 꼭 있어야 해요** |
다 넣고 **\[등록]** 을 누르면 끝이에요.
등록이나 저장이 안 되면 서랍 맨 위 빨간 상자에 이유가 나와요. 화면이 그 상자로 올라가니 내용을 보고 고쳐 주세요.
3단계 화면
### 올릴 수 있는 파일
| 종류 | 확장자 |
| --- | ------------------------------------- |
| 서식 | docx · xlsx · pptx · pdf · hwp · hwpx |
| 데이터 | csv · json · yaml |
| 이미지 | png · jpg |
* 스크립트·텍스트 파일은 하나에 **1MB 이하**
* 모두 합쳐 **30MB 이하**, 최대 **30개**
**편집할 때 파일을 다시 올리면**
* **ZIP** 을 올리면 새 ZIP 에 없는 기존 파일은 지워져요 (통째로 바뀌어요)
* **파일 몇 개만** 올리면 기존 파일에 합쳐져요. SKILL.md 를 같이 올리지 않으면 지금 SKILL.md 가 그대로 남아요
* 하위 폴더(scripts/ 등) 안의 파일을 바꾸려면 ZIP 으로 올려 주세요
* 파일을 비워 두면 이름·설명만 바뀌어요
**"스킬 번들이 유효하지 않습니다. (…)"** 가 뜨면 괄호 안의 이유를 먼저 보세요. SKILL.md 가 맨 위에 없거나, 머리말(name·description)이 빠졌거나, 허용되지 않은 형식·크기·개수이거나, 암호가 걸린 ZIP 인 경우가 많아요.
괄호 안에 파일 이름과 **민감정보가 포함되어 차단되었습니다** 가 보이면 그 파일에서 개인정보가 발견된 거예요. 스킬은 개인정보를 가려서 저장하지 않고 등록 자체를 막아요. 해당 내용을 지우고 다시 올려 주세요. 화면에서 SKILL.md 를 고쳐 저장할 때도 같아요.
등록·편집 뒤 **"등록됐어요. 확인할 내용이 있어요."** (편집 때는 "저장됐어요. …") 창이 뜨면, 스킬은 저장됐지만 살펴볼 점이 있다는 뜻이에요. 예를 들어 설명이 너무 짧아 잘 불리지 않을 수 있다거나, 같은 이름의 스킬이 있다거나, SKILL.md 를 자동으로 고쳐 저장했다는 안내예요. 내용을 읽고 **\[확인했어요]** 를 눌러 주세요.
SKILL.md 가 너무 길면 저장은 되지만 이 창에 `SKILL.md 가 …KB 로 상한 …KB 를 넘어요.` 가 떠요. 진행 순서와 핵심 규칙만 SKILL.md 에 남기고, 자세한 설명·예시·양식은 별도 파일로 나눠 주세요.
### 주의해 주세요
화면 위에도 적혀 있듯이 **개인정보 · 비밀번호 · 인증키는 스킬에 넣지 마세요.**
* 이 스킬을 쓸 수 있는 사람은 **모두 내용을 볼 수 있어요.** 특정 사람만 봐야 하는 자료는 드라이브에 두세요
* 스킬 내용은 답변을 만드는 AI 모델로 전송돼요
### 직원 화면에서는 이렇게 보여요
직원의 스킬 화면에는 **전체 · 내 스킬 · 우리회사 스킬 · 웍스 공식 스킬** 탭이 있어요. 직원은 **내 스킬**만 만들고 고칠 수 있고, 우리회사 스킬과 웍스 공식 스킬은 보기만 할 수 있어요.
* 직원 스킬 화면 맨 위에는 설명과 만드는 길 카드 세 개(**대화로 만들기 · 파일로 등록 · 웍스 공식 스킬 둘러보기**)가 있어요. **대화로 만들기** 를 누르면 새 대화 입력창에 `/skill-creator` 가 들어가요
* 만드는 길 카드 아래에는 **1분 사용법 영상**이 소리 없이 자동으로 재생돼요. **튜토리얼 숨기기** 로 접고 **1분 만에 살펴보기** 로 다시 펼 수 있어요
* 탭 옆에는 스킬 수가 나오고(예: **전체 · 10**), **최근 사용순 · 최신 등록순** 으로 정렬할 수 있어요. 카드의 **대화에서 쓰기** 를 누르면 새 대화 입력창에 **/스킬이름** 이 들어가요
* 대화로 스킬을 등록하면 답변 끝에 **스킬을 등록했어요** 카드가 붙고, **스킬 열기 · 지금 시험 · 에이전트에 연결** 을 바로 누를 수 있어요
* [**파일 통제**](https://docs.wrks.ai/admin-guide/admin-security/file-control)에서 **파일(문서) 업로드** 를 차단하면, 직원 화면에는 파일을 올리는 칸 대신 **"회사 설정으로 파일을 올릴 수 없어요. 스킬을 만들려면 대화에서 "/skill-creator 스킬 만들어 줘"라고 요청해 보세요. AI 가 만들어서 내 스킬로 등록해 드려요."** 가 보여요
* 이미 만든 스킬을 고칠 때는 파일 교체 칸 대신 **"회사 설정으로 파일을 올릴 수 없어요. SKILL.md 탭에서 내용은 바로 고칠 수 있어요."** 가 보여요. SKILL.md 내용은 화면에서 계속 고칠 수 있어요
우리회사 스킬을 누가 만들고 고쳤는지는 [**이용 기록**](https://docs.wrks.ai/admin-guide/admin-usage/action)에서 유형을 **스킬** 로 골라 확인하실 수 있어요.
회사 업무 기준·양식을 스킬로 만들어 두면 구성원 모두가 같은 방식으로 일할 수 있어요.
설정 하나하나와 자주 묻는 질문은 [**관리자 도움말**](https://docs.wrks.ai/admin-help)에 정리돼 있어요.