📚 Rezumate video · simpluspv.eu Automatizări cu AI · Cursul de AI
Rezumat YouTube

Claude Skills Explained in 23 Minutes

📺 Shaw Talebi ⏱️ 23:32 🗣️ Sursă: engleză (auto) ⚠️ Transcriere generată automat
▶ Deschide pe YouTube
Rezumat

Shaw Talebi explică funcția skills din Claude — instrucțiuni reutilizabile, împachetate, pe care Claude le accesează automat când sunt relevante (pe web, desktop sau în Claude Code). Premisa: cu cât instrucțiunile sunt mai clare, cu atât rezultatele sunt mai bune. În loc să rescrii prompturi de fiecare dată sau să copiezi din Notion/Google Docs, scrii instrucțiunile o singură dată ca skill, iar Claude alege singur skill-ul potrivit.

Structură: un folder cu numele skill-ului, conținând fișierul skill.md. Acesta are metadata (name + description) și body (un prompt în markdown). Limite: name max 64 de caractere, description max 1.024, iar body până la ~5.000 de tokeni. Mecanismul-cheie este progressive disclosure, cu trei niveluri de încărcare în context: (1) metadata din skill.md — injectate la pornire, ~100 de tokeni; (2) body — citit doar când skill-ul e invocat, până la 5.000 de tokeni; (3) fișiere și foldere adiționale (ex. research-methodology.md, organizate în subfoldere) plus scripturi — citite la nevoie, practic fără limită. Skill-ul poate referenția alte fișiere .md și poate include scripturi Python/JavaScript, fiindcă Claude rulează într-un mediu virtual cu shell bash, Python și NodeJS (ex. python scripts/foo.py). Astfel poți avea sute/mii de skill-uri cu impact minim pe context.

Skills vs MCP: ambele oferă instrucțiuni și tools, dar skills funcționează doar cu Claude, în timp ce MCP e standard deschis universal (orice LLM, orice aplicație). MCP încarcă din start toate metadatele tool-urilor (ex. serverul Notion ~20.000 de tokeni), pe când un skill Notion ar ocupa ~100 — două ordine de mărime economisite. Caz principal: skills = a învăța Claude să-și folosească mai bine tool-urile existente; MCP = acces la tools și integrări complexe (unde scrierea unui skill ar cere lucru cu API-ul).

Sub-agenți (Claude Code): agenți specializați cu propriul context window; văd toate skill-urile preîncărcate și li se pot atribui servere MCP specifice (ex. context7 pentru documentație) — utili ca să faci research fără să umfli contextul agentului principal.

Exemplu concret: un skill „AI tutor" care explică în limbaj simplu. Conține skill.md (metadata + body cu tehnici de prompt engineering, ~130 de linii), un research-methodology.md referențiat condiționat (~200 de linii) și un folder scripts cu un script Python care extrage transcrieri YouTube (libraria youtube-transcript-api, rulat prin uv run). Skill-urile stau în ~/.claude/skills/<nume>. În demo: la „explain reinforcement learning in simple terms", Claude folosește skill-ul fără să i se ceară explicit, „gândește" întâi (instrucțiunea cere explorarea mai multor narațiuni) și aplică structura status quo → problemă → soluție → exemplu → de ce contează. La „explain GRPO, do research", citește research-methodology.md și folosește web search (inclus nativ), apoi testează tool-ul de transcript YouTube. Autorul a construit skill-ul conversând cu Claude în browser, cu ~6 runde de feedback; codul e pe GitHub.

