Napišite prvu OpenClerq vještinu: jedna Markdown datoteka

OpenClerq ne dolazi ni s jednom vještinom. To je namjerno — jezgra ne pretpostavlja ništa o vašoj struci ni državi — ali znači i da agent ne radi ništa korisno dok ga nečemu ne naučite.

Vještina je jedna SKILL.md datoteka: YAML frontmatter koji čita gateway, pa Markdown upute koje čita model. U ovom tutorijalu pišemo jednu, učitavamo je i dokazujemo da usmjeravanje radi bez trošenja ijednog tokena.

Datoteka

Smjestite je u direktorij koji gateway prati (CLERQ_SKILLS_DIR ili zadani radni direktorij). Frontmatter je dio koji gateway parsira; sve nakon njega su upute koje se prosljeđuju modelu kad je vještina odabrana.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37---name: "Expense Check"slug: "expense-check"version: "2026.1"# Gateway ovo uspoređuje s tekstom /task poziva. Neka budu specifični:# dvije vještine koje obje reagiraju na "racun" tuku se međusobno.triggers: ["expense", "receipt", "reimbursement"]moduleType: "calc"domains: ["admin"]# Nije obavezno, ali se isplati: to je ono što izlaz čini strukturiranim# umjesto proznog teksta koji poslije opet morate parsirati.inputSchema:  type: object  required: [amountMinor, currency, category]  properties:    amountMinor: { type: integer }    currency:    { type: string, minLength: 3, maxLength: 3 }    category:    { type: string }outputSchema:  type: object  properties:    withinPolicy: { type: boolean }    reason:       { type: string }---Provjeri jednu stavku troška prema pravilniku u `rules/policy.md`.Pravila:- Računaj isključivo alatom za izračun. Nikad sam ne izračunavaj iznos.- Ako kategorije nema u pravilniku, vrati withinPolicy: false uz obrazloženje  da je kategorija nepoznata. Nemoj nagađati limit.- Citiraj konkretan redak pravilnika na koji si se oslonio, da te osoba  može provjeriti.

Učitavanje i provjera usmjeravanja

Gateway učitava svaki SKILL.md koji nađe u direktoriju vještina. POST /task zatim uspoređuje vašu poruku s triggers i bira vještinu. `dryRun: true` odradi to uspoređivanje i eventualni izračun, ali nikad ne zove model — što je pravi način za testiranje usmjeravanja, jer je besplatno i ponovljivo.

$ curl -s -H "Authorization: Bearer $(cat ~/.clerq/gateway-token)" http://127.0.0.1:18790/skills{"skills":[{"slug":"expense-check","name":"Expense Check","version":"2026.1"}]}# dry-run: usmjerava i računa, ali model ne poziva$ curl -s -X POST http://127.0.0.1:18790/task \>   -H "Authorization: Bearer $(cat ~/.clerq/gateway-token)" \>   -H "Content-Type: application/json" \>   -d '{"message":"is a 40 EUR client lunch receipt within policy?","dryRun":true}'{"dryRun":true,"matchedSkill":"expense-check", "intent":"skill","extracted":["40"], "llm":{"called":false,"reason":"dryRun"}}# poruka bez ijednog okidača propada dalje, kako i treba$ curl -s -X POST http://127.0.0.1:18790/task -H "Authorization: Bearer $(cat ~/.clerq/gateway-token)" \>   -H "Content-Type: application/json" -d '{"message":"book a meeting room","dryRun":true}'{"dryRun":true,"matchedSkill":null,"intent":"explain"}

Od vještine do modula

Modul je samo smislena skupina vještina, predložaka i pravila — mapa, a ne novi pojam. Kad imate tri-četiri povezane vještine, dajte im zajednički direktorij s referentnim materijalom koji citiraju (rules/, templates/) da upute mogu pokazivati na stvarne datoteke umjesto da pravilnik prepisuju u prompt.

1. 1.Počnite od najuže korisne vještine. Jedan posao, jedan oblik izlaza.
2. 2.Dodajte inputSchema i outputSchema čim rezultat netko dalje koristi.
3. 3.Koristite dependsOn kad jedna vještina stvarno treba da je druga već odrađena.
4. 4.Pravila držite u datotekama koje vještina citira, ne u promptu. Pravila se mijenjaju; promptovi se zaborave.