Cruthaigh scil le SKILL.md
Ar an leathanach seo
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-toolsach 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.mdina 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: truean scil inrochtana trí ordú slaiste - Cruthaigh scileanna speisialaithe leis an líon uirlisí is gá