Claude Skills: cum creezi un skill de la zero (exemplu real)

Articolul acesta exista pentru ca un Claude Skill a facut cea mai mare parte din munca: a cautat articolele conexe de pe blog, a citit rezultatele Google, a verificat ca titlul e unic, a scris ciorna dupa regulile mele SEO si a incarcat-o in CMS prin serverul meu MCP. Eu am ales subiectul si am recitit textul.

Nu e magie, e un fisier Markdown de vreo suta de randuri. De cand l-am scris a produs peste 150 de articole cu acelasi proces, mereu in aceeasi ordine, fara sa-i explic de fiecare data cum lucrez.

In acest ghid iti arat exact cum se creeaza un skill: ce sunt Claude Skills, cum arata un SKILL.md, cand merita sa-l folosesti in locul unui server MCP sau al unui subagent, si iti arat codul skill-ului real pe care il folosesc in productie. La final gasesti greselile pe care le-am facut eu, ca tu sa le sari.

Ce sunt Claude Skills

Claude Skills sunt foldere cu instructiuni pe care Claude le incarca singur atunci cand recunoaste ca o sarcina il priveste. Fiecare skill contine un fisier SKILL.md cu un antet (nume si descriere) si instructiunile operative; poate include si scripturi, template-uri si documente de referinta.

Diferenta fata de un prompt salvat sta in mecanismul de incarcare, pe care Anthropic il numeste progressive disclosure:

• La pornire Claude citeste doar numele si descrierea fiecarui skill: cateva zeci de tokeni fiecare.
• Cand e nevoie incarca corpul SKILL.md, adica instructiunile complete.
• Doar daca trebuie deschide fisierele de suport (referinte, scripturi, exemple).

Rezultat: poti avea zeci de skill-uri instalate fara sa incarci fereastra de context. Skill-urile urmeaza standardul deschis Agent Skills, deci acelasi SKILL.md merge in Claude Code, in Claude.ai si Cowork, in Agent SDK si in unelte compatibile precum Codex, Gemini CLI si OpenCode. Scrii o data, folosesti peste tot.

Skill, CLAUDE.md, MCP sau subagent: ce alegi

Regula scurta: CLAUDE.md ii spune lui Claude cine esti, un skill ii spune cum sa faca o sarcina, un server MCP ii da acces la date si sisteme externe, un subagent izoleaza o munca lunga intr-un context separat. In practica se combina.

Unealta	Ce face	Cand o folosesti
CLAUDE.md	Context persistent incarcat in fiecare sesiune	Conventiile proiectului, stack, reguli mereu valabile
Skill	Procedura repetabila incarcata la cerere	Sarcini pe care le repeti des, cu un output precis
Server MCP	Tool-uri care citesc/scriu in sisteme externe	CMS, baze de date, CRM, API, Search Console, e-Factura
Subagent	Executie intr-un context separat	Cercetari lungi, sarcini paralele, output voluminos

Pipeline-ul meu editorial le foloseste pe toate patru: CLAUDE.md cunoaste brandul, skill-ul orchestreaza pasii, serverul MCP mcp.cosimo.dev expune tool-urile CMS-ului si ale Search Console, iar analiza concurentei ruleaza intr-un subagent. Despre partea de MCP si agenti scriu constant pe pagina dedicata agentilor AI pentru afaceri.

Anatomia unui SKILL.md

Un SKILL.md este un fisier Markdown cu un antet YAML. Campurile care conteaza cu adevarat sunt doua: name (maxim 64 de caractere) si description (maxim 200 de caractere). Claude Code e permisiv, dar Skills API valideaza aceste limite: respecta-le de la inceput si nu va trebui sa rescrii nimic.

Structura tipica a unui folder de skill:

creeaza-articol/
├── SKILL.md          # obligatoriu: frontmatter + instructiuni
├── references/       # optional: reguli SEO, brand, exemple
│   └── seo-rules.md
├── scripts/          # optional: scripturi executabile
│   └── check-slug.py
└── templates/        # optional: schelete de output
    └── outline.md

Trei reguli de forma pe care Anthropic le recomanda si pe care le confirm din experienta:

