NeboAI
NeboAI
Qallariy

SKILL.md Referencia

Kay paginaqa Nebo ñawinchasqan atiypa llapan partenkunatam listan: frontmatter campokuna, mast'arisqan variablekuna, llamk'aqkuna atiykunawan llamk'anankupaq llamk'anakuna, scriptkuna purisqan entornopas.

Archivo formato

SKILL.md-qa UTF-8 qillqam. Kimsa guionniyuq siqiwan qallarin, chaymanta YAML frontmatter, chaymanta kimsa guionniyuq wichqaq siqi. Chaymanta qhipan llapanmi ukhun: llamk'aq atiyta cargaspa chaskisqan Markdown kamachiykuna. Nebo archivota sutinwanmi tarin, hatun uchuy letrakunata mana qhawaspa.

---
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 ...

Frontmatter campokuna

name hinaspa description-llam mañakunku. Mana allin tipoyuq campoqa llapan archivotam p'akin, chayrayku atiyqa manam cargakunchu. Kaypi mana listasqa llavekunaqa mana qhawasqam.

CampoTipoÑawpaqmantaNinan
namestringmañakunRiqsichiq. [a-z0-9-], mana qallariypi, tukukuypi utaq iskay guionniyuq, aswanqa 64 byte. Carpetapa sutinwan tupachiy.
descriptionstringmañakunAtiy ima ruwasqan hinaspa hayk'aq llamk'achinapaq. Aswanqa 1,024 byte. Llamk'aqpa atiy listanpi rikuchisqa, find_skills-wantaq puntuasqa.
versionstring"1.0.0"Semántica versión. Huk atiykunapa requires rangonkunawan qhawakun. Comillaswan churay.
triggersstring lista[]Atiy hayk'aq yanapasqanta willaq simikuna rimaykunapas. Kimsakamam atiy listapi rikurinku; llapanmi find_skills-pi yupakunku. Manam hayk'aqpas kikillanku atiyta cargankuchu.
platformstring listallapanmacos, linux, windows. Atiyqa hukninwan tupaqpillam cargakun.
capabilitiesstring lista[]network hinaspa storage script sandboxta kicharinku. Script sandbox nisqata qhaway.
metadatamap{}secrets hinaspa allowed_domains hap'in. Uraypi qhaway.
requires{name, version} lista[]Kay atiy hawanpi sayasqan huk atiykuna. name atiypa pisi sutinmi; version semver rangom, ñawpaqmanta "*".
plugins{name, version, optional} lista[]Kay atiy llamk'achisqan pluginkuna. version mana churasqa kaptin "*", optional false.
dependenciesstring lista[]Kananpuni kaq atiykunapa pisi sutinkuna.
priorityinteger0Kamachina listakunapi atiykunata ordenan. Manam llamk'aq mayqin atiyta akllasqanta tikranchu.
authorstring""Rikuchinapaq waqaychasqa.
licensestring""Rikuchinapaq waqaychasqa.
compatibilitystring""Kikiyki qillqasqa willakuy, aswanqa 500 byte.
tagsstring lista[]Rikuchinapaq waqaychasqa.
allowed-toolsstring""Espaciowan rakisqa string. Waqaychasqa; manam kamachikunchu.

requires utaq dependencies-pi sutichasqa atiy mana kaptin utaq rangomanta hawapi kaptin, utaq mañakusqa plugin mana instalasqa kaptin, atiyqa cargakullanmi degradasqa hina marcasqa. Dueñom ima pisisqanta rikun.

Pakasqakuna

Atiypa scriptninkuna necesitasqan credencialkunata metadata.secrets ukhupi willay. Dueñom valorkunata qun, Nebotaq chay atiypaq cifrasqata waqaychan.

metadata:
  secrets:
    - key: EXAMPLE_API_KEY
      label: Example API key
      hint: Create one at https://example.com/settings/keys
      required: true
LlaveNinan
keyScript chaskisqan entorno variablepa sutin. Mañakun.
labelDueñoman rikuchisqa suti.
hintMaymanta valorta hurqunapaq.
requiredtrue kaptinqa, valor churasqa kanankama execute manam atiypa scriptninkunata purichiyta munanchu. Ñawpaqmanta false.

Huk llamk'aqqa configure_skill nisqawanmi huk valorta churan. Cuerpopiqa huk secretotam ${secret.KEY} hina referenciayta atinki, ichaqa scriptkunaqa entorno variabletam aswan ñawirinanku.

Plantilla variablekuna

Huk llamk'aq atiyta cargaptin, Nebo ukhunpi kay variablekunata tikran. Manam huk archivokuna ukhupi tikrakunkuchu; scriptkunaqa entorno variablekunatam ñawinchanku.

