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

# Skills

> Creați pachete reutilizabile pentru agenți externi și Automations

Skills sunt pachete reutilizabile de instrucțiuni și fișiere de suport opționale. Acestea permit echipei dumneavoastră să definească o singură dată un mod repetabil de a finaliza o sarcină, apoi să îl aplice în mod consecvent în Flowglad.

Fiecare Skill are un nume, un slug pentru comanda slash, o descriere și instrucțiuni scrise în Markdown. Fișierele de suport pot oferi context sau resurse suplimentare necesare pentru a urma acele instrucțiuni.

## Folosiți Flowglad ca bibliotecă de Skills a echipei

Flowglad păstrează fiecare Skill ca pachet versionat. Publicarea unei modificări creează o nouă revizie în loc să înlocuiască pachetul anterior. Administratorii organizației pot deschide **History** pentru un Skill pentru a-i inspecta reviziile, a compara modificările, a restaura o revizie anterioară sau a renunța la o schiță, atunci când aceste acțiuni sunt disponibile.

Astfel, echipa dumneavoastră are un singur loc guvernat pentru a întreține instrucțiunile reutilizabile, păstrând totodată evidența versiunii active la un moment dat. Reviziile de tip schiță și cele respinse nu înlocuiesc versiunea activă.

### Gestionarea Skills prin MCP

După ce conectați serverul Flowglad MCP, un agent poate inspecta și gestiona biblioteca de Skills a organizației în numele dumneavoastră:

* `skills.list` returnează Skills vizibile pentru conexiune.
* `skills.get` returnează metadatele celei mai recente revizii și ale reviziei active pentru un Skill.
* `skills.create` trimite un nou pachet Skill.
* `skills.create_candidate` trimite o nouă revizie a unui Skill existent.
* `skills.publish_revision` verifică și publică o revizie amânată.
* `skills.create_package_upload_session` și `skills.finalize_package_upload_session` transportă pachetele prea mari pentru a fi trimise inline.
* `skills.get` raportează rezultatul verificării și promovării cererii acceptate.

Crearea sau actualizarea Skills necesită permisiunea `skills:write` atât pentru apartenența colegului la organizație, cât și pentru grant-ul conexiunii MCP. Dacă adăugați permisiunea după conectarea serverului, reconectați Flowglad MCP și autorizați `skills:write` pentru ca instrumentele de scriere să devină disponibile.

**Permisiuni:** Administratorii au implicit acces de autorare a Skills. Pentru a acorda același acces unui Contributor, deschideți **Settings** → **Team**, selectați colegul și activați **Skill Authoring**. Aceasta acordă permisiunea de a crea și actualiza Skills ale organizației fără a-l face pe coleg administrator.

## Încărcarea Skills Flowglad MCP în agentul dumneavoastră

Serverul Flowglad MCP anunță `io.modelcontextprotocol/skills` în timpul inițializării MCP. Aceasta le indică clienților compatibili că serverul implementează metodele de Skill pentru agenți `skills/list` și `skills/get`. Fiecare Skill returnat include URI-uri de resurse `skill://` și digest-uri de conținut; clienții pot prelua fișierele cu `resources/read`.

Conectarea serverului nu garantează că un client va apela `skills/list` sau va instala pachetele returnate. Suportul diferă de la un client la altul. Adăugați o instrucțiune de pornire pentru ChatGPT / Codex sau Claude atunci când doriți ca agentul să reîmprospăteze registrul Flowglad la începutul fiecărei sesiuni.

**Denumiri MCP:** Numele sunt diferite în mod intenționat. `skills.list`, cu punct, este un instrument Flowglad pentru înregistrările versionate de Skills ale organizației. `skills/list`, cu bară oblică, este o metodă de extensie a protocolului MCP pentru descoperirea pachetelor Skill destinate agenților.

### Adăugarea instrucțiunii de pornire

Creați o dată directorul de destinație înainte de a începe o sesiune nouă, apoi adăugați blocul de instrucțiuni corespunzător de mai jos.

#### ChatGPT / Codex

Creați directorul de destinație pentru ChatGPT / Codex cu `mkdir -p ~/.agents/skills`.

Puneți blocul următor în `~/.codex/AGENTS.md` pentru a-l aplica fiecărui proiect sau în fișierul `AGENTS.md` al unui repository pentru a-l partaja cu echipa acelui repository.