• Sub 500 de randuri. Daca SKILL.md creste, muta detaliile in references/ si fa link catre ele.
• Description care spune ce face SI cand se foloseste. E singurul text pe care Claude il citeste ca sa decida daca activeaza skill-ul.
• Instructiuni la imperativ si numerotate. Claude urmeaza o lista de verificare mai bine decat un discurs.

Skill-urile pot sta la nivel de proiect (.claude/skills/nume/SKILL.md) sau global (~/.claude/skills/). Cele de proiect intra in repository, ca toata echipa sa le foloseasca. Daca ai deja comenzi in .claude/commands/, afla ca slash command-urile au devenit skill-uri: aceeasi comanda /nume, mai multe capabilitati.

Cum creezi un Claude Skill in 5 pasi

Iata procesul pe care il urmez, cu skill-ul real crea-articolo ca exemplu. Il poti replica pentru orice sarcina repetitiva.

1. Alege o sarcina pe care o repeti macar o data pe saptamana

Nu porni de la skill-ul "perfect". Porneste de la munca ce te plictiseste. Pentru mine era: cautat articole conexe, analizat rezultatele Google, scris dupa 20 de reguli SEO, incarcat ciorna, rulat scoringul. Cinci actiuni, mereu aceleasi, mereu in aceeasi ordine.

2. Descrie procesul cu voce tare, apoi foloseste skill-creator

In Claude Code lanseaza /skill-creator. E un skill oficial care te intervieveaza: ce trebuie sa faca, cand sa se activeze, daca are nevoie de scripturi. Genereaza folderul si un frontmatter deja valid. E cel mai rapid mod sa nu gresesti descrierea.

3. Scrie frontmatter-ul ca pe un anunt de angajare

Acesta e frontmatter-ul skill-ului meu, simplificat:

---
name: crea-articolo
description: Orchestrator end-to-end pentru un articol gata de
  publicare pe cosimo.dev. Foloseste-l cand utilizatorul spune
  "creeaza articol", "articol nou", "scrie un articol despre X".
---

Observa frazele declansatoare intre ghilimele: sunt cuvintele pe care le spun cu adevarat. Cu cat descrierea seamana mai mult cu felul in care vorbesti, cu atat Claude o activeaza la momentul potrivit.

4. Scrie corpul ca pe o procedura, un pas o data

Corpul skill-ului meu e o secventa numerotata. Fiecare pas apeleaza un tool MCP specific si salveaza un output intermediar:

# Procedura (executa in ordine, un pas o data)

## Pasul 0 - Duplicate si articole conexe
Apeleaza `cerca_articoli_per_keyword` si `get_articoli_correlati`.
Daca exista un articol foarte asemanator, opreste-te si propune
actualizare sau un unghi diferit.

## Pasul 1 - SERP si concurenta (obligatoriu)
Apeleaza `serp_google` si `brief_pre_scrittura`.
Analizeaza primele 5 rezultate: lungime, H2, FAQ, puncte slabe.
Defineste strategia de depasire.

## Pasul 2 - Cuvinte cheie si titlu
Cuvant cheie principal (2-4 cuvinte) + 3-5 secundare.
Max 60 de caractere. Verifica cu `verifica_titolo_unico`.
Cere confirmarea utilizatorului.

## Pasul 3 - Structura
4-8 H2, FAQ (3-7), sectiune practica, CTA.

## Pasul 4 - Scriere
Minim 1.500 de cuvinte. Cuvantul cheie in primul paragraf,
intr-un H2 si in concluzie. 3-7 link-uri interne.

## Pasul 5 - Publica in CIORNA
Apeleaza `create_articolo` cu stare ciorna. Niciodata direct.

## Pasul 6 - Scoring
Apeleaza `analizza_seo_articolo`. Tinta 95/100.
Maxim 3 iteratii, apoi raporteaza utilizatorului.

Doua detalii care fac diferenta: pasul 0 poate opri procesul (un skill trebuie sa stie cand sa nu continue) si pasul 5 forteaza starea ciorna (ultimul click ramane uman).

5. Testeaza cu trei cereri diferite si masoara

Incearca skill-ul cu o cerere explicita ("creeaza articol despre X"), una implicita ("am nevoie de un text despre Y") si una in afara tintei ("corecteaza footer-ul"). In primele doua trebuie sa se activeze, in a treia nu. Apoi compara output-ul cu ce ai fi facut manual. Daca trebuie sa corectezi mereu acelasi lucru, corectia aceea intra in SKILL.md.

