NeboAI
NeboAI
Commencer

Exemples

Chaque exemple ci-dessous est complet et se charge tel quel. Copiez-en un, renommez ensemble le dossier et le champ name, puis modifiez les instructions.

Des instructions et un fichier de référence

Le skill utile le plus simple, ce sont des instructions plus un fichier de référence que l'employé ne lit que lorsqu'il en a besoin. Les déclencheurs ajoutent des mots à l'entrée du skill dans la liste de l'employé, ce qui l'aide à reconnaître des demandes formulées de différentes façons.

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

Un skill qui exécute un script

Utilisez un script quand le travail exige des réponses exactes, comme des calculs ou une conversion de fichiers. L'employé l'exécute avec execute, en passant des arguments que le script lit en JSON depuis SKILL_ARGS. Tout ce que le script affiche sur stdout constitue le résultat. Ce script n'utilise que la bibliothèque standard de Python.

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,
}))

Un secret et un accès réseau

Les scripts n'ont aucun accès au réseau, sauf si le skill déclare la capacité network, et alors uniquement vers les registres de paquets et les domaines de metadata.allowed_domains. Un secret déclaré dans metadata.secrets arrive sous forme de variable d'environnement nommée par sa key. Le secret étant obligatoire, execute refuse de s'exécuter tant que le propriétaire ne l'a pas défini.

---
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())

Un skill qui utilise un plugin

Quand un skill a besoin d'un plugin précis, indiquez-le sous plugins. Si le plugin n'est pas installé, le skill se charge quand même, marqué comme dégradé, pour que le propriétaire voie ce qui manque. Privilégiez un skill construit autour de la capacité, en laissant l'employé utiliser la connexion dont il dispose ; ne déclarez un plugin que lorsque les instructions en dépendent vraiment.

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

Ensuite