Ghid pentru crearea unui skill Grok

Ce face

create-skill te ajută să creezi interactiv un skill Grok nou, cu SKILL.md și, opțional, fișiere auxiliare precum scripturi sau documentație de referință.

În loc să construiești manual structura, frontmatter-ul și instrucțiunile, skillul te conduce prin pașii canonici: nume, scope, descrierea workflowului, apoi scrierea fișierului pe disk și verificarea lui.

Partea critică este câmpul description. El controlează auto-invocarea: îi spune lui Grok când skillul este relevant. Dacă descrierea este vagă, skillul poate fi perfect valid pe disk și totuși să nu fie declanșat. Frumos sicriu, mort prost identificat.

Vezi și All guides pentru celelalte ghiduri.

Când îmi folosește

Folosește create-skill când ai un workflow repetabil pe care vrei să-l transformi într-un skill reutilizabil.

Situații potrivite:

• repeți același prompt pentru deploy, testare, review, analiză sau alt proces recurent;
• vrei un slash command dedicat, de forma /<skill-name>;
• ai nevoie de un skill disponibil doar într-un proiect;
• vrei un skill disponibil global, în toate proiectele;
• ai un proces cu pași clari, reguli, gotchas și verificări finale.

Nu îl folosi ca să ascunzi acțiuni riscante sau autonome într-un prompt. Un skill este instrucțiune operațională pentru agent, nu permisiune nelimitată. Dacă workflowul atinge date sensibile, credențiale, publicare externă, ștergeri sau costuri, scrie explicit pașii de confirmare și limitele. Agentul trebuie să știe unde se oprește.

Cum îl invoc / declanșez

Skillul este folosit când utilizatorul vrea să creeze un skill, să scaffold-uiască un skill sau rulează:

/create-skill

Procesul este conversațional. Întrebările sunt puse una câte una, nu ca formular rigid:

1. numele skillului;
2. scope-ul: Project sau User;
3. ce trebuie să facă skillul.

Numele trebuie să respecte regulile canonice: litere mici a-z, cifre 0-9 și hyphen -; începe și se termină cu literă sau cifră; are între 2 și 64 de caractere. Exemplu valid:

deploy-k8s

Scope-urile sunt:

• Project — <repo-root>/.grok/skills/<name>/SKILL.md, disponibil doar în acel repo și potrivit pentru lucru partajat cu echipa;
• User — ~/.grok/skills/<name>/SKILL.md, disponibil în toate proiectele utilizatorului.

Default-ul este Project dacă ești într-un git repo, altfel User.

Exemplu practic

Să zicem că vrei un skill pentru un workflow de deploy.

Alegi numele:

deploy-k8s

Dacă lucrezi într-un repo și skillul este specific proiectului, alegi Project.

Apoi descrii workflowul: verifică branch-ul, rulează testele, construiește artefactul, aplică pașii de deploy și verifică rezultatul. Dacă există pași care cer aprobare umană, îi incluzi clar: de exemplu publicare, modificări ireversibile sau acces la date sensibile.

create-skill va propune o valoare pentru description. Aceasta trebuie să includă ce face skillul, trigger phrases și keywords, plus numele slash commandului, de exemplu: Use when the user runs /deploy-k8s.

Tu aprobi sau editezi descrierea înainte ca fișierul să fie scris. Nu trata acest pas ca decor. Este mecanismul de identificare.

Output / unde aterizează

Pentru Project, fișierul final este:

<repo-root>/.grok/skills/<name>/SKILL.md

Pentru User, fișierul final este:

~/.grok/skills/<name>/SKILL.md

Formatul obligatoriu pentru SKILL.md este:

---
name: <skill-name>
description: <the description from Step 2>
---
 
<markdown body with instructions, steps, code blocks>

Dacă skillul are nevoie de scripturi, se creează și:

<SKILL_DIR>/scripts/

Dacă are nevoie de documentație de referință:

<SKILL_DIR>/references/

După creare, utilizarea este comunicată astfel:

/<skill-name>
/skills <skill-name>

Grok îl poate invoca automat când descrierea se potrivește intenției utilizatorului.

Limite / gotchas

Nu sări peste crearea directorului. Fără director, fișierul poate eșua la salvare. Comanda canonică este:

mkdir -p <SKILL_DIR>

Folosește căi absolute când creezi fișiere, ca să nu scrii accidental în locul greșit.

Fișierul se creează prin metoda de creare disponibilă runtime-ului, folosind un old_string gol pentru search_replace, apoi se verifică prin:

cat <SKILL_DIR>/SKILL.md

Corpul din SKILL.md trebuie să fie concentrat și acționabil. Nu este documentație generală pentru oameni, ci prompt operațional pentru agent.

Preferă CLI-uri existente în loc să inventezi scripturi custom. Scripturile sunt utile, dar fiecare script nou este încă un mic animal care trebuie hrănit.

Skillurile ar trebui să apară în slash menu în câteva secunde, deoarece se auto-reîncarcă atunci când fișierele se schimbă pe disk.