ہدایات اور ایک حوالہ جاتی فائل
سب سے سادہ کارآمد مہارت ہدایات اور ایک حوالہ جاتی فائل ہے جسے ملازم صرف ضرورت پڑنے پر پڑھتا ہے۔ ٹرگرز ملازم کی فہرست میں مہارت کے اندراج میں الفاظ شامل کرتے ہیں، جس سے مختلف انداز میں کی گئی درخواستوں سے میل کھانے میں مدد ملتی ہے۔
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."
اسکرپٹ چلانے والی مہارت
جب کام کو بالکل درست جوابات درکار ہوں، جیسے حساب یا فائل کی تبدیلی، تو اسکرپٹ استعمال کریں۔ ملازم اسے execute سے چلاتا ہے اور آرگیومنٹس دیتا ہے جنہیں اسکرپٹ SKILL_ARGS سے JSON کی صورت میں پڑھتا ہے۔ اسکرپٹ stdout پر جو بھی پرنٹ کرے وہی نتیجہ ہے۔ یہ اسکرپٹ صرف 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,
})) ایک سیکرٹ اور نیٹ ورک رسائی
اسکرپٹس کو نیٹ ورک رسائی نہیں ہوتی جب تک مہارت network صلاحیت ظاہر نہ کرے، اور تب بھی صرف پیکیج رجسٹریز اور metadata.allowed_domains میں درج ڈومینز تک۔ metadata.secrets میں ظاہر کیا گیا سیکرٹ اپنی key کے نام والے انوائرنمنٹ ویری ایبل کے طور پر پہنچتا ہے۔ چونکہ سیکرٹ لازمی ہے، اس لیے جب تک مالک اسے سیٹ نہ کرے execute چلنے سے انکار کرتا ہے۔
---
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()) پلگ ان استعمال کرنے والی مہارت
جب کسی مہارت کو کسی خاص پلگ ان کی ضرورت ہو تو اسے plugins کے تحت درج کریں۔ اگر پلگ ان انسٹال نہ ہو تب بھی مہارت لوڈ ہوتی ہے، کمزور کے نشان کے ساتھ، تاکہ مالک دیکھ سکے کہ کیا غائب ہے۔ بہتر ہے کہ مہارت صلاحیت کے گرد لکھیں اور ملازم کو اپنے پاس موجود کنکشن استعمال کرنے دیں؛ پلگ ان صرف تب ظاہر کریں جب ہدایات واقعی اس پر منحصر ہوں۔
---
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. آگے
- SKILL.md کا حوالہ: ہر فیلڈ اور ویری ایبل۔
- اشاعت: مہارت اور اس کی فائلیں اپ لوڈ کریں۔