파일 형식
SKILL.md는 UTF-8 텍스트입니다. 하이픈 세 개로 된 줄로 시작하고, 이어서 YAML 프런트매터가 오며, 하이픈 세 개로 된 줄로 닫습니다. 그 뒤의 모든 내용은 본문으로, 직원이 스킬을 불러올 때 받는 Markdown 지침입니다. Nebo는 대소문자를 구분하지 않고 이름으로 파일을 찾습니다.
---
name: expense-review
description: Check submitted expenses against the company policy and flag anything that needs a receipt or an approval. Use when someone asks to review expenses or a reimbursement request.
version: "1.2.0"
author: Example Co
license: MIT
tags: [finance, expenses]
triggers: [reimbursement, expense report]
platform: [macos, linux, windows]
capabilities: [network]
metadata:
allowed_domains: [api.example.com]
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true
requires:
- name: receipt-capture
version: ">=1.0.0"
plugins:
- name: example-ledger
version: ">=2.0.0"
optional: true
---
# Expense review
Follow the policy in references/policy.md ... 프런트매터 필드
name과 description만 필수입니다. 타입이 잘못된 필드가 하나라도 있으면 파일 전체가 실패해 스킬이 불러와지지 않습니다. 여기에 나열되지 않은 키는 무시됩니다.
| 필드 | 타입 | 기본값 | 의미 |
|---|---|---|---|
name | string | 필수 | 식별자입니다. [a-z0-9-]만 사용하며, 하이픈으로 시작하거나 끝나거나 연속으로 쓸 수 없고, 최대 64바이트입니다. 폴더 이름과 같게 하세요. |
description | string | 필수 | 스킬이 무엇을 하고 언제 써야 하는지입니다. 최대 1,024바이트입니다. 직원의 스킬 목록에 표시되고 find_skills의 점수 계산에 쓰입니다. |
version | string | "1.0.0" | 시맨틱 버전입니다. 다른 스킬의 requires 범위와 대조됩니다. 따옴표로 감싸세요. |
triggers | 문자열 목록 | [] | 스킬이 적용되는 상황을 설명하는 단어와 문구입니다. 스킬 목록에는 최대 세 개가 표시되며, find_skills에서는 모두 반영됩니다. 트리거만으로 스킬이 불러와지는 일은 없습니다. |
platform | 문자열 목록 | 전체 | macos, linux, windows입니다. 일치하는 곳에서만 스킬이 불러와집니다. |
capabilities | 문자열 목록 | [] | network와 storage는 스크립트 샌드박스를 넓힙니다. 스크립트 샌드박스를 참고하세요. |
metadata | map | {} | secrets와 allowed_domains를 담습니다. 아래를 참고하세요. |
requires | {name, version} 목록 | [] | 이 스킬의 기반이 되는 다른 스킬입니다. name은 짧은 스킬 이름이고, version은 semver 범위이며 기본값은 "*"입니다. |
plugins | {name, version, optional} 목록 | [] | 이 스킬이 사용하는 플러그인입니다. version의 기본값은 "*", optional의 기본값은 false입니다. |
dependencies | 문자열 목록 | [] | 반드시 있어야 하는 스킬의 짧은 이름입니다. |
priority | integer | 0 | 관리 목록에서 스킬의 순서를 정합니다. 직원이 어떤 스킬을 고르는지에는 영향을 주지 않습니다. |
author | string | "" | 표시용으로 저장됩니다. |
license | string | "" | 표시용으로 저장됩니다. |
compatibility | string | "" | 자유 형식 메모이며 최대 500바이트입니다. |
tags | 문자열 목록 | [] | 표시용으로 저장됩니다. |
allowed-tools | string | "" | 공백으로 구분된 문자열입니다. 저장되지만 강제되지는 않습니다. |
requires나 dependencies에 지정한 스킬이 없거나 범위를 벗어나거나, 필수 플러그인이 설치되어 있지 않으면, 스킬은 불러와지되 기능 저하 상태로 표시됩니다. 소유자는 무엇이 빠졌는지 볼 수 있습니다.
시크릿
스킬의 스크립트에 필요한 자격 증명은 metadata.secrets 아래에 선언하세요. 소유자가 값을 제공하면 Nebo가 해당 스킬용으로 암호화해 저장합니다.
metadata:
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true | 키 | 의미 |
|---|---|
key | 스크립트가 받는 환경 변수 이름입니다. 필수입니다. |
label | 소유자에게 표시되는 이름입니다. |
hint | 값을 얻는 곳입니다. |
required | true이면 값이 설정되기 전까지 execute가 스킬의 스크립트 실행을 거부합니다. 기본값은 false입니다. |
직원은 configure_skill로 값을 설정합니다. 본문에서 시크릿을 ${secret.KEY}로 참조할 수 있지만, 스크립트는 대신 환경 변수를 읽어야 합니다.
템플릿 변수
직원이 스킬을 불러올 때 Nebo가 본문에서 이 변수들을 바꿉니다. 다른 파일 안에서는 바뀌지 않으므로, 스크립트는 대신 환경 변수를 읽습니다.
| 변수 | 값 |
|---|---|
${NEBO_SKILL_DIR} | 스킬 폴더의 절대 경로입니다. |
${NEBO_DATA_DIR} | 이 스킬용 쓰기 가능 폴더인 <data>/appdata/skills/<name>입니다. 처음 사용할 때 만들어집니다. |
${NEBO_USER_NAME} | 소유자의 이름입니다. |
${NEBO_OS} | 운영 체제입니다. |
${NEBO_ARCH} | 프로세서 아키텍처입니다. |
${plugin.SLUG_BIN} | 선언된 플러그인의 바이너리 경로입니다. slug는 대문자로 바뀌고 하이픈은 밑줄로 바뀝니다. 예를 들어 example-ledger는 ${plugin.EXAMPLE_LEDGER_BIN}이 됩니다. |
${secret.KEY} | 선언된 시크릿의 값입니다. |
$ARGUMENTS | use_skill에 전달된 args입니다. 본문에 $ARGUMENTS가 없으면 인수가 본문 뒤에 덧붙여집니다. |
스킬 도구
직원은 다음 도구로 스킬을 다룹니다. use_skill은 항상 사용할 수 있고, 나머지는 직원에게 필요할 때 불러와집니다.
| 도구 | 매개변수 | 기능 |
|---|---|---|
use_skill | name, args | 스킬을 불러옵니다. 확장된 본문, 폴더 경로, 처음 20개의 파일 이름을 돌려줍니다. 비활성화된 스킬을 다시 활성화합니다. |
find_skills | query | 이름, 트리거, 설명 일치도에 따라 순위를 매긴 스킬을 최대 10개 돌려줍니다. |
read_skill_file | name, path | 스킬 폴더의 파일을 읽습니다. path가 없으면 파일과 크기를 나열합니다. |
save_skill | name, content | 완성된 SKILL.md를 사용자 스킬 폴더에 씁니다. 마켓플레이스 스킬은 덮어쓸 수 없습니다. |
delete_skill | name | 사용자 스킬을 삭제합니다. |
install_skill | code | SKIL- 설치 코드로 마켓플레이스 스킬을 설치합니다. |
configure_skill | name, key, value | 시크릿을 설정합니다. key가 없으면 스킬에 필요한 것을 보여줍니다. |
rate_skill | name, rating, review | 마켓플레이스 스킬에 1점에서 5점까지 평점을 매깁니다. |
read_skill_reviews | name | 마켓플레이스 스킬의 리뷰를 읽습니다. |
execute | skill, script, args, timeout | 스킬 폴더의 스크립트를 실행합니다. 스크립트 샌드박스를 참고하세요. |
스크립트 샌드박스
execute 도구는 스킬 폴더의 스크립트 하나를 실행합니다. 런타임은 파일을 보고 고릅니다.
| 스크립트 | 런타임 |
|---|---|
.py | Python이며, Nebo에 포함된 uv가 있으면 이를 통해 실행하고, 없으면 python3을 사용합니다. |
.ts, .js | Nebo에 포함된 Bun이 있으면 사용하고, 없으면 node를 사용합니다. |
bin/<file> 또는 binary | 직접 실행합니다. |
.sh | 지원하지 않습니다. |
각 실행은 빈 환경과 다음 변수로 시작합니다.
| 변수 | 값 |
|---|---|
SKILL_ARGS | JSON 형식의 args 객체입니다. |
각 시크릿의 key | 복호화된 시크릿 값입니다. |
<PLUGIN>_BIN | 선언된 각 플러그인의 바이너리 경로입니다. 플러그인 폴더는 PATH에도 추가됩니다. |
import json, os
args = json.loads(os.environ.get("SKILL_ARGS", "{}"))
api_key = os.environ["EXAMPLE_API_KEY"]
print(json.dumps({"checked": len(args.get("items", []))})) 스크립트는 스킬 폴더의 임시 사본에서 실행되며, 기본 시간 제한은 30초입니다. macOS와 Linux에서는 운영 체제 샌드박스 안에서 실행됩니다.
- 자격 증명 저장소, 브라우저와 키체인 데이터, Nebo 자체의 설정과 데이터베이스를 읽을 수 없습니다.
- 작업 폴더와
/tmp/nebo에만 쓸 수 있습니다.storage기능을 선언하면 Nebo의 데이터 폴더가 추가됩니다. - 네트워크에 접근할 수 없습니다.
network기능을 선언하면 패키지 레지스트리와metadata.allowed_domains에 나열된 도메인에 접근할 수 있습니다.
파일과 제한
| 항목 | 규칙 |
|---|---|
| 리소스 | SKILL.md, manifest.json, signatures.json, 점 파일을 제외한 모든 파일입니다. |
| 실행 파일 | scripts/ 또는 bin/ 아래의 파일과, 루트에 있는 binary라는 이름의 파일입니다. |
| 경로 | 스킬 폴더 기준의 상대 경로입니다. ..가 들어 있거나 폴더를 벗어나는 경로는 거부됩니다. |
| 비활성화된 스킬 | SKILL.md 대신 SKILL.md.disabled가 있는 폴더입니다. |
| 스킬 목록 | 각 항목은 250자에서 잘립니다. 전체 목록이 8,000자를 넘으면 공유 스킬부터 줄어들며, 직원 자신의 스킬은 항목 전체가 유지됩니다. |
마켓플레이스에 게시하는 파일의 제한은 게시 페이지에 있습니다.