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.
| Campo | Tipo | Ñawpaqmanta | Ninan |
|---|---|---|---|
name | string | mañakun | Riqsichiq. [a-z0-9-], mana qallariypi, tukukuypi utaq iskay guionniyuq, aswanqa 64 byte. Carpetapa sutinwan tupachiy. |
description | string | mañakun | Atiy ima ruwasqan hinaspa hayk'aq llamk'achinapaq. Aswanqa 1,024 byte. Llamk'aqpa atiy listanpi rikuchisqa, find_skills-wantaq puntuasqa. |
version | string | "1.0.0" | Semántica versión. Huk atiykunapa requires rangonkunawan qhawakun. Comillaswan churay. |
triggers | string lista | [] | Atiy hayk'aq yanapasqanta willaq simikuna rimaykunapas. Kimsakamam atiy listapi rikurinku; llapanmi find_skills-pi yupakunku. Manam hayk'aqpas kikillanku atiyta cargankuchu. |
platform | string lista | llapan | macos, linux, windows. Atiyqa hukninwan tupaqpillam cargakun. |
capabilities | string lista | [] | network hinaspa storage script sandboxta kicharinku. Script sandbox nisqata qhaway. |
metadata | map | {} | 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. |
dependencies | string lista | [] | Kananpuni kaq atiykunapa pisi sutinkuna. |
priority | integer | 0 | Kamachina listakunapi atiykunata ordenan. Manam llamk'aq mayqin atiyta akllasqanta tikranchu. |
author | string | "" | Rikuchinapaq waqaychasqa. |
license | string | "" | Rikuchinapaq waqaychasqa. |
compatibility | string | "" | Kikiyki qillqasqa willakuy, aswanqa 500 byte. |
tags | string lista | [] | Rikuchinapaq waqaychasqa. |
allowed-tools | string | "" | 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 | Llave | Ninan |
|---|---|
key | Script chaskisqan entorno variablepa sutin. Mañakun. |
label | Dueñoman rikuchisqa suti. |
hint | Maymanta valorta hurqunapaq. |
required | true 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.
| Variable | Valor |
|---|---|
${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. |
$ARGUMENTS | use_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'ana | Parámetrokuna | Ima ruwasqan |
|---|---|---|
use_skill | name, args | Huk atiyta cargan. Mast'arisqa ukhunta, carpeta ñanta, ñawpaq 20 archivo sutikunatapas kutichin. Wañusqa atiyta yapamanta hap'ichin. |
find_skills | query | Sutiwan, qallarichiqwan, willakuywan tupasqankama 10kama atiykunata ordenasqata kutichin. |
read_skill_file | name, path | Atiypa carpetanpi huk archivota ñawinchan. Mana path-niyuq kaptinqa, archivokunata sayayninkunatawan listan. |
save_skill | name, content | Hunt'asqa SKILL.mdta usuario atiy carpetaman qillqan. Mercado atiykunaqa manam hawanpi qillqakuyta atinkuchu. |
delete_skill | name | Usuario atiyta chinkachin. |
install_skill | code | Mercado atiyta SKIL- instalana códigonwan instalan. |
configure_skill | name, key, value | Huk pakasqata churan. Mana key-niyuq kaptinqa, atiy ima necesitasqanta rikuchin. |
rate_skill | name, rating, review | Mercado atiyta 1manta 5kama puntúan. |
read_skill_reviews | name | Mercado atiypa reseñankunata ñawinchan. |
execute | skill, script, args, timeout | Atiypa carpetanmanta huk scriptta purichin. Script sandbox nisqata qhaway. |
Script sandbox
execute llamk'anaqa atiypa carpetanmanta huk scriptllatam purichin. Archivomantam runtimeta akllan.
| Script | Runtime |
|---|---|
.py | Python, kaptinqa Nebopa p'istusqa uvninwan, mana chayqa python3. |
.ts, .js | Kaptinqa Nebopa p'istusqa Bunnin, mana chayqa node. |
bin/<file> utaq binary | Chiqaplla purichiy. |
.sh | Mana yanapasqachu. |
Sapa purichiymi ch'usaq entornowan kay variablekunawan qallarin:
| Variable | Valor |
|---|---|
SKILL_ARGS | args objeto JSON hina. |
Sapa pakasqa key | Descifrasqa pakasqa valor. |
<PLUGIN>_BIN | Sapa 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.storagekallpam Nebopa willakuy carpetanta yapan. - Manam red yaykuyniyuqchu.
networkkallpam paquete registrokunatametadata.allowed_domains-pi listasqa dominiokunatapas saqin.
Archivokuna hinaspa limitekuna
| Ima | Kamachiy |
|---|---|
| Recursokuna | SKILL.md, manifest.json, signatures.json hinaspa puntowan qallariq archivokunamanta hawa sapa archivo. |
| Purichikuqkuna | scripts/ utaq bin/ ukhupi archivokuna, binary sutiyuq saphi archivopas. |
| Ñankuna | Atiy carpetamanta qhawasqa. ..-niyuq utaq carpetamanta lluqsiq ñankunaqa mana chaskisqam. |
| Wañusqa atiy | SKILL.md rantinpi SKILL.md.disabled-niyuq carpeta. |
| Atiy lista | Sapa 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.