ఫైల్ ఫార్మాట్
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 మాత్రమే తప్పనిసరి. తప్పు రకం ఉన్న ఫీల్డ్ వల్ల మొత్తం ఫైల్ విఫలమవుతుంది, కాబట్టి నైపుణ్యం లోడ్ అవ్వదు. ఇక్కడ జాబితా చేయని కీలు విస్మరించబడతాయి.
| ఫీల్డ్ | రకం | డిఫాల్ట్ | అర్థం |
|---|---|---|---|
name | string | తప్పనిసరి | ఐడెంటిఫైయర్. [a-z0-9-], ముందు, చివర లేదా వరుసగా రెండు హైఫన్లు ఉండకూడదు, గరిష్ఠంగా 64 బైట్లు. ఫోల్డర్ పేరుకు సరిపోలాలి. |
description | string | తప్పనిసరి | నైపుణ్యం ఏమి చేస్తుంది, ఎప్పుడు ఉపయోగించాలి. గరిష్ఠంగా 1,024 బైట్లు. ఉద్యోగి నైపుణ్యాల జాబితాలో చూపబడుతుంది, find_skills దీనికి స్కోర్ ఇస్తుంది. |
version | string | "1.0.0" | సెమాంటిక్ వెర్షన్. ఇతర నైపుణ్యాల requires పరిధుల ద్వారా తనిఖీ చేయబడుతుంది. దీన్ని కోట్స్లో పెట్టండి. |
triggers | స్ట్రింగ్ల జాబితా | [] | నైపుణ్యం ఎప్పుడు వర్తిస్తుందో వివరించే పదాలు మరియు పదబంధాలు. గరిష్ఠంగా మూడు నైపుణ్యాల జాబితాలో కనిపిస్తాయి; find_skillsలో అన్నీ లెక్కలోకి వస్తాయి. అవి ఎప్పుడూ స్వయంగా నైపుణ్యాన్ని లోడ్ చేయవు. |
platform | స్ట్రింగ్ల జాబితా | అన్నీ | macos, linux, windows. ఒకటి సరిపోలిన చోట మాత్రమే నైపుణ్యం లోడ్ అవుతుంది. |
capabilities | స్ట్రింగ్ల జాబితా | [] | network మరియు storage స్క్రిప్ట్ శాండ్బాక్స్ను విస్తరిస్తాయి. స్క్రిప్ట్ శాండ్బాక్స్ చూడండి. |
metadata | map | {} | secrets మరియు allowed_domainsను కలిగి ఉంటుంది. కింద చూడండి. |
requires | {name, version} జాబితా | [] | ఈ నైపుణ్యం ఆధారపడే ఇతర నైపుణ్యాలు. name చిన్న నైపుణ్యం పేరు; version ఒక semver పరిధి, డిఫాల్ట్ "*". |
plugins | {name, version, optional} జాబితా | [] | ఈ నైపుణ్యం ఉపయోగించే ప్లగిన్లు. version డిఫాల్ట్గా "*", optional డిఫాల్ట్గా false. |
dependencies | స్ట్రింగ్ల జాబితా | [] | తప్పనిసరిగా ఉండాల్సిన నైపుణ్యాల చిన్న పేర్లు. |
priority | integer | 0 | నిర్వహణ జాబితాలలో నైపుణ్యాల క్రమాన్ని నిర్ణయిస్తుంది. ఉద్యోగి ఏ నైపుణ్యాన్ని ఎంచుకుంటారో దానిపై ప్రభావం చూపదు. |
author | string | "" | ప్రదర్శన కోసం నిల్వ చేయబడుతుంది. |
license | string | "" | ప్రదర్శన కోసం నిల్వ చేయబడుతుంది. |
compatibility | string | "" | స్వేచ్ఛా టెక్స్ట్ నోట్, గరిష్ఠంగా 500 బైట్లు. |
tags | స్ట్రింగ్ల జాబితా | [] | ప్రదర్శన కోసం నిల్వ చేయబడుతుంది. |
allowed-tools | string | "" | స్పేస్లతో వేరు చేసిన స్ట్రింగ్. నిల్వ చేయబడుతుంది; అమలు చేయబడదు. |
requires లేదా dependenciesలో పేర్కొన్న నైపుణ్యం లేనప్పుడు లేదా పరిధి బయట ఉన్నప్పుడు, లేదా తప్పనిసరి ప్లగిన్ ఇన్స్టాల్ కానప్పుడు, నైపుణ్యం లోడ్ అవుతుంది కానీ degraded అని గుర్తించబడుతుంది. ఏమి లేదో యజమాని చూస్తారు.
సీక్రెట్లు
నైపుణ్యం స్క్రిప్ట్లకు అవసరమైన క్రెడెన్షియల్లను 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 | విలువను ఎక్కడ పొందాలి. |
required | true అయినప్పుడు, విలువ సెట్ చేసే వరకు 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} | ప్రకటించిన సీక్రెట్ విలువ. |
$ARGUMENTS | use_skillకు పంపిన args. బాడీలో $ARGUMENTS లేనప్పుడు, ఆర్గ్యుమెంట్లు దాని తర్వాత జోడించబడతాయి. |
నైపుణ్య టూల్లు
ఉద్యోగులు ఈ టూల్ల ద్వారా నైపుణ్యాలతో పని చేస్తారు. use_skill ఎప్పుడూ అందుబాటులో ఉంటుంది; మిగతావి ఉద్యోగికి అవసరమైనప్పుడు లోడ్ అవుతాయి.
| టూల్ | పారామీటర్లు | ఇది ఏమి చేస్తుంది |
|---|---|---|
use_skill | name, args | నైపుణ్యాన్ని లోడ్ చేస్తుంది. విస్తరించిన బాడీని, ఫోల్డర్ పాత్ను, మొదటి 20 ఫైల్ పేర్లను తిరిగి ఇస్తుంది. డిసేబుల్ చేసిన నైపుణ్యాన్ని మళ్లీ ఎనేబుల్ చేస్తుంది. |
find_skills | query | పేరు, ట్రిగ్గర్ మరియు వివరణ సరిపోలికల ఆధారంగా ర్యాంక్ చేసిన గరిష్ఠంగా 10 నైపుణ్యాలను తిరిగి ఇస్తుంది. |
read_skill_file | name, path | నైపుణ్యం ఫోల్డర్లోని ఒక ఫైల్ను చదువుతుంది. path లేకుండా, ఫైల్లను వాటి పరిమాణాలతో జాబితా చేస్తుంది. |
save_skill | name, content | పూర్తి SKILL.mdను యూజర్ నైపుణ్యాల ఫోల్డర్లో రాస్తుంది. మార్కెట్ప్లేస్ నైపుణ్యాలను ఓవర్రైట్ చేయలేరు. |
delete_skill | name | యూజర్ నైపుణ్యాన్ని తొలగిస్తుంది. |
install_skill | code | మార్కెట్ప్లేస్ నైపుణ్యాన్ని దాని SKIL- ఇన్స్టాల్ కోడ్ నుండి ఇన్స్టాల్ చేస్తుంది. |
configure_skill | name, key, value | సీక్రెట్ను సెట్ చేస్తుంది. key లేకుండా, నైపుణ్యానికి ఏమి అవసరమో చూపిస్తుంది. |
rate_skill | name, rating, review | మార్కెట్ప్లేస్ నైపుణ్యానికి 1 నుండి 5 వరకు రేటింగ్ ఇస్తుంది. |
read_skill_reviews | name | మార్కెట్ప్లేస్ నైపుణ్యం సమీక్షలను చదువుతుంది. |
execute | skill, script, args, timeout | నైపుణ్యం ఫోల్డర్ నుండి ఒక స్క్రిప్ట్ను రన్ చేస్తుంది. స్క్రిప్ట్ శాండ్బాక్స్ చూడండి. |
స్క్రిప్ట్ శాండ్బాక్స్
execute టూల్ నైపుణ్యం ఫోల్డర్ నుండి ఒక స్క్రిప్ట్ను రన్ చేస్తుంది. ఫైల్ ఆధారంగా రన్టైమ్ను ఎంచుకుంటుంది.
| స్క్రిప్ట్ | రన్టైమ్ |
|---|---|
.py | Python, ఉంటే Nebo బండిల్ చేసిన uv ద్వారా, లేకపోతే python3. |
.ts, .js | ఉంటే Nebo బండిల్ చేసిన Bun, లేకపోతే node. |
bin/<file> లేదా binary | నేరుగా రన్ అవుతుంది. |
.sh | సపోర్ట్ లేదు. |
ప్రతి రన్ ఖాళీ ఎన్విరాన్మెంట్తో మరియు ఈ వేరియబుల్లతో ప్రారంభమవుతుంది:
| వేరియబుల్ | విలువ |
|---|---|
SKILL_ARGS | JSONగా 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 అక్షరాలను మించినప్పుడు, ముందుగా షేర్డ్ నైపుణ్యాలు కుదించబడతాయి; ఉద్యోగి సొంత నైపుణ్యాలు పూర్తి ఎంట్రీలతో ఉంటాయి. |
మీరు మార్కెట్ప్లేస్కు ప్రచురించే ఫైల్ల పరిమితులు ప్రచురణ పేజీలో ఉన్నాయి.