> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> Skill-urile ajută Cascade să gestioneze sarcini complexe, cu mai mulți pași.

Cele mai dificile sarcini de inginerie necesită adesea mai mult decât simple prompturi bune. Acestea pot necesita scripturi de referință, șabloane, liste de verificare și alte fișiere de suport. Skill-urile vă permit să grupați toate acestea în foldere pe care Cascade le poate invoca (citi și folosi).

Skill-urile sunt o modalitate excelentă de a învăța Cascade cum să execute consecvent fluxuri de lucru cu mai mulți pași.

Cascade folosește [**dezvăluire progresivă**](https://agentskills.io/what-are-skills#how-skills-work): în mod implicit, modelului îi sunt afișate doar `name` și `description` ale skill-ului. Conținutul complet al `SKILL.md` și fișierele de suport sunt încărcate **doar atunci când Cascade decide să invoce skill-ul** (sau când îi faceți `@mention`). Acest lucru menține fereastra de context suplă chiar și atunci când sunt definite multe skill-uri.

Pentru mai multe detalii despre specificația Skills, vizitați [agentskills.io](https://agentskills.io/home).

<div id="how-to-create-a-skill">
  ## Cum să creați un Skill
</div>

<div id="using-the-ui-easiest">
  ### Utilizarea interfeței (cea mai simplă)
</div>

1. Deschideți panoul Cascade
2. Faceți clic pe cele trei puncte din colțul din dreapta sus al panoului pentru a deschide meniul Personalizări
3. Faceți clic pe secțiunea `Skills`
4. Faceți clic pe `+ Workspace` pentru a crea un skill specific workspace-ului (proiectului) sau pe `+ Global` pentru a crea un skill global
5. Denumiți skill-ul (numai litere mici, cifre și cratime)

<div id="manual-creation">
  ### Creare manuală
</div>

**Skill de workspace (specific proiectului):**

1. Creați un director: `.windsurf/skills/<skill-name>/`
2. Adăugați un fișier `SKILL.md` cu frontmatter YAML

**Skill global (disponibil în toate workspace-urile):**

1. Creați un director: `~/.codeium/windsurf/skills/<skill-name>/`
2. Adăugați un fișier `SKILL.md` cu frontmatter YAML

<div id="skillmd-file-format">
  ## Formatul fișierului SKILL.md
</div>

Fiecare skill are nevoie de un fișier `SKILL.md` cu frontmatter YAML care conține metadatele skillului:

<div id="example-skill">
  ### Exemplu de „skill”
</div>

```markdown theme={null}
---
name: deploy-to-production
description: Ghidează procesul de deployment în producție cu verificări de siguranță
---

## Lista de verificare înainte de deployment
1. Rulați toate testele
2. Verificați modificările necomise
3. Verificați variabilele de mediu

## Pașii pentru deployment
Urmați acești pași pentru a efectua deployment-ul în siguranță...

[Referențiați fișierele de suport din acest director după necesitate]
```

<div id="required-frontmatter-fields">
  ### Câmpuri obligatorii în frontmatter
</div>

* **name**: Identificator unic pentru skill (afișat în UI și folosit pentru mențiuni cu @)
* **description**: Explicație scurtă prezentată modelului AI, pentru a-l ajuta să decidă când să activeze skill-ul

Exemple de nume valide: `deploy-to-staging`, `code-review`, `setup-dev-environment`

<div id="adding-supporting-resources">
  ## Adăugarea resurselor de suport
</div>

Plasați toate fișierele de suport în folderul skill-ului, alături de `SKILL.md`. Aceste fișiere devin disponibile pentru Cascade atunci când skill-ul este apelat:

```
.windsurf/skills/deploy-to-production/
├── SKILL.md
├── deployment-checklist.md
├── rollback-procedure.md
└── config-template.yaml
```

<div id="invoking-skills">
  ## Invocarea skillurilor
</div>

<div id="automatic-invocation">
  ### Invocare automată
</div>

Când solicitarea dvs. se potrivește cu descrierea unui skill, Cascade invocă automat skill-ul și folosește instrucțiunile și resursele acestuia pentru a îndeplini sarcina. Aceasta este cea mai frecventă modalitate de utilizare a skill-urilor — pur și simplu descrieți ce doriți să faceți, iar Cascade determină care skill-uri sunt relevante.

Câmpul `description` din frontmatter-ul skill-ului dvs. este esențial: acesta ajută Cascade să înțeleagă când să invoce skill-ul. Scrieți descrieri care să explice clar ce face skill-ul și când ar trebui folosit.

<div id="manual-invocation">
  ### Invocare manuală
</div>

Puteți oricând activa explicit un skill tastând `@skill-name` în câmpul de introducere din Cascade. Acest lucru este util dacă doriți să vă asigurați că este folosit un anumit skill sau dacă doriți să invocați un skill care altfel este posibil să nu fie declanșat automat de cererea dumneavoastră.

<div id="skill-scopes">
  ## Domenii de aplicare pentru skill-uri
</div>

| Scope               | Location                                        | Availability                                                              |
| ------------------- | ----------------------------------------------- | ------------------------------------------------------------------------- |
| Workspace           | `.windsurf/skills/`                             | Numai pentru workspace-ul curent. Este versionat împreună cu repo-ul dvs. |
| Global              | `~/.codeium/windsurf/skills/`                   | Toate workspace-urile de pe mașina dvs. Nu este versionat.                |
| System (Enterprise) | Specific sistemului de operare (vedeți mai jos) | Toate workspace-urile, distribuite de IT. Doar în citire.                 |

<Note>
  Pentru compatibilitate între agenți, Windsurf detectează, de asemenea, skill-uri în `.agents/skills/` și `~/.agents/skills/`. Dacă ați activat citirea configurației Claude Code, sunt scanate și `.claude/skills/` și `~/.claude/skills/`.
</Note>

<div id="system-level-skills-enterprise">
  ### Skill-uri la nivel de sistem (Enterprise)
</div>

Organizațiile Enterprise pot implementa skill-uri disponibile în toate workspace-urile și care nu pot fi modificate de utilizatorii finali:

| OS        | Path                                            |
| --------- | ----------------------------------------------- |
| macOS     | `/Library/Application Support/Windsurf/skills/` |
| Linux/WSL | `/etc/windsurf/skills/`                         |
| Windows   | `C:\ProgramData\Windsurf\skills\`               |

Fiecare skill este un subdirector care conține un fișier `SKILL.md`, la fel ca skill-urile din workspace.

<div id="example-use-cases">
  ## Exemple de scenarii de utilizare
</div>

<div id="deployment-workflow">
  ### Flux de implementare
</div>

Creati un skill cu scripturi de deployment, configurari de mediu si proceduri de rollback:

```
.windsurf/skills/deploy-staging/
├── SKILL.md
├── pre-deploy-checks.sh
├── environment-template.env
└── rollback-steps.md
```

<div id="code-review-guidelines">
  ### Ghiduri pentru code review
</div>

Includeți ghiduri de stil, liste de verificare pentru securitate și șabloane pentru code review:

```
.windsurf/skills/code-review/
├── SKILL.md
├── style-guide.md
├── security-checklist.md
└── review-template.md
```

<div id="testing-procedures">
  ### Proceduri de testare
</div>

Grupați șabloanele de test, cerințele de acoperire și configurațiile CI/CD:

```
.windsurf/skills/run-tests/
├── SKILL.md
├── test-template.py
├── coverage-config.json
└── ci-workflow.yaml
```

<div id="best-practices">
  ## Cele mai bune practici
</div>

1. **Scrieți descrieri clare**: Descrierea ajută Cascade să decidă când să apeleze skill-ul. Fiți specific cu privire la ce face skill-ul și când ar trebui folosit.

2. **Includeți resurse relevante**: Șabloanele, listele de verificare și exemplele fac skill-urile mai utile. Gândiți-vă la ce fișiere ar ajuta pe cineva să finalizeze sarcina.

3. **Folosiți nume descriptive**: `deploy-to-staging` este mai bun decât `deploy1`. Numele ar trebui să indice clar ce face skill-ul.

<div id="skills-vs-rules-vs-workflows">
  ## Skills vs Rules vs Workflows
</div>

Toate trei personalizează Cascade, dar diferă prin **structură**, **invocare** și **costul contextual**:

|                             | Skills                                                                                | Rules                                              | Workflows                                                     |
| --------------------------- | ------------------------------------------------------------------------------------- | -------------------------------------------------- | ------------------------------------------------------------- |
| **Scop**                    | Proceduri în mai mulți pași, cu fișiere de suport                                     | Reguli de comportament („cum să se comporte”)      | Șabloane de prompt pentru sarcini repetitive                  |
| **Structură**               | Folder cu `SKILL.md` + orice fișiere de resurse                                       | Un singur fișier `.md` cu frontmatter              | Un singur fișier `.md`                                        |
| **Invocare**                | modelul AI decide (dezvăluire progresivă) sau `@mention`                              | `always_on` / `glob` / `model_decision` / `manual` | **Doar manual** prin `/slash-command`                         |
| **În promptul de sistem?**  | Nu — doar numele + descrierea, până este invocat                                      | Depinde de modul de activare                       | Nu — sunt listate ca comenzi disponibile                      |
| **Cel mai potrivit pentru** | Deploymenturi, code review-uri, proceduri de testare care necesită scripturi/șabloane | Stil de codare, convenții de proiect, constrângeri | Runbook-uri cu execuție unică, pe care le declanșați explicit |

**Regulă practică:** dacă Cascade ar trebui să îl preia automat *și* are nevoie de fișiere de suport, folosiți un Skill. Dacă este o constrângere scurtă de comportament, folosiți un Rule. Dacă vreți să îl declanșați întotdeauna chiar dumneavoastră, folosiți un Workflow.

<div id="related-documentation">
  ## Documentație conexă
</div>

Dacă Skills nu este ceea ce căutați, consultați și aceste alte funcționalități Cascade:

* **[Workflows](./workflows)** - Automatizați sarcinile repetitive cu workflow-uri Markdown reutilizabile, declanșate prin comenzi slash
* **[AGENTS.md](./agents-md)** - Oferiți instrucțiuni la nivel de director care se aplică automat în funcție de locația fișierelor
* **[Memories & Rules](./memories)** - Păstrați contextul de-a lungul conversațiilor cu memorii generate automat și reguli definite de utilizator