Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Oħloq ħila b'SKILL.md

Lezzjoni 6 / 14 Aġġornat 2 ta’ Novembru 2026 Avvanzat
F'din il-paġna
  1. Ħiliet: Komponenti li jistgħu jerġgħu jintużaw
  2. Anatomija ta’ SKILL.md
  3. L-oqsma tal-frontmatter YAML
  4. Il-korp ta’ SKILL.md
  5. Oħloq l-ewwel ħila tiegħek
  6. L-aħjar prattiki
  7. Punti Ewlenin

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-tools jinqara 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.md li 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: true jagħmel il-ħila aċċessibbli permezz ta’ kumand slash
  • Oħloq ħiliet speċjalizzati bl-inqas numru possibbli ta’ għodod meħtieġa