Format file
SKILL.md adalah teks UTF-8. Diawali satu baris berisi tiga tanda hubung, lalu frontmatter YAML, lalu baris penutup berisi tiga tanda hubung. Semua setelahnya adalah isi: instruksi Markdown yang diterima karyawan saat memuat skill. Nebo menemukan file berdasarkan nama tanpa memedulikan huruf besar atau kecil.
---
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 ... Kolom frontmatter
Hanya name dan description yang wajib. Kolom dengan tipe yang salah menggagalkan seluruh file, sehingga skill tidak dimuat. Kunci yang tidak tercantum di sini diabaikan.
| Kolom | Tipe | Bawaan | Arti |
|---|---|---|---|
name | string | wajib | Pengenal. [a-z0-9-], tanpa tanda hubung di awal, di akhir, atau ganda, paling banyak 64 byte. Samakan dengan nama folder. |
description | string | wajib | Apa fungsi skill dan kapan menggunakannya. Paling banyak 1.024 byte. Ditampilkan di daftar skill karyawan dan dinilai oleh find_skills. |
version | string | "1.0.0" | Versi semantik. Diperiksa oleh rentang requires milik skill lain. Beri tanda kutip. |
triggers | daftar string | [] | Kata dan frasa yang menggambarkan kapan skill berlaku. Hingga tiga muncul di daftar skill; semuanya dihitung di find_skills. Pemicu tidak pernah memuat skill dengan sendirinya. |
platform | daftar string | semua | macos, linux, windows. Skill hanya dimuat jika salah satunya cocok. |
capabilities | daftar string | [] | network dan storage memperluas sandbox skrip. Lihat Sandbox skrip. |
metadata | map | {} | Memuat secrets dan allowed_domains. Lihat di bawah. |
requires | daftar {name, version} | [] | Skill lain yang menjadi dasar skill ini. name adalah nama pendek skill; version adalah rentang semver, bawaan "*". |
plugins | daftar {name, version, optional} | [] | Plugin yang digunakan skill ini. version bawaannya "*", optional bawaannya false. |
dependencies | daftar string | [] | Nama pendek skill yang harus ada. |
priority | integer | 0 | Mengurutkan skill di daftar pengelolaan. Tidak memengaruhi skill mana yang dipilih karyawan. |
author | string | "" | Disimpan untuk ditampilkan. |
license | string | "" | Disimpan untuk ditampilkan. |
compatibility | string | "" | Catatan teks bebas, paling banyak 500 byte. |
tags | daftar string | [] | Disimpan untuk ditampilkan. |
allowed-tools | string | "" | String yang dipisahkan spasi. Disimpan; tidak diberlakukan. |
Jika skill yang disebut di requires atau dependencies tidak ada atau di luar rentang, atau plugin yang wajib belum terinstal, skill tetap dimuat dan ditandai terdegradasi. Pemilik melihat apa yang kurang.
Rahasia
Nyatakan kredensial yang dibutuhkan skrip skill di bawah metadata.secrets. Pemilik memberikan nilainya, dan Nebo menyimpannya dalam bentuk terenkripsi untuk skill tersebut.
metadata:
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true | Kunci | Arti |
|---|---|
key | Nama variabel lingkungan yang diterima skrip. Wajib. |
label | Nama yang ditampilkan kepada pemilik. |
hint | Tempat mendapatkan nilainya. |
required | Jika true, execute menolak menjalankan skrip skill sampai nilainya diatur. Bawaan false. |
Karyawan menetapkan nilai dengan configure_skill. Anda dapat merujuk rahasia di isi file sebagai ${secret.KEY}, meskipun skrip sebaiknya membaca variabel lingkungannya.
Variabel templat
Nebo mengganti variabel-variabel ini di isi skill saat karyawan memuatnya. Variabel tidak diganti di dalam file lain; skrip membaca variabel lingkungan sebagai gantinya.
| Variabel | Nilai |
|---|---|
${NEBO_SKILL_DIR} | Path absolut folder skill. |
${NEBO_DATA_DIR} | Folder yang dapat ditulisi untuk skill ini: <data>/appdata/skills/<name>. Dibuat saat pertama kali digunakan. |
${NEBO_USER_NAME} | Nama pemilik. |
${NEBO_OS} | Sistem operasi. |
${NEBO_ARCH} | Arsitektur prosesor. |
${plugin.SLUG_BIN} | Path biner plugin yang dinyatakan. Slug ditulis dalam huruf besar, dengan tanda hubung diganti garis bawah: example-ledger menjadi ${plugin.EXAMPLE_LEDGER_BIN}. |
${secret.KEY} | Nilai rahasia yang dinyatakan. |
$ARGUMENTS | args yang diteruskan ke use_skill. Jika isi tidak memiliki $ARGUMENTS, argumen ditambahkan setelahnya. |
Alat skill
Karyawan bekerja dengan skill melalui alat-alat ini. use_skill selalu tersedia; yang lainnya dimuat saat karyawan membutuhkannya.
| Alat | Parameter | Fungsinya |
|---|---|---|
use_skill | name, args | Memuat skill. Mengembalikan isi yang sudah diperluas, path folder, dan 20 nama file pertama. Mengaktifkan kembali skill yang dinonaktifkan. |
find_skills | query | Mengembalikan hingga 10 skill yang diurutkan berdasarkan kecocokan nama, pemicu, dan deskripsi. |
read_skill_file | name, path | Membaca file di folder skill. Tanpa path, mencantumkan file beserta ukurannya. |
save_skill | name, content | Menulis SKILL.md lengkap ke folder skill pengguna. Skill marketplace tidak dapat ditimpa. |
delete_skill | name | Menghapus skill pengguna. |
install_skill | code | Menginstal skill marketplace dari kode instalasi SKIL--nya. |
configure_skill | name, key, value | Mengatur rahasia. Tanpa key, menampilkan apa yang dibutuhkan skill. |
rate_skill | name, rating, review | Memberi nilai skill marketplace dari 1 sampai 5. |
read_skill_reviews | name | Membaca ulasan skill marketplace. |
execute | skill, script, args, timeout | Menjalankan skrip dari folder skill. Lihat Sandbox skrip. |
Sandbox skrip
Alat execute menjalankan satu skrip dari folder skill. Alat ini memilih runtime berdasarkan file-nya.
| Skrip | Runtime |
|---|---|
.py | Python, melalui uv bawaan Nebo jika ada, jika tidak python3. |
.ts, .js | Bun bawaan Nebo jika ada, jika tidak node. |
bin/<file> atau binary | Dijalankan langsung. |
.sh | Tidak didukung. |
Setiap eksekusi dimulai dengan lingkungan kosong dan variabel-variabel ini:
| Variabel | Nilai |
|---|---|
SKILL_ARGS | Objek args sebagai JSON. |
Setiap key rahasia | Nilai rahasia yang sudah didekripsi. |
<PLUGIN>_BIN | Path biner setiap plugin yang dinyatakan. Folder plugin juga ditambahkan ke 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", []))})) Skrip berjalan di salinan sementara folder skill, dengan waktu tunggu bawaan 30 detik. Di macOS dan Linux, skrip berjalan di sandbox sistem operasi:
- Skrip tidak dapat membaca penyimpanan kredensial, data browser dan keychain, atau pengaturan dan database milik Nebo.
- Skrip hanya dapat menulis ke folder kerjanya dan
/tmp/nebo. Kemampuanstoragemenambahkan folder data Nebo. - Skrip tidak memiliki akses jaringan. Kemampuan
networkmengizinkan registri paket dan domain yang tercantum dimetadata.allowed_domains.
File dan batasan
| Item | Aturan |
|---|---|
| Sumber daya | Setiap file kecuali SKILL.md, manifest.json, signatures.json, dan dotfile. |
| Executable | File di bawah scripts/ atau bin/, dan file root bernama binary. |
| Path | Relatif terhadap folder skill. Path dengan .. atau yang keluar dari folder ditolak. |
| Skill nonaktif | Folder dengan SKILL.md.disabled alih-alih SKILL.md. |
| Daftar skill | Setiap entri dipotong pada 250 karakter. Jika seluruh daftar melebihi 8.000 karakter, skill bersama dipersingkat lebih dulu; skill milik karyawan sendiri tetap utuh. |
Batasan untuk file yang Anda terbitkan ke marketplace ada di halaman Penerbitan.