Anweisungen und eine Referenzdatei
Der einfachste nützliche Skill besteht aus Anweisungen plus einer Referenzdatei, die der Mitarbeiter nur liest, wenn er sie braucht. Trigger ergänzen den Eintrag des Skills in der Liste des Mitarbeiters um Begriffe, damit er auch unterschiedlich formulierte Anfragen zuordnen kann.
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."
Ein Skill, der ein Skript ausführt
Nutze ein Skript, wenn die Arbeit exakte Ergebnisse braucht, etwa Rechnen oder Dateikonvertierung. Der Mitarbeiter führt es mit execute aus und übergibt Argumente, die das Skript als JSON aus SKILL_ARGS liest. Was das Skript nach stdout ausgibt, ist das Ergebnis. Dieses Skript nutzt nur die Python-Standardbibliothek.
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,
})) Ein Secret und Netzwerkzugriff
Skripte haben keinen Netzwerkzugriff, sofern der Skill nicht die Fähigkeit network deklariert, und dann nur zu Paket-Registries und den Domains in metadata.allowed_domains. Ein in metadata.secrets deklariertes Secret kommt als Umgebungsvariable mit dem Namen aus key an. Weil das Secret Pflicht ist, verweigert execute die Ausführung, bis der Inhaber es setzt.
---
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()) Ein Skill, der ein Plugin nutzt
Wenn ein Skill ein bestimmtes Plugin braucht, führe es unter plugins auf. Ist das Plugin nicht installiert, wird der Skill trotzdem geladen, als eingeschränkt markiert, damit der Inhaber sieht, was fehlt. Schreib einen Skill lieber rund um die Fähigkeit und lass den Mitarbeiter die Verbindung nutzen, die er hat; deklariere ein Plugin nur, wenn die Anweisungen wirklich davon abhängen.
---
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. Weiter
- SKILL.md-Referenz: jedes Feld und jede Variable.
- Veröffentlichen: einen Skill und seine Dateien hochladen.