NeboAI
NeboAI
Mulai

Referensi SKILL.md

Halaman ini mencantumkan setiap bagian skill yang dibaca Nebo: kolom frontmatter, variabel yang diperluasnya, alat yang digunakan karyawan untuk bekerja dengan skill, dan lingkungan tempat skrip berjalan.

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.

KolomTipeBawaanArti
namestringwajibPengenal. [a-z0-9-], tanpa tanda hubung di awal, di akhir, atau ganda, paling banyak 64 byte. Samakan dengan nama folder.
descriptionstringwajibApa fungsi skill dan kapan menggunakannya. Paling banyak 1.024 byte. Ditampilkan di daftar skill karyawan dan dinilai oleh find_skills.
versionstring"1.0.0"Versi semantik. Diperiksa oleh rentang requires milik skill lain. Beri tanda kutip.
triggersdaftar 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.
platformdaftar stringsemuamacos, linux, windows. Skill hanya dimuat jika salah satunya cocok.
capabilitiesdaftar string[]network dan storage memperluas sandbox skrip. Lihat Sandbox skrip.
metadatamap{}Memuat secrets dan allowed_domains. Lihat di bawah.
requiresdaftar {name, version}[]Skill lain yang menjadi dasar skill ini. name adalah nama pendek skill; version adalah rentang semver, bawaan "*".
pluginsdaftar {name, version, optional}[]Plugin yang digunakan skill ini. version bawaannya "*", optional bawaannya false.
dependenciesdaftar string[]Nama pendek skill yang harus ada.
priorityinteger0Mengurutkan skill di daftar pengelolaan. Tidak memengaruhi skill mana yang dipilih karyawan.
authorstring""Disimpan untuk ditampilkan.
licensestring""Disimpan untuk ditampilkan.
compatibilitystring""Catatan teks bebas, paling banyak 500 byte.
tagsdaftar string[]Disimpan untuk ditampilkan.
allowed-toolsstring""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
KunciArti
keyNama variabel lingkungan yang diterima skrip. Wajib.
labelNama yang ditampilkan kepada pemilik.
hintTempat mendapatkan nilainya.
requiredJika 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.

VariabelNilai
${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.
$ARGUMENTSargs 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.

AlatParameterFungsinya
use_skillname, argsMemuat skill. Mengembalikan isi yang sudah diperluas, path folder, dan 20 nama file pertama. Mengaktifkan kembali skill yang dinonaktifkan.
find_skillsqueryMengembalikan hingga 10 skill yang diurutkan berdasarkan kecocokan nama, pemicu, dan deskripsi.
read_skill_filename, pathMembaca file di folder skill. Tanpa path, mencantumkan file beserta ukurannya.
save_skillname, contentMenulis SKILL.md lengkap ke folder skill pengguna. Skill marketplace tidak dapat ditimpa.
delete_skillnameMenghapus skill pengguna.
install_skillcodeMenginstal skill marketplace dari kode instalasi SKIL--nya.
configure_skillname, key, valueMengatur rahasia. Tanpa key, menampilkan apa yang dibutuhkan skill.
rate_skillname, rating, reviewMemberi nilai skill marketplace dari 1 sampai 5.
read_skill_reviewsnameMembaca ulasan skill marketplace.
executeskill, script, args, timeoutMenjalankan skrip dari folder skill. Lihat Sandbox skrip.

Sandbox skrip

Alat execute menjalankan satu skrip dari folder skill. Alat ini memilih runtime berdasarkan file-nya.

SkripRuntime
.pyPython, melalui uv bawaan Nebo jika ada, jika tidak python3.
.ts, .jsBun bawaan Nebo jika ada, jika tidak node.
bin/<file> atau binaryDijalankan langsung.
.shTidak didukung.

Setiap eksekusi dimulai dengan lingkungan kosong dan variabel-variabel ini:

VariabelNilai
SKILL_ARGSObjek args sebagai JSON.
Setiap key rahasiaNilai rahasia yang sudah didekripsi.
<PLUGIN>_BINPath 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. Kemampuan storage menambahkan folder data Nebo.
  • Skrip tidak memiliki akses jaringan. Kemampuan network mengizinkan registri paket dan domain yang tercantum di metadata.allowed_domains.

File dan batasan

ItemAturan
Sumber dayaSetiap file kecuali SKILL.md, manifest.json, signatures.json, dan dotfile.
ExecutableFile di bawah scripts/ atau bin/, dan file root bernama binary.
PathRelatif terhadap folder skill. Path dengan .. atau yang keluar dari folder ditolak.
Skill nonaktifFolder dengan SKILL.md.disabled alih-alih SKILL.md.
Daftar skillSetiap 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.