≈ 436 cuvinte
Capitole
  1. 1 00:00

    Ce sunt skill-urile și de ce contează

    Skill-urile sunt instrucțiuni reutilizabile, împachetate, accesate automat de Claude (pe web, desktop sau Claude Code) când sunt relevante.

    • Faptul fundamental despre LLM-uri: instrucțiuni mai clare → rezultate mai bune.
    • Alternativa obositoare: rescrii prompturi de fiecare dată sau copiezi din Notion/Google Docs.
    • Cu skills: scrii instrucțiunile o singură dată, iar Claude alege singur skill-ul potrivit din toate cele disponibile.
  2. 2 02:42

    Structura unui skill: folder + skill.md

    Implementarea e foarte simplă: un folder cu numele skill-ului, conținând un fișier skill.md.

    • Metadata: name + description. Limite — name ~64 de caractere, description ~1.024 de caractere.
    • Body: un prompt în markdown cu instrucțiunile specializate, până la ~5.000 de tokeni.
    • La pornirea conversației, doar metadata (scurtă) intră în context, nu și body-ul.
  3. 3 04:49

    Fișiere/foldere adiționale și scripturi ca tools

    Un skill poate fi mai mult decât un singur skill.md.

    • Poți adăuga fișiere .md suplimentare (ex. how-to-x.md) referențiate din body și citite la nevoie.
    • Poți organiza informația în subfoldere (ex. how-to pentru X, Y, Z).
    • Poți include scripturi (folder scripts): Claude rulează într-un mediu virtual cu shell bash, Python și NodeJS, deci poate executa python scripts/foo.py.
  4. 4 06:41

    Progressive disclosure: cele 3 niveluri de context

    Conceptul-cheie de la Anthropic: conținutul intră în context doar când e nevoie, pas cu pas.

    • Nivel 1 — metadata din skill.md, încărcate la pornire (~100 de tokeni).
    • Nivel 2 — body-ul skill.md, încărcat când skill-ul e invocat (până la 5.000 de tokeni).
    • Nivel 3 — fișierele și folderele din directorul skill-ului, citite la nevoie, practic fără limită de volum. Rezultat: management mai bun al contextului fără a sacrifica capabilități.
  5. 5 09:51

    Skills vs MCP: diferențele

    Ambele oferă tools și instrucțiuni și au suprapunere funcțională, dar diferă esențial:

    • Skills funcționează doar cu Claude; MCP e un standard deschis universal (orice LLM ↔ orice aplicație).
    • MCP încarcă din start toate metadatele tool-urilor (serverul Notion ≈ 20.000 de tokeni); un skill Notion ar ocupa ≈ 100 de tokeni — economie de două ordine de mărime, datorită progressive disclosure.
  6. 6 11:36

    Skills vs MCP: cazuri de utilizare

    • Caz principal pentru skills: a învăța Claude cum să folosească mai bine tool-urile pe care le are deja (native sau din MCP-uri existente).
    • Caz principal pentru MCP: a oferi acces la tools și integrări complexe. Pentru ceva precum Notion, un server MCP gata făcut e preferabil construirii unui skill de la zero (ar cere lucru cu API-ul).
  7. 7 12:22

    Integrarea cu sub-agenții din Claude Code

    Sub-agenții (feature din Claude Code) sunt agenți specializați cu propriul context window — exact valoarea lor principală.

    • Agentul principal conține tot: tools default, system prompt, mesaje, plus metadata skill-urilor și serverele MCP preîncărcate.
    • Exemplu: pentru a cerceta libraria fast HTML, pornești un sub-agent cu propriul context și un MCP specific (ex. context7 pentru documentație actualizată), care întoarce doar rezultatul — fără să umfli contextul principal.
    • Sub-agentul vede toate skill-urile preîncărcate; îi atribui doar MCP-urile necesare.
  8. 8 15:14

    Exemplu: skill-ul „AI tutor" (structura)

    Un skill care explică concepte tehnice în limbaj simplu, cu trei piese:

    • skill.md — metadata (name „AI tutor", description „Use when user asks to explain… technical concepts…") + body cu tehnici de prompt engineering.
    • research-methodology.md — referențiat condiționat din skill.md („If a concept is unfamiliar or requires research, load research-methodology.md").
    • Folder scripts — tool Python care extrage transcrieri YouTube; referențiat din research-methodology.md (acolo unde e relevant). Codul e pe GitHub.
  9. 9 17:19

    Demo: fișierele reale și setup-ul

    Autorul deschide folderul real în Cursor și arată structura efectivă.

    • Skill-urile stau în home directory: ~/.claude/skills/<nume> (verificat cu pwd).
    • skill.md ≈ 130 de linii, research-methodology.md ≈ 200 de linii — separarea ajută, fiindcă nu orice întrebare cere research (ex. rețele neuronale, gradient descent sunt deja în pre-training).
    • Dependențele scriptului (libraria youtube-transcript-api) sunt gestionate cu UV (uv run), ca să evite probleme de dependențe.
  10. 10 20:41

    Demo live: explicații, research și transcript + concluzie

    • La „explain reinforcement learning in simple terms", Claude invocă singur skill-ul și „gândește" întâi (instrucțiunea îi cere să exploreze mai multe narațiuni înainte de a răspunde), aplicând structura status quo → problemă → soluție → exemplu → de ce contează.
    • La „explain GRPO, do research", citește research-methodology.md și folosește web search (inclus nativ în Claude Code/desktop), apoi rulează tool-ul de transcript YouTube ca test.
    • Autorul a construit întreg skill-ul conversând cu Claude în browser (~6 runde de feedback). Tot codul e pe GitHub (link în descriere).
Toate rezumatele · simpluspv.eu — automatizări cu AI și cursuri pentru firme.