Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Cruthaigh scil le SKILL.md

Ceacht 6 as 14 Nuashonraithe 2 Samhain 2026 Ardleibhéal
Ar an leathanach seo
  1. Scileanna: Comhpháirteanna in-athúsáidte
  2. Anatamaíocht SKILL.md
  3. Réimsí an réamhábhair YAML
  4. Corpas SKILL.md
  5. Cruthaigh do chéad scil
  6. Dea-chleachtais
  7. Príomhphointí

An ceacht nuashonraithe an 2 Samhain, 2026 bunaithe ar an leathanach Skills i ndoiciméadú Vibe: is tacar treoracha é scil (ní chuireann sé uirlisí leis), léitear allowed-tools ach ní fhorghníomhaítear é, agus tá dhá réimse curtha leis (disable-model-invocation, compatibility). Foinse: Skills.

Scileanna: Comhpháirteanna in-athúsáidte

Sainíonn gníomhairí cé a dhéanann tasc. Sainíonn scileanna cad: is tacair threoracha in-athúsáidte iad a chuireann nósanna imeachta agus orduithe slaiste (/) le Mistral Vibe. Éiríonn an t-idirdhealú concreideach nuair a chuireann tú i bhfeidhm ar do fhoireann é – léiríonn gníomhaire dearadh oibre pearsanta, ach cuimsíonn scil nós imeachta nach mór do chách a chur i gcrích ar an mbealach céanna.

Is comhadlann é scil ina bhfuil comhad SKILL.md le réamhábhar YAML. Leanann an struchtúr seo an tsonraíocht oscailte Agent Skills, rud a fhágann go bhfuil scileanna iniompartha agus inroinnte: oibríonn an fillteán céanna ar ríomhaire do chomhghleacaí gan aon oiriúnú.

Anatamaíocht SKILL.md

Seo struchtúr iomlán scil, léirithe le sampla athbhreithnithe cód uathoibrithe:

---
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

Réimsí an réamhábhair YAML

Is é an réimse name an t-aitheantóir uathúil don scil. Úsáidtear é chun an scil a chumasú, a dhíchumasú, agus tagairt a dhéanamh dó i gcumraíochtaí. Éiríonn an t-ainm seo ina ordú slaiste freisin, mar sin is fiú é a choinneáil gairid.

name: code-review

Is é an description, suas le 1,024 carachtar, an frása a fheictear nuair a liostaíonn Vibe na scileanna atá ar fáil. Scríobh é ó pheirspictíocht duine atá ag cuardach: ba chóir go gcuirfeadh sé ar do chumas roghnú idir dhá scil chosúla gan na comhaid a oscailt.

description: Performs automated code reviews with quality analysis

Léiríonn an réimse license ceadúnas na scile, rud a éiríonn tábhachtach chomh luath agus a roinneann tú é thar do stáisiún oibre féin.

license: MIT

Is booleán é user-invocable, fíor de réir réamhshocraithe, a nochtann an scil mar ordú slaiste. Socraigh go false é chun é a cheilt ón roghchlár /: is féidir leis an ngníomhaire é a lódáil go huathoibríoch fós nuair a oireann an tasc dó.

user-invocable: true   # Inrochtana trí /code-review
user-invocable: false  # Folaigh ón roghchlár /, is féidir leis an ngníomhaire é a lódáil fós

Nuair a shocraítear an réimse disable-model-invocation go true, coscaíonn sé ar an ngníomhaire an scil a lódáil leis féin: ní ritheann sé ach má chlóscríobhann tú /skill-name. Cuir in áirithe é seo do nósanna imeachta nach chóir d’aon mhúnla a spreagadh gan do thoiliú sainráite, mar shampla imlonnú.

disable-model-invocation: true

Cuireann dhá réimse faisnéise críoch leis an liosta: compatibility, a thugann faoi deara réamhriachtanais (“Requires git”), agus allowed-tools, a liostaíonn na huirlisí a bhfuil sé beartaithe ag an scil a úsáid. Bí cúramach leis an gceann deireanach: sonraíonn an doiciméadú go léann Vibe é ach nach ndéanann sé forghníomhú air. Is féidir le scil aon uirlis a ghlaoidh a údaróidh an gníomhaire gníomhach. Chun teorainn a chur le cad is féidir le scil a dhéanamh, sriain uirlisí agus ceadanna an ghníomhaire (Ceachtanna 2 agus 3).

allowed-tools:
  - read_file
  - grep
  - ask_user_question

Corpas SKILL.md

Tar éis an réamhábhair, tá corpas an chomhaid saor-chruthach i Markdown. Feidhmíonn sé mar doiciméadú agus mar leid: léann Vibe é chun tuiscint a fháil ar conas a oibríonn an scil agus i gcomhthéacs cén uair ba chóir é a chur i bhfeidhm. Anseo a dhéanann tú cur síos ar cad a dhéanann an scil, céimeanna a oibríochta, an fhormáid aschuir a bhfuiltear ag súil léi, agus samplaí úsáide. Tugann corpas doiléir scil neamhthuarthach; tugann corpas cruinn scil a tháirgeann an toradh céanna seachtain i ndiaidh seachtaine.

Cruthaigh do chéad scil

Déanaimis scil giniúna tástála a thógáil. Tosaigh trí a chomhadlann a chruthú:

mkdir -p ~/.vibe/skills/test-generator

Cuir an SKILL.md seo a leanas isteach ann. Tabhair faoi deara conas a fhreagraíonn an corpas ceisteanna a bheadh ar Vibe a thuar murach sin: cén creatlach a roghnú, conas blocanna a ainmniú, cá háit an comhad aschuir a scríobh.

---
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.

Nuair a chruthaítear an comhad, tá an scil ar fáil láithreach: gan ordú suiteála, gan atosú. Seol Vibe agus glaoidh air ar chomhad fíor.

vibe
# > /test-generator src/utils/math.ts

Lódálann Vibe an scil, léann sé a SKILL.md chun tuiscint a fháil ar an iompar a bhfuiltear ag súil leis, agus déanann sé an tasc leis na huirlisí údaraithe. Tóg do chuid ama chun an toradh a léamh: trí chur i gcomparáid an t-aschur leis an rud a shamhlaigh tú, déanfaidh tú feabhsú ar chorpas an chomhaid.

Dea-chleachtais

Cloígh le scil amháin in aghaidh gné. Má mheasctar athbhreithniú cód agus giniúint tástála i gcomhad amháin, cruthaítear leid atá leathach, agus coscaíonn sé ort ceann amháin a dhíchumasú gan an ceann eile a chailleadh. Mar an gcéanna, teorainn na huirlisí údaraithe leo siúd a theastaíonn ón scil go díreach.

Braitheann an chuid eile ar cháilíocht na scríbhneoireachta. Is é corpas SKILL.md do leid: bí cruinn, agus cuir samplaí concreideacha san áireamh de cad a tháirgeann an scil – tá sampla aschuir níos luachmhaire ná trí líne cur síos. Ar deireadh, déan tástáil ar do scil ar roinnt cásanna, lena n-áirítear ceann deacair, sula roinneann tú leis an bhfoireann é.

Príomhphointí

  • Is comhadlann le comhad SKILL.md ina bhfuil réamhábhar YAML é scil
  • Sainíonn an réamhábhar an t-ainm, an cur síos, na huirlisí ceadaithe, agus an t-inbhéartaitheacht
  • Feidhmíonn an corpas Markdown mar dhoiciméadú agus mar leid do Vibe araon
  • Déanann user-invocable: true an scil inrochtana trí ordú slaiste
  • Cruthaigh scileanna speisialaithe leis an líon uirlisí is gá