# 스킬

> Source: https://docs.wrks.ai/user-guide/skills · Last updated: 2026-11-06

스킬은 자주 반복하는 일을 AI가 똑같이 따라 하도록 정리해 둔 나만의 설명서예요. 만들어 두면 입력창에 '/스킬이름'을 적어 불러와 쓸 수 있어요.

예를 들어 '회의 메모를 우리 팀 회의록 양식으로 정리하기'를 스킬로 만들어 두면, 매번 양식과 말투를 설명하지 않아도 같은 모양의 회의록이 나와요.

> **에이전트와 무엇이 다른가요?** 에이전트가 "누구"라면 스킬은 "어떻게"에 가까워요. 에이전트는 역할을 가진 대화 상대이고, 스킬은 어떤 일을 처리하는 방법이에요.

<figure><img src="/files/hDzeKdVVLS4S35Jerqtr" alt="스킬 화면 둘러보기 → [대화에서 쓰기] → 입력창의 / 목록 → 파일로 등록"><figcaption><p>스킬 화면 둘러보기 → [대화에서 쓰기] → 입력창의 / 목록 → 파일로 등록</p></figcaption></figure>

## 스킬 종류

| 종류 | 누가 만드나요 | 누가 쓰나요 |
| --- | --- | --- |
| 웍스 공식 스킬 | 웍스AI | 모든 사람 (보기만 할 수 있어요) |
| 우리회사 스킬 | 회사 관리자 | 회사 사람 모두 (보기만 할 수 있어요) |
| 내 스킬 | 나 | 나만 (고치고 지울 수 있어요) |

## 스킬 쓰기

입력창에서 둘 중 편한 방법으로 불러와요.

* 입력창에 '/'를 적고 스킬 이름을 이어서 적어요. 예: /skill-creator
* 입력창 왼쪽 **+** 버튼 → **스킬**을 누르고 목록에서 골라요. 목록에는 '내 스킬', '웍스 공식 스킬' 같은 표시가 붙어 있어요.
* 스킬 화면의 카드에서 **대화에서 쓰기**를 누르면, 입력창에 그 스킬이 들어간 채로 대화 화면이 열려요.

그다음 하고 싶은 일을 이어서 적고 보내요.

* 에이전트를 만들 때 **스킬 선택**에서 스킬을 켜 두면, 그 에이전트가 필요할 때 알아서 꺼내 써요.
* 스킬 자체에는 요금이 없어요. AI를 쓴 만큼만 요금이 나가요.

## 스킬 화면

왼쪽 사이드바 **스킬**을 누르면 스킬 화면이 열려요. 입력창에 '/'를 적었을 때 뜨는 목록 아래 **스킬 관리**를 눌러도 이 화면으로 와요.

화면 위쪽에는 스킬을 시작하는 버튼 세 개가 있어요.

| 버튼 | 하는 일 |
| --- | --- |
| 대화로 만들기 (추천) | 입력창에 '/skill-creator'가 채워진 대화 화면으로 가요. 하고 싶은 일을 말하고 양식·예시 파일을 올리면 AI가 물어 가며 스킬을 짜 줘요 (아래 skill-creator 참고) |
| 파일로 등록 | SKILL.md나 ZIP 파일이 이미 있을 때 써요. 오른쪽에 **파일로 등록** 창이 열려요 (아래 '스킬 직접 등록하기' 참고) |
| 웍스 공식 스킬 둘러보기 | 웍스가 미리 만들어 둔 스킬을 바로 써 볼 수 있어요 |

* 탭: **전체**, **내 스킬**, **우리회사 스킬**, **웍스 공식 스킬**
* 검색: 이름이나 설명으로 찾아요.
* 스킬은 카드로 보여요. 카드의 **상세**를 누르면 자세한 내용을 보고, **대화에서 쓰기**를 누르면 그 스킬로 바로 대화를 시작해요.
* 고치고 지우는 것은 내 스킬만 할 수 있어요.

## 스킬을 쉽게 만드는 방법 — skill-creator

스킬 파일을 직접 쓰기 어렵다면, 웍스 공식 스킬인 **skill-creator**에게 만들어 달라고 해요.

1. 입력창에 '/skill-creator'를 적고, 만들고 싶은 스킬을 설명해요. 예: "/skill-creator 회의 메모를 우리 팀 회의록 양식으로 바꾸는 스킬 만들어 줘". 우리 팀 양식이나 좋은 예시 파일을 함께 올리면 더 잘 만들어요.
2. AI가 스킬 초안을 보여 주고 "이대로 등록할까요?"라고 물어요.
3. 마음에 들면 **이대로 등록**을 고르고 **답변 보내기**를 눌러요. 고칠 점이 있으면 **수정 후 등록**을 골라요.
4. 등록한 스킬은 스킬 화면의 **내 스킬** 탭에서 볼 수 있어요.

## 스킬 직접 등록하기

1. 스킬 화면 위쪽의 **파일로 등록**을 눌러요.
2. 이름, 설명, 스킬 파일을 채워요. 칸마다 규칙은 이 목록 아래 표에 있어요.
3. **등록**을 눌러요.

| 칸 | 규칙 |
| --- | --- |
| 이름 * | 영어 소문자, 숫자, 하이픈(-)만 써요. 64자까지이고 맨 앞과 맨 끝에는 하이픈을 쓸 수 없어요. 예: weekly-report |
| 설명 * | 언제 쓰는 스킬인지 떠올릴 말을 넉넉히 적어요. 예: 메일, 보고서, 응답. 1,024자까지 |
| 스킬 파일 * | ZIP(여러 파일을 하나로 묶은 압축 파일) 1개, 또는 SKILL.md와 함께 쓸 파일들을 올려요. SKILL.md는 꼭 있어야 해요 |

* SKILL.md만 올려도 되고, 함께 쓸 파일을 같이 골라도 돼요. .md 파일을 하나만 올리면 그 파일이 SKILL.md로 등록되고, .md 파일이 여러 개면 그중 하나는 이름이 SKILL.md여야 해요.
* 폴더 안에 둬야 하는 파일(예: scripts/run.py)이 있으면 폴더째 ZIP으로 묶어 올려요.
* 스크립트·글 파일(py, sh, md, txt, json, yaml)은 한 개에 1MB까지예요. 서식·데이터·이미지 파일(docx, xlsx, pptx, pdf, hwp, hwpx, html, csv, png, jpg)은 전체 용량 안에서 자유롭게 올려요.
* 모두 합쳐 30개, 30MB까지 올릴 수 있어요.
* SKILL.md는 스킬 내용을 적는 문서예요. 코딩은 아니지만 정해진 형식이 있어요. 어려우면 skill-creator를 쓰세요.
* 이름에는 한글을 쓸 수 없어요. 무엇을 하는 스킬인지는 설명에 한글로 적어요.

> **주의** 개인정보, 비밀번호, 인증키(서비스에 접속하는 비밀 열쇠)는 넣지 마세요. 회사 기준이나 양식은 넣을 수 있지만, 이 스킬을 쓸 수 있는 사람은 모두 내용을 볼 수 있어요. 특정 사람만 봐야 하는 자료는 웍스 드라이브에 두세요. 스킬 내용은 답변을 만드는 AI 모델로 전송돼요.