스킬이란
스킬은 이름이 스킬의 name과 같은 폴더입니다. 폴더에는 SKILL.md 파일과, 필요하다면 지침이 참조하는 참고 문서, 템플릿, 스크립트 같은 다른 파일이 들어갑니다.
SKILL.md는 두 부분으로 되어 있습니다. --- 줄 사이의 YAML 프런트매터에는 이름과 설명이 들어가고, 그 뒤의 Markdown 본문에는 지침이 들어갑니다.
직원이 스킬을 사용하는 방법
직원은 세 단계로 스킬을 사용합니다.
- 고르기. 직원은 매 턴마다 사용할 수 있는 스킬 목록을 봅니다. 목록에는 각 스킬의 이름, 설명, 그리고 최대 세 개의 트리거가 나옵니다. 직원은 설명을 읽고 결정하므로, 스킬이 무엇을 하고 언제 써야 하는지 설명에 적으세요.
- 불러오기. 직원은 스킬 이름으로
use_skill도구를 호출합니다. 도구는 지침, 스킬 폴더의 경로, 그리고 파일 이름을 돌려줍니다. 직원이 스킬을 읽는 방법은 이것 하나뿐입니다. - 작업하기. 직원은 지침을 따릅니다. 보조 파일은
read_skill_file로 읽고, 함께 들어 있는 스크립트는execute로 실행합니다.
트리거만으로 스킬이 불러와지는 일은 없습니다. 선택은 항상 직원이 합니다. 목록이 길어지면 직원은 find_skills로 검색할 수 있습니다.
첫 스킬 작성하기
스킬 이름으로 폴더를 만들고 그 안에 파일 하나를 넣으세요.
meeting-notes/ └── SKILL.md
--- name: meeting-notes description: Turn a meeting transcript into decisions, action items with owners, and open questions. Use when someone shares meeting notes or a transcript. --- # Meeting notes 1. List the decisions that were made. 2. List action items as "owner — task — due date". 3. List open questions that need a follow-up. Keep each list short. If the transcript names no owner for an item, write "unassigned".
폴더를 봇의 사용자 스킬 디렉터리에 넣으세요(스킬 위치 참고). Nebo는 약 1초 안에 새 폴더를 알아채며, 그 봇의 모든 직원이 스킬을 사용할 수 있습니다.
직원이 대신 스킬을 작성해 줄 수도 있습니다. 스킬을 저장해 달라고 요청하면 직원이 save_skill을 호출해 같은 사용자 스킬 디렉터리에 폴더를 씁니다.
로더가 적용하는 규칙
다음 규칙 중 하나라도 어긴 스킬은 불러와지지 않습니다. Nebo는 경고를 기록하고 해당 스킬을 건너뜁니다.
| 규칙 | 세부 내용 |
|---|---|
파일이 ---로 시작함 | 프런트매터가 파일의 맨 처음에 와야 합니다. 파일은 UTF-8이어야 합니다. |
name 필수 | 소문자, 숫자, 하이픈만 사용합니다. 하이픈으로 시작하거나 끝날 수 없고, 하이픈을 연속으로 쓸 수 없으며, 최대 64바이트입니다. |
description 필수 | 최대 1,024바이트입니다. |
| 필드 타입이 올바름 | YAML 타입이 잘못된 필드가 하나라도 있으면 파일 전체가 실패합니다. 버전은 "1.0.0"처럼 따옴표로 감싸세요. |
platform 일치 | 값이 있으면 나열된 운영 체제에서만 스킬이 불러와집니다. |
Nebo가 인식하지 못하는 프런트매터 키는 무시됩니다. 본문에는 크기 제한이 없지만, 지침이 짧을수록 작업할 여유가 더 생깁니다. 긴 내용은 직원이 필요할 때 읽는 파일로 옮기세요.
파일 추가하기
폴더 안에서 SKILL.md와 점 파일을 제외한 모든 파일을 직원이 사용할 수 있습니다. 폴더 이름은 자유롭게 정하면 됩니다. Nebo는 references/나 assets/에 특별한 의미를 두지 않습니다. scripts/나 bin/ 아래의 파일은 실행할 수 있습니다.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute 파일은 references/policy.md처럼 폴더 안의 경로로 가리키세요. 직원은 read_skill_file로 파일을 읽으며, 이 도구는 폴더 밖으로 나가는 경로를 거부합니다. 스크립트는 샌드박스 안에서 execute 도구로 실행됩니다. 런타임, 환경 변수, 시크릿, 네트워크 접근은 SKILL.md 참조에서 다룹니다.
스킬 위치
봇은 여러 곳에서 스킬을 모읍니다. 두 소스가 같은 이름의 스킬을 제공하면 이 목록에서 뒤에 있는 소스가 우선합니다.
| 소스 | 위치 | 사용할 수 있는 대상 |
|---|---|---|
| 기본 제공 | Nebo에 컴파일되어 포함됨 | 모든 직원 |
| 마켓플레이스 | <data>/nebo/skills/<slug>/<version>/ | 모든 직원 |
| 플러그인 | 설치된 플러그인의 skills/ 폴더 | 모든 직원 |
| 사용자 | <data>/user/skills/<name>/ | 모든 직원 |
| 직원 패키지 | 설치된 직원 패키지 안의 skills/ | 해당 직원만 |
| 학습한 스킬 | <data>/learned/skills/<employee>/<name>/ | 해당 직원만 |
<data>는 macOS에서는 ~/Library/Application Support/Nebo, Windows에서는 %APPDATA%\Nebo, Linux에서는 ~/.local/share/nebo입니다. NEBO_HOME 환경 변수로 바꿀 수 있습니다. 직원에게 자기 스킬과 같은 이름의 공유 스킬이 있으면 자기 스킬이 우선합니다.
Nebo는 이 폴더들을 지켜보다가 스킬이 바뀌면 1초 뒤에 다시 불러옵니다. 스킬을 삭제하지 않고 끄려면 파일 이름을 SKILL.md.disabled로 바꾸세요.
스킬은 도구가 아니라 업무를 설명합니다. 영수증 대조처럼 하나의 책임을 중심으로 스킬을 작성하고, 직원이 소유자가 제공한 연결을 무엇이든 사용하도록 두세요. 스킬에 정말로 플러그인이 필요할 때는 plugins 필드로 선언하세요.
다음 단계
- SKILL.md 참조: 모든 필드, 도구, 변수.
- 예시: 그대로 복사할 수 있는 완성된 스킬.
- 게시: 마켓플레이스에 스킬 올리기.