Cazul real: pipeline-ul cosimo.dev

Skill-ul singur nu ar fi de ajuns: are nevoie de maini. Mainile sunt tool-urile serverului meu MCP, care expune modelului circa 90 de functii: articole si categorii din CMS, Search Console, Analytics, SerpApi pentru SERP si Google Trends, PageSpeed, feed-uri de stiri tech. Skill-ul decide ce sa faca si in ce ordine; MCP-ul face cum.

Concret, cand scriu "creeaza articol", se intampla asta:

• Search Console imi spune pe ce cautari creste deja blogul.
• Google Trends imi spune ce explodeaza acum (cautarea "claude skills" era in crestere masiva si in Romania cand am scris textul asta).
• SERP-ul imi spune cine e pe prima pagina si ce le lipseste. In Romania, pentru acest subiect, nu exista inca niciun tutorial in limba romana.
• CMS-ul primeste ciorna deja cu FAQ, schema HowTo, meta description si link-uri interne.

Construirea a durat cateva saptamani. Intretinerea costa zece minute cand schimb o regula: modific un fisier Markdown, nu o aplicatie. E acelasi principiu pe care il aplic cand construiesc aplicatii web si automatizari pentru firme: logica de business trebuie sa fie lizibila de cel care o foloseste.

7 greseli de evitat cand creezi un skill

• Descriere generica. "Ajuta cu articolele" nu se activeaza niciodata. "Foloseste-l cand utilizatorul spune: creeaza articol" da.
• SKILL.md monolitic. Peste 500 de randuri Claude pierde firul. Muta regulile de detaliu in references/.
• Date scrise in cod. Preturi, nume de clienti, URL-uri se schimba: pune-le intr-un fisier separat sau da-le ca input.
• Nicio conditie de oprire. Un skill care merge mereu inainte produce duplicate si pagube. Prevede cazurile in care trebuie sa se opreasca si sa intrebe.
• Actiuni ireversibile automate. Publicare, trimitere, stergere: lasa mereu ultimul pas unui om.
• Skill-uri instalate orbeste. Un skill poate contine scripturi. Citeste ce executa inainte sa-l instalezi dintr-un marketplace.
• Niciun test de ne-activare. Un skill care porneste cand nu trebuie e la fel de enervant ca unul care nu porneste niciodata.

Ce poate automatiza un IMM din Romania cu Claude Skills

Skill-urile nu sunt doar pentru cei care scriu cod. In Claude Cowork aceleasi foldere devin proceduri de firma pe care oricine din birou le poate lansa. Cateva exemple pe care le-am construit sau evaluat cu clienti:

• Oferte de pret: un skill care citeste lista de preturi, aplica regulile de discount si produce PDF-ul in formatul firmei, in lei sau euro.
• Email-uri comerciale: raspunsuri in tonul patronului, cu informatii luate din ERP prin MCP.
• Rapoarte saptamanale: vanzari, comenzi si stocuri intr-un document gata luni dimineata.
• Pregatire facturi: verificarea campurilor obligatorii inainte de trimiterea in e-Factura, ca sa nu primesti respingeri de la ANAF.
• Continut: postari pentru social media si newsletter pornind de la noutatile din catalog.

Modelul e mereu acelasi: un skill care descrie cum face firma acel lucru, un MCP care leaga datele reale, un om care aproba. Daca vrei sa vezi ce inseamna concret pentru afacerea ta, pe pagina de automatizari AI pentru firme gasesti scenarii si preturi orientative.

Concluzie: primul tau skill intr-o dupa-amiaza

Claude Skills sunt cel mai ieftin mod pe care il cunosc de a transforma un model generic intr-un colaborator care lucreaza ca tine. Un fisier Markdown, o descriere scrisa bine, o procedura numerotata. Restul il inveti construind-o.

Daca ai un proces repetitiv in firma si vrei sa afli daca un skill (cu sau fara MCP) il poate prelua, scrie-mi: iti spun intr-un apel daca are sens si cat costa. Daca esti developer, deschide terminalul, lanseaza /skill-creator si descrie lucrul pe care l-ai facut de trei ori saptamana asta.