Oħloq ħila b'SKILL.md
F'din il-paġna
Lezzjoni aġġornata fit-2 ta’ Novembru 2026 abbażi tal-paġna Skills fid-dokumentazzjoni ta’ Vibe: ħila hija sett ta’ struzzjonijiet (ma żżidx għodod),
allowed-toolsjinqara iżda ma jiġix infurzat, u żdiedu żewġ oqsma (disable-model-invocation,compatibility). Sors: Skills.
Ħiliet: Komponenti li jistgħu jerġgħu jintużaw
L-aġenti jiddefinixxu min iwettaq kompitu. Il-ħiliet jiddefinixxu xiex: huma settijiet ta’ struzzjonijiet li jistgħu jerġgħu jintużaw li jżidu proċeduri u kumandi slash ma’ Mistral Vibe. Id-distinzjoni ssir konkreta meta tapplikaha lit-tim tiegħek—aġent jirrifletti pożizzjoni ta’ xogħol personali, filwaqt li ħila tinkapsula proċedura li kulħadd irid iwettaq bl-istess mod.
Ħila hija direttorju li fih fajl SKILL.md b’frontmatter YAML. Din l-istruttura ssegwi l-ispeċifikazzjoni miftuħa ta’ Agent Skills, u tagħmel il-ħiliet portabbli u kondiviżibbli: l-istess folder jaħdem fuq il-magna tal-kollega tiegħek mingħajr adattament.
Anatomija ta’ SKILL.md
Hawnhekk hija l-istruttura sħiħa ta’ ħila, illustrata b’eżempju ta’ reviżjoni awtomatizzata tal-kodiċi:
---
name: code-review
description: Performs automated code reviews with quality analysis
license: MIT
user-invocable: true
allowed-tools:
- read_file
- grep
- ask_user_question
---
# Code Review Skill
This skill analyzes source code quality by checking:
1. **Naming conventions** — variables, functions, classes
2. **Cyclomatic complexity** — functions that are too long or nested
3. **Duplication** — copy-pasted code to refactor
4. **Security** — dangerous patterns (eval, SQL injection, XSS)
## Usage
Run `/code-review` followed by the path or description of the code to analyze.
## Output format
The report is structured in three levels:
- 🔴 **Critical** — fix immediately
- 🟡 **Warning** — fix before merging
- 🟢 **Suggestion** — optional improvement
L-oqsma tal-frontmatter YAML
L-oqsma name huwa l-identifikatur uniku għall-ħila. Jintuża biex tħabbil, tiskonnettja, u tirreferenzja l-ħila fil-konfigurazzjonijiet. Dan l-isem isir ukoll il-kumand slash, allura jiswa li żżommu qasir.
name: code-review
Id-description, sa 1,024 karattru, hija l-frażi li tidher meta Vibe jelenka l-ħiliet disponibbli. Iktebha mill-perspettiva ta’ xi ħadd li qed ifittex: għandha tippermettilu jagħżel bejn żewġ ħiliet simili mingħajr ma jiftaħ il-fajls.
description: Performs automated code reviews with quality analysis
L-oqsma license jindika l-liċenzja tal-ħila, li ssir importanti hekk kif taqsamha lil hinn mill-istazzjon tax-xogħol tiegħek stess.
license: MIT
Il-boolejan user-invocable, veru b’mod default, jesponi l-ħila bħala kumand slash. Ippostah għal false biex taħbih mill-menu /: l-aġent xorta jista’ jħabbilha awtomatikament meta l-kompitu jkun xieraq.
user-invocable: true # Accessible via /code-review
user-invocable: false # Hidden from / menu, agent can still load it
L-oqsma disable-model-invocation, meta mwaqqaf għal true, jipprevjeni lill-aġent milli jħabbel il-ħila waħdu: tidher biss jekk inti ttajpja /skill-name. Irriżerva dan għal proċeduri li l-ebda mudell m’għandu jniedi mingħajr il-kunsens espliċitu tiegħek, bħal dispjegament (deployment).
disable-model-invocation: true
Żewġ oqsma informattivi jikkompletaw il-lista: compatibility, li jinnota l-prerekwiżiti (“Jeħtieġ git”), u allowed-tools, li jelenka l-għodod li l-ħila tintendi tuża. Oqgħod attent mal-aħħar wieħed: id-dokumentazzjoni tispeċifika li Vibe jaqrah iżda ma jinfurzahx. Ħila tista’ ssejjaħ kwalunkwe għodda li l-aġent attiv jawtorizza. Biex tillimita x’tista’ tagħmel ħila, irrestrinġi l-għodod u l-permessi tal-aġent (Lezzjonijiet 2 u 3).
allowed-tools:
- read_file
- grep
- ask_user_question
Il-korp ta’ SKILL.md
Wara l-frontmatter, il-korp tal-fajl huwa Markdown b’forma ħielsa. Iservi kemm bħala dokumentazzjoni kif ukoll prompt: Vibe jaqrah biex jifhem kif taħdem il-ħila u f’liema kuntest għandha tiġi applikata. Hawnhekk tiddeskrivi x’tagħmel il-ħila, il-passi tal-operazzjoni tagħha, il-format tal-output mistenni, u eżempji ta’ użu. Korp vagu jipproduċi ħila mhux prevedibbli; korp preċiż jipproduċi ħila li tagħti l-istess riżultat ġimgħa wara ġimgħa.
Oħloq l-ewwel ħila tiegħek
Ejja nibnu ħila ta’ ġenerazzjoni ta’ testijiet. Ibda billi toħloq id-direttorju tagħha:
mkdir -p ~/.vibe/skills/test-generator
Poġġi l-SKILL.md li ġej ġewwa. Innota kif il-korp iwieġeb mistoqsijiet li Vibe kieku kellu jissuspetta: liema framework tagħżel, kif isemmi l-blokki, fejn tikteb il-fajl tal-output.
---
name: test-generator
description: Generates unit tests for TypeScript/JavaScript functions
license: MIT
user-invocable: true
allowed-tools:
- read_file
- write_file
- grep
---
# Test Generator
Generates comprehensive unit tests for
TypeScript and JavaScript functions.
## Process
1. Read the target source file
2. Identify all exported functions
3. For each function, generate:
- Happy path test
- Test with empty/null inputs
- Edge case tests
- Expected error tests
4. Write tests to an adjacent `.test.ts` file
## Conventions
- Framework: Vitest (default) or Jest if detected
- Naming: `describe` per function, `it` per test case
- Assertions: `expect` with precise matchers
- No mocks unless necessary (external dependencies)
## Example
For a file `utils/math.ts` containing `add(a, b)`,
the skill generates `utils/math.test.ts` with corresponding tests.
Ladarba l-fajl jinħoloq, il-ħila tkun disponibbli immedjatament: l-ebda kumand ta’ installazzjoni, l-ebda riavvju. Neddi Vibe u sejjaħha fuq fajl reali.
vibe
# > /test-generator src/utils/math.ts
Vibe iħabbel il-ħila, jaqra l-SKILL.md tagħha biex jifhem l-imġiba mistennija, u jwettaq il-kompitu bl-għodod awtorizzati. Ħu l-ħin biex taqra r-riżultat: billi tqabbel l-output ma’ dak li ħsibt, tirfina l-korp tal-fajl.
L-aħjar prattiki
Ippjana għal ħila waħda għal kull karatteristika. It-taħlit tar-reviżjoni tal-kodiċi u l-ġenerazzjoni tat-testijiet f’fajl wieħed jipproduċi prompt li jħabbat, u jipprevjenik milli tiskonnettja waħda mingħajr ma titlef l-oħra. Bl-istess mod, illimita l-għodod awtorizzati għal dawk li l-ħila verament teħtieġ.
Il-bqija tiddependi fuq il-kwalità tal-kitba. Il-korp ta’ SKILL.md huwa l-prompt tiegħek: kun preċiż, u inkludi eżempji konkreti ta’ x’tipproduċi l-ħila—eżempju ta’ output jiswa aktar minn tliet linji ta’ deskrizzjoni. Fl-aħħar nett, ittestja l-ħila tiegħek fuq diversi każijiet, inkluż wieħed diffiċli, qabel ma taqsamha mat-tim.
Punti Ewlenin
- Ħila hija direttorju b’fajl
SKILL.mdli fih frontmatter YAML - Il-frontmatter jiddefinixxi l-isem, id-deskrizzjoni, l-għodod permessi, u l-invokabbiltà
- Il-korp Markdown iservi kemm bħala dokumentazzjoni kif ukoll prompt għal Vibe
user-invocable: truejagħmel il-ħila aċċessibbli permezz ta’ kumand slash- Oħloq ħiliet speċjalizzati bl-inqas numru possibbli ta’ għodod meħtieġa