VariableValor
${NEBO_SKILL_DIR}Atiypa carpetanpa absoluto ñannin.
${NEBO_DATA_DIR}Kay atiypaq qillqanalla carpeta: <data>/appdata/skills/<name>. Ñawpaq kuti llamk'achispa ruwakun.
${NEBO_USER_NAME}Dueñopa sutin.
${NEBO_OS}Sistema operativo.
${NEBO_ARCH}Procesorpa arquitecturan.
${plugin.SLUG_BIN}Willasqa pluginpa binarionpa ñannin. Slugqa hatun letrakunapim, guionkunataq subrayado hina: example-ledger ${plugin.EXAMPLE_LEDGER_BIN} tukun.
${secret.KEY}Willasqa pakasqapa valornin.
$ARGUMENTSuse_skill-man pasachisqa args. Ukhun mana $ARGUMENTS-niyuq kaptinqa, argumentokunaqa qhipanman yapakunku.

Atiy llamk'anakuna

Llamk'aqkunaqa kay llamk'anakunawanmi atiykunawan llamk'anku. use_skill-qa sapa kutim kan; wakinkunaqa llamk'aq necesitaptinmi cargakunku.

Llamk'anaParámetrokunaIma ruwasqan
use_skillname, argsHuk atiyta cargan. Mast'arisqa ukhunta, carpeta ñanta, ñawpaq 20 archivo sutikunatapas kutichin. Wañusqa atiyta yapamanta hap'ichin.
find_skillsquerySutiwan, qallarichiqwan, willakuywan tupasqankama 10kama atiykunata ordenasqata kutichin.
read_skill_filename, pathAtiypa carpetanpi huk archivota ñawinchan. Mana path-niyuq kaptinqa, archivokunata sayayninkunatawan listan.
save_skillname, contentHunt'asqa SKILL.mdta usuario atiy carpetaman qillqan. Mercado atiykunaqa manam hawanpi qillqakuyta atinkuchu.
delete_skillnameUsuario atiyta chinkachin.
install_skillcodeMercado atiyta SKIL- instalana códigonwan instalan.
configure_skillname, key, valueHuk pakasqata churan. Mana key-niyuq kaptinqa, atiy ima necesitasqanta rikuchin.
rate_skillname, rating, reviewMercado atiyta 1manta 5kama puntúan.
read_skill_reviewsnameMercado atiypa reseñankunata ñawinchan.
executeskill, script, args, timeoutAtiypa carpetanmanta huk scriptta purichin. Script sandbox nisqata qhaway.

Script sandbox

execute llamk'anaqa atiypa carpetanmanta huk scriptllatam purichin. Archivomantam runtimeta akllan.

ScriptRuntime
.pyPython, kaptinqa Nebopa p'istusqa uvninwan, mana chayqa python3.
.ts, .jsKaptinqa Nebopa p'istusqa Bunnin, mana chayqa node.
bin/<file> utaq binaryChiqaplla purichiy.
.shMana yanapasqachu.

Sapa purichiymi ch'usaq entornowan kay variablekunawan qallarin:

VariableValor
SKILL_ARGSargs objeto JSON hina.
Sapa pakasqa keyDescifrasqa pakasqa valor.
<PLUGIN>_BINSapa willasqa pluginpa binarionpa ñannin. Plugin carpetakunapas PATH-manmi yapakunku.
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", []))}))

Scriptqa atiy carpetapa pachallapaq copianpim purin, ñawpaqmanta 30 segundo timeoutwan. macOSpi Linuxpipas sistema operativopa sandboxninpim purin:

  • Manam credencial waqaychanakunata, navegador keychain willakuykunata, nitaq Nebopa kikin ajustenkunata base de datontapas ñawinchayta atinchu.
  • Llamk'ana carpetanmanlla /tmp/nebo-manllam qillqayta atin. storage kallpam Nebopa willakuy carpetanta yapan.
  • Manam red yaykuyniyuqchu. network kallpam paquete registrokunata metadata.allowed_domains-pi listasqa dominiokunatapas saqin.

Archivokuna hinaspa limitekuna

ImaKamachiy
RecursokunaSKILL.md, manifest.json, signatures.json hinaspa puntowan qallariq archivokunamanta hawa sapa archivo.
Purichikuqkunascripts/ utaq bin/ ukhupi archivokuna, binary sutiyuq saphi archivopas.
ÑankunaAtiy carpetamanta qhawasqa. ..-niyuq utaq carpetamanta lluqsiq ñankunaqa mana chaskisqam.
Wañusqa atiySKILL.md rantinpi SKILL.md.disabled-niyuq carpeta.
Atiy listaSapa entradam 250 caracterpi kuchukun. Llapan lista 8,000 caracterta yallipuptinqa, rakinakusqa atiykunam ñawpaqta pisiyachikunku; llamk'aqpa kikin atiyninkunaqa hunt'asqa entradankunatam waqaychanku.

Mercadoman publicasqayki archivokunapaq limitekunaqa Publicay paginapim kanku.