NeboAI
NeboAI
시작하기

SKILL.md 레퍼런스

이 페이지에서는 Nebo가 읽는 스킬의 모든 부분을 안내합니다. 프런트매터 필드, Nebo가 확장하는 변수, 직원이 스킬을 다룰 때 쓰는 도구, 스크립트가 실행되는 환경을 다룹니다.

파일 형식

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만 필수입니다. 타입이 잘못된 필드가 하나라도 있으면 파일 전체가 실패해 스킬이 불러와지지 않습니다. 여기에 나열되지 않은 키는 무시됩니다.

필드타입기본값의미
namestring필수식별자입니다. [a-z0-9-]만 사용하며, 하이픈으로 시작하거나 끝나거나 연속으로 쓸 수 없고, 최대 64바이트입니다. 폴더 이름과 같게 하세요.
descriptionstring필수스킬이 무엇을 하고 언제 써야 하는지입니다. 최대 1,024바이트입니다. 직원의 스킬 목록에 표시되고 find_skills의 점수 계산에 쓰입니다.
versionstring"1.0.0"시맨틱 버전입니다. 다른 스킬의 requires 범위와 대조됩니다. 따옴표로 감싸세요.
triggers문자열 목록[]스킬이 적용되는 상황을 설명하는 단어와 문구입니다. 스킬 목록에는 최대 세 개가 표시되며, find_skills에서는 모두 반영됩니다. 트리거만으로 스킬이 불러와지는 일은 없습니다.
platform문자열 목록전체macos, linux, windows입니다. 일치하는 곳에서만 스킬이 불러와집니다.
capabilities문자열 목록[]network와 storage는 스크립트 샌드박스를 넓힙니다. 스크립트 샌드박스를 참고하세요.
metadatamap{}secrets와 allowed_domains를 담습니다. 아래를 참고하세요.
requires{name, version} 목록[]이 스킬의 기반이 되는 다른 스킬입니다. name은 짧은 스킬 이름이고, version은 semver 범위이며 기본값은 "*"입니다.
plugins{name, version, optional} 목록[]이 스킬이 사용하는 플러그인입니다. version의 기본값은 "*", optional의 기본값은 false입니다.
dependencies문자열 목록[]반드시 있어야 하는 스킬의 짧은 이름입니다.
priorityinteger0관리 목록에서 스킬의 순서를 정합니다. 직원이 어떤 스킬을 고르는지에는 영향을 주지 않습니다.
authorstring""표시용으로 저장됩니다.
licensestring""표시용으로 저장됩니다.
compatibilitystring""자유 형식 메모이며 최대 500바이트입니다.
tags문자열 목록[]표시용으로 저장됩니다.
allowed-toolsstring""공백으로 구분된 문자열입니다. 저장되지만 강제되지는 않습니다.

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값을 얻는 곳입니다.
requiredtrue이면 값이 설정되기 전까지 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}선언된 시크릿의 값입니다.
$ARGUMENTSuse_skill에 전달된 args입니다. 본문에 $ARGUMENTS가 없으면 인수가 본문 뒤에 덧붙여집니다.

스킬 도구

직원은 다음 도구로 스킬을 다룹니다. use_skill은 항상 사용할 수 있고, 나머지는 직원에게 필요할 때 불러와집니다.

도구매개변수기능
use_skillname, args스킬을 불러옵니다. 확장된 본문, 폴더 경로, 처음 20개의 파일 이름을 돌려줍니다. 비활성화된 스킬을 다시 활성화합니다.
find_skillsquery이름, 트리거, 설명 일치도에 따라 순위를 매긴 스킬을 최대 10개 돌려줍니다.
read_skill_filename, path스킬 폴더의 파일을 읽습니다. path가 없으면 파일과 크기를 나열합니다.
save_skillname, content완성된 SKILL.md를 사용자 스킬 폴더에 씁니다. 마켓플레이스 스킬은 덮어쓸 수 없습니다.
delete_skillname사용자 스킬을 삭제합니다.
install_skillcodeSKIL- 설치 코드로 마켓플레이스 스킬을 설치합니다.
configure_skillname, key, value시크릿을 설정합니다. key가 없으면 스킬에 필요한 것을 보여줍니다.
rate_skillname, rating, review마켓플레이스 스킬에 1점에서 5점까지 평점을 매깁니다.
read_skill_reviewsname마켓플레이스 스킬의 리뷰를 읽습니다.
executeskill, script, args, timeout스킬 폴더의 스크립트를 실행합니다. 스크립트 샌드박스를 참고하세요.

스크립트 샌드박스

execute 도구는 스킬 폴더의 스크립트 하나를 실행합니다. 런타임은 파일을 보고 고릅니다.

스크립트런타임
.pyPython이며, Nebo에 포함된 uv가 있으면 이를 통해 실행하고, 없으면 python3을 사용합니다.
.ts, .jsNebo에 포함된 Bun이 있으면 사용하고, 없으면 node를 사용합니다.
bin/<file> 또는 binary직접 실행합니다.
.sh지원하지 않습니다.

각 실행은 빈 환경과 다음 변수로 시작합니다.

변수값
SKILL_ARGSJSON 형식의 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자를 넘으면 공유 스킬부터 줄어들며, 직원 자신의 스킬은 항목 전체가 유지됩니다.

마켓플레이스에 게시하는 파일의 제한은 게시 페이지에 있습니다.