NeboAI
NeboAI
Magsimula

Mga Halimbawa

Kumpleto at nilo-load nang ganito mismo ang bawat halimbawa sa ibaba. Kopyahin ang isa, sabay na palitan ang pangalan ng folder at ang name field, at baguhin ang mga instruction.

Mga instruction at isang reference file

Ang pinakasimpleng kapaki-pakinabang na skill ay mga instruction kasama ang isang reference file na binabasa lang ng empleyado kapag kailangan nito. Nagdadagdag ang mga trigger ng mga salita sa entry ng skill sa listahan ng empleyado, na tumutulong dito na tumugma sa mga request na iba-iba ang pagkakasabi.

weekly-status/
├── SKILL.md
└── references/
    └── format.md
---
name: weekly-status
description: Write the weekly status update from the week's finished work, open items and risks. Use when someone asks for a weekly update, a status report or a Friday summary.
triggers: [status report, weekly update, friday summary]
---

# Weekly status

1. Collect what was finished this week, what is still open, and anything at risk.
2. Read references/format.md with read_skill_file and follow its layout exactly.
3. Keep each section to five bullets or fewer. Lead with outcomes, not activity.
4. End with the one decision you need from the reader, or write "No decisions needed."

Isang skill na nagpapatakbo ng script

Gumamit ng script kapag kailangan ng trabaho ang eksaktong sagot, gaya ng aritmetika o pag-convert ng file. Pinapatakbo ito ng empleyado gamit ang execute, at nagpapasa ng mga argument na binabasa ng script bilang JSON mula sa SKILL_ARGS. Anumang i-print ng script sa stdout ang resulta. Python standard library lang ang ginagamit ng script na ito.

invoice-totals/
├── SKILL.md
└── scripts/
    └── totals.py
---
name: invoice-totals
description: Add up invoice line items, apply a tax rate, and report the subtotal, tax and total. Use when someone asks to total, check or recalculate an invoice.
version: "1.0.0"
---

# Invoice totals

Never add numbers in your head. Run the script:

execute(skill: "invoice-totals", script: "scripts/totals.py",
        args: { "items": [{ "description": "...", "quantity": 2, "unit_price": 40.0 }], "tax_rate": 0.08 })

Report the subtotal, tax and total from the script's output, and list any line
item the script flagged.
import json
import os

args = json.loads(os.environ.get("SKILL_ARGS", "{}"))
items = args.get("items", [])
rate = float(args.get("tax_rate", 0))

subtotal = 0.0
flagged = []
for item in items:
    qty = item.get("quantity", 0)
    price = item.get("unit_price", 0)
    if qty <= 0 or price < 0:
        flagged.append(item.get("description", "unnamed item"))
        continue
    subtotal += qty * price

tax = round(subtotal * rate, 2)
print(json.dumps({
    "subtotal": round(subtotal, 2),
    "tax": tax,
    "total": round(subtotal + tax, 2),
    "flagged": flagged,
}))

Isang secret at network access

Walang network access ang mga script maliban kung idineklara ng skill ang capability na network, at kahit noon, sa mga package registry at mga domain sa metadata.allowed_domains lang. Ang secret na idineklara sa metadata.secrets ay dumarating bilang environment variable na pinangalanan ng key nito. Dahil kailangan ang secret, tumatanggi ang execute na tumakbo hangga't hindi ito naitatakda ng may-ari.

---
name: company-lookup
description: Look up a company's size, industry and headquarters from its web domain. Use when someone asks who a company is or wants a prospect researched.
version: "1.0.0"
capabilities: [network]
metadata:
  allowed_domains: [api.example.com]
  secrets:
    - key: EXAMPLE_API_KEY
      label: Example API key
      hint: Create a key at https://example.com/settings/keys
      required: true
---

# Company lookup

Run scripts/lookup.py with the domain:

execute(skill: "company-lookup", script: "scripts/lookup.py", args: { "domain": "example.com" })

If the script reports that the key is missing, ask the owner to add it with
configure_skill. Report only what the lookup returned; say so when a field is empty.
import json
import os
import urllib.request

domain = json.loads(os.environ.get("SKILL_ARGS", "{}")).get("domain", "")
req = urllib.request.Request(
    "https://api.example.com/v1/companies?domain=" + domain,
    headers={"Authorization": "Bearer " + os.environ["EXAMPLE_API_KEY"]},
)
with urllib.request.urlopen(req, timeout=20) as resp:
    print(resp.read().decode())

Isang skill na gumagamit ng plugin

Kapag kailangan ng skill ang isang partikular na plugin, ilista ito sa ilalim ng plugins. Kung hindi naka-install ang plugin, nilo-load pa rin ang skill, na may markang degraded, para makita ng may-ari kung ano ang kulang. Mas mabuting isulat ang skill tungkol sa capability at hayaang gamitin ng empleyado ang kahit anong koneksyong mayroon ito; magdeklara lang ng plugin kapag talagang nakasalalay dito ang mga instruction.

---
name: month-end-close
description: Walk through the month-end close checklist, reconcile each account and list what still needs the owner. Use at month end or when someone asks to close the books.
version: "1.0.0"
plugins:
  - name: example-ledger
    version: ">=2.0.0"
---

# Month-end close

For each balance-sheet account, in chart-of-accounts order, read its balance and unreconciled transactions from the ledger, reconcile what
matches, and list what does not. Never lock a period yourself; ask the owner.

Susunod