Crearea unei abilități cu SKILL.md
Pe această pagină
Lecție actualizată la 2 noiembrie 2026 pe baza paginii Skills din documentația Vibe: o abilitate este un set de instrucțiuni (nu adaugă instrumente),
allowed-toolseste citit dar nu este impus, iar două câmpuri au fost adăugate (disable-model-invocation,compatibility). Sursă: Skills.
Abilități: componente reutilizabile
Agenții definesc cine execută o sarcină. Abilitățile definesc ce: ele sunt seturi de instrucțiuni reutilizabile care adaugă proceduri și comenzi slash în Mistral Vibe. Distincția devine concretă atunci când o aplicați echipei dumneavoastră—un agent reflectă o postură de lucru personală, în timp ce o abilitate încapsulează o procedură pe care toată lumea trebuie să o execute în același mod.
O abilitate este un director care conține un fișier SKILL.md cu un antet YAML. Această structură urmează specificația deschisă Agent Skills, făcând abilitățile portabile și partajabile: același dosar funcționează pe calculatorul colegului dumneavoastră fără adaptare.
Anatomia unui SKILL.md
Iată structura completă a unei abilități, ilustrată printr-un exemplu de revizuire automată a codului:
---
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
Câmpurile din antetul YAML
Câmpul name este identificatorul unic al abilității. Este utilizat pentru a activa, dezactiva și a face referire la abilitate în configurații. Acest nume devine, de asemenea, comanda slash, așa că merită să îl păstrați scurt.
name: code-review
Câmpul description, de până la 1.024 de caractere, este fraza care apare atunci când Vibe listează abilitățile disponibile. Scrieți-l din perspectiva cuiva care caută: ar trebui să îi permită să aleagă între două abilități similare fără a deschide fișierele.
description: Performs automated code reviews with quality analysis
Câmpul license indică licența abilității, ceea ce devine important imediat ce o partajați dincolo de propria stație de lucru.
license: MIT
Booleanul user-invocable, adevărat în mod implicit, expune abilitatea ca o comandă slash. Setează-l la false pentru a o ascunde din meniul /: agentul o poate încărca totuși automat atunci când sarcina se potrivește.
user-invocable: true # Accessible via /code-review
user-invocable: false # Hidden from / menu, agent can still load it
Câmpul disable-model-invocation, atunci când este setat la true, împiedică agentul să încarce abilitatea de la sine: aceasta rulează doar dacă tastați /skill-name. Rezervați acest lucru pentru proceduri pe care niciun model nu ar trebui să le declanșeze fără consimțământul dumneavoastră explicit, cum ar fi o implementare.
disable-model-invocation: true
Două câmpuri informative completează lista: compatibility, care notează prerechizitele („Requires git“), și allowed-tools, care listează instrumentele pe care abilitatea intenționează să le utilizeze. Fiți atenți la acesta din urmă: documentația specifică faptul că Vibe îl citește, dar nu îl impune. O abilitate poate apela orice instrument pe care agentul activ îl autorizează. Pentru a limita ceea ce poate face o abilitate, restricționați instrumentele și permisiunile agentului (Lecțiile 2 și 3).
allowed-tools:
- read_file
- grep
- ask_user_question
Corpul fișierului SKILL.md
După antet, corpul fișierului este Markdown liber. Acesta servește atât ca documentație, cât și ca prompt: Vibe îl citește pentru a înțelege cum funcționează abilitatea și în ce context să o aplice. Aici descrieți ce face abilitatea, pașii funcționării sale, formatul de ieșire așteptat și exemple de utilizare. Un corp vag generează o abilitate imprevizibilă; un corp precis generează o abilitate care produce același rezultat săptămână după săptămână.
Crearea primei dumneavoastră abilități
Să construim o abilitate de generare a testelor. Începeți prin crearea directorului său:
mkdir -p ~/.vibe/skills/test-generator
Plasați următorul SKILL.md în interior. Observați cum corpul răspunde la întrebările pe care Vibe ar trebui altfel să le ghicească: ce framework să aleagă, cum să numească blocurile, unde să scrie fișierul de ieșire.
---
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.
Odată ce fișierul este creat, abilitatea este disponibilă imediat: nicio comandă de instalare, niciun repornire. Lansați Vibe și apelați-o pe un fișier real.
vibe
# > /test-generator src/utils/math.ts
Vibe încarcă abilitatea, citește SKILL.md-ul său pentru a înțelege comportamentul așteptat și execută sarcina cu instrumentele autorizate. Luați-vă timp să citiți rezultatul: comparând ieșirea cu ceea ce v-ați imaginat, veți rafina corpul fișierului.
Cele mai bune practici
Respectați regula unei abilități per funcționalitate. Amestecarea revizuirii codului și a generării testelor într-un singur fișier produce un prompt ezitant și vă împiedică să dezactivați una fără a o pierde pe cealaltă. În mod similar, limitați instrumentele autorizate la cele de care abilitatea are realmente nevoie.
Restul depinde de calitatea scrierii. Corpul SKILL.md este promptul dumneavoastră: fiți preciși și includeți exemple concrete a ceea ce produce abilitatea—un exemplu de ieșire valorează mai mult decât trei linii de descriere. În final, testați-vă abilitatea pe mai multe cazuri, inclusiv pe unul dificil, înainte de a o partaja cu echipa.
Puncte cheie
- O abilitate este un director cu un fișier
SKILL.mdconținând un antet YAML - Antetul definește numele, descrierea, instrumentele permise și posibilitatea de invocare
- Corpul Markdown servește atât ca documentație, cât și ca prompt pentru Vibe
user-invocable: trueface abilitatea accesibilă printr-o comandă slash- Creați abilități specializate cu numărul minim necesar de instrumente