Salt la conținutul principal
Română— Alege o limbă
Meniu

Crearea unei abilități cu SKILL.md

Lecția 6 din 14 Actualizată 2 noiembrie 2026 Avansat
Pe această pagină
  1. Abilități: componente reutilizabile
  2. Anatomia unui SKILL.md
  3. Câmpurile din antetul YAML
  4. Corpul fișierului SKILL.md
  5. Crearea primei dumneavoastră abilități
  6. Cele mai bune practici
  7. Puncte cheie

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-tools este 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.md conț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: true face abilitatea accesibilă printr-o comandă slash
  • Creați abilități specializate cu numărul minim necesar de instrumente