```markdown AGENTS.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.agents/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `$skill-name` invocation.
6. If this ChatGPT / Codex client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

#### Claude

Creați directorul de destinație pentru Claude cu `mkdir -p ~/.claude/skills`.

Puneți blocul următor în `~/.claude/CLAUDE.md` pentru a-l aplica fiecărui proiect sau în fișierul `CLAUDE.md` al unui repository pentru a-l partaja cu echipa acelui repository.

```markdown CLAUDE.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.claude/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `/skill-name` invocation.
6. If this Claude client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

Puteți cere ChatGPT / Codex sau Claude să adauge blocul potrivit în propriul fișier de instrucțiuni la nivel de utilizator. Examinați modificarea propusă înainte de a o accepta, deoarece acel fișier afectează sesiunile viitoare. Instrucțiunea este un bootstrap al agentului de tip best-effort; dacă mediul dumneavoastră trebuie să reîmprospăteze Skills în mod determinist, implementați aceeași sincronizare într-un hook `SessionStart` de încredere sau în integrarea clientului MCP.

## Unde sunt folosite Skills

Skills au în prezent doi consumatori:

* Agenții externi compatibili descoperă și sincronizează pachetele activate prin Flowglad MCP, apoi le potrivesc automat sau le invocă după nume.
* Automations fixează o revizie exactă publicată a unui Skill ca resursă de cod OWS `skill-revision`. Automation selectează o cale de pachet și un punct de intrare; pașii agentului primesc doar Skills autorizate de setul sigilat de capabilități al rulării.

Prima cale furnizează instrucțiuni reutilizabile unui agent extern. A doua furnizează cod imuabil și fișiere de suport unei rulări repetabile a unei Automation. Skills publicate sunt disponibile la nivelul întregii organizații, astfel încât o Automation autorizată poate selecta aceeași revizie de Skill în orice Space. Automation care îl consumă și rulările sale rămân în proprietatea Space-ului lor; selectarea unui Skill nu modifică această limită.

## Crearea și întreținerea Skills

Deschideți **organization menu** → **Skills** → **New Skill**. În fila **Skill**, introduceți **Name**, **Slug**, **Description** opțională și instrucțiunile reutilizabile în **Markdown**. Folosiți fila **Files** pentru orice fișiere de suport ale pachetului, apoi selectați **Create Skill**.

Slug-ul folosește litere mici, cifre și cratime, începe cu o literă sau o cifră și este ceea ce utilizatorii tastează după `/`.

Crearea sau editarea unui Skill produce o schiță. Pe pagina de detalii a Skill-ului, modificările se salvează automat; selectați **Publish Draft** pentru a verifica și publica schița. Dacă verificarea eșuează, folosiți diagnosticele afișate pentru a corecta schița și publicați din nou.

Folosiți **History** pentru a inspecta reviziile, a restaura o revizie înlocuită sau a renunța la o schiță modificabilă, atunci când aceste acțiuni sunt disponibile. **Disable Skill** îl elimină din descoperirea de către agenții externi și din rezolvarea de către Automations, fără a șterge istoricul reviziilor; **Enable Skill** îl face din nou disponibil.

## Crearea sau editarea unui Skill cu MCP

Folosiți un client MCP extern conectat pentru autorare centrată pe pachet. Apelați `skills.get` înainte de a edita un Skill existent. Folosiți `skills.create` pentru un pachet nou sau `skills.create_candidate` pentru o revizie bazată pe revizia activă curentă.

Pachetele mici pot fi furnizate inline. Pentru pachete mai mari, apelați `skills.create_package_upload_session`, încărcați obiectele solicitate și finalizați cu `skills.finalize_package_upload_session`. Dacă verificarea a fost amânată, apelați `skills.publish_revision`. Interogați periodic `skills.get` pentru cererea de ciclu de viață acceptată și rezultatul verificării sau promovării acesteia.

Publicarea unui Skill nu creează, nu revizuiește și nu activează o Automation; folosiți explicit ciclul de viață MCP al Automation atunci când este nevoie.

## Porniți de la un șablon de Skill

Pagina **Skills** include **Skill Templates**. Căutați sau filtrați catalogul, previzualizați un șablon și selectați **Copy Skill**. Copia devine un Skill al organizației care poate fi editat și publicat ca oricare alt Skill.

## Skills și Automations

Un Skill definește cum se execută o activitate reutilizabilă. Nu decide când rulează acea activitate.

Folosiți o Automation atunci când activitatea trebuie să ruleze manual, conform unui program sau ca răspuns la un eveniment. O Automation poate fixa una sau mai multe revizii de Skill, astfel încât aceeași implementare să fie reutilizată între rulări.


## Related topics

- [MCP](/docs/ro/mcp-server.md)
- [Automations](/docs/ro/automations.md)
- [Bun venit](/docs/ro/agents/introduction.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.