Scrollcraft
Capitolul 2 din 15EN

Skilluri: ce sunt, unde le găsești, cum le instalezi.

Un skill e un folder cu instrucțiuni pe care AI-ul îl încarcă doar când sarcina se potrivește. E diferența dintre a cere un site frumos și a-ți vedea regulile respectate de fiecare dată.

Capitolul 2 din 155 min de citit

Ce vei învăța

La finalul capitolului
  1. 01Explici ce e un skill și cum descrierea lui decide când se încarcă.
  2. 02Găsești skilluri din surse de încredere și judeci unul înainte să-l instalezi.
  3. 03Instalezi un skill pentru unealta ta și verifici că se încarcă.
  4. 04Scrii un skill mic al tău, cu un fișier SKILL.md.

01 · Ce este un skill

a

Un folder cu un singur fișier obligatoriu

Un skill e un folder cu numele skillului. Singurul fișier obligatoriu e SKILL.md. Folderele opționale conțin referințe, șabloane și scripturi.

text
cinematic-scroll/
├── SKILL.md          obligatoriu: nume, descriere, instrucțiuni
├── references/       opțional: note mai lungi, citite doar la nevoie
├── assets/           opțional: șabloane și fișiere de copiat
└── scripts/          opțional: cod pe care AI-ul îl poate rula
b

Descrierea decide când se încarcă

AI-ul citește întâi numele și descrierea fiecărui skill și încarcă instrucțiunile complete doar când cererea ta se potrivește. O descriere vagă înseamnă că skillul nu pornește niciodată. Spune ce face și când să fie folosit, cu cuvintele pe care chiar le-ai scrie.

c

E un format deschis

Skillurile urmează specificația Agent Skills. Numele folosește litere mici, cifre și cratime (cel mult 64 de caractere) și trebuie să fie identic cu numele folderului. Descrierea poate avea până la 1.024 de caractere. Claude, Gemini CLI și Codex citesc toate această structură.

02 · Unde găsești skilluri

Citește-le înainte să le instalezi

Repository-ul Anthropic

Exemple funcționale pe care le poți citi și copia, printre ele brand-guidelines, internal-comms, pdf și skill-creator. github.com/anthropics/skills

Marketplace-ul de pluginuri Claude

În Claude Code, adaugi marketplace-ul oficial și instalezi din el. Comenzile sunt în secțiunea de instalare de mai jos.

skills.sh

Un director făcut de Vercel, cu clasament, teme, agenți compatibili și o secțiune de audituri. Oferă și instalatorul npx skills. skills.sh

Autorii de biblioteci

GSAP își publică propriile skilluri pentru pluginurile de animație. github.com/greensock/gsap-skills

Al tău

Cel mai de încredere skill e cel care îți conține regulile. Ultima secțiune a capitolului îți dă unul complet de copiat.

Un skill poate conține scripturi pe care AI-ul le rulează pe calculatorul tău. Deschide SKILL.md și orice fișier din scripts/ înainte să instalezi un skill de la cineva pe care nu-l cunoști. Preferă repository-urile oficiale și autorii cu istoric, iar un număr mare de instalări înseamnă popularitate, nu dovadă de siguranță.

03 · Instalează un skill

Pe platformă
A

Claude Code: copiezi un folder

Pune folderul skillului în folderul tău personal de skilluri ca să-l folosești în orice proiect, sau în proiect ca să-l împarți cu echipa. Claude Code urmărește aceste foldere, deci nu trebuie repornit.

bash
# personal
cp -r cinematic-scroll ~/.claude/skills/
# doar în proiect
mkdir -p .claude/skills && cp -r cinematic-scroll .claude/skills/

Îl rulezi cu /cinematic-scroll sau descrii o sarcină care se potrivește cu descrierea lui.

B

Claude Code: din marketplace

Pluginurile conțin skilluri. Adaugi o dată un marketplace, instalezi ce vrei, apoi reîncarci.

în Claude Code
/plugin marketplace add anthropics/claude-plugins-official
/plugin install skill-creator@claude-plugins-official
/reload-plugins
C

claude.ai: încarci o arhivă zip

Activează execuția de cod și crearea de fișiere, deschide secțiunea Skills din setări (documentația actuală o numește Customize, apoi Skills), alege Upload skill și selectează o arhivă zip. Arhiva trebuie să conțină chiar folderul skillului la primul nivel, iar numele folderului trebuie să fie identic cu numele skillului. Disponibil pe abonamentele Pro, Max, Team și Enterprise.

bash
zip -r cinematic-scroll.zip cinematic-scroll/
unzip -l cinematic-scroll.zip   # fiecare rând trebuie să înceapă cu cinematic-scroll/

Surse: Skilluri în Claude Code, Folosirea skillurilor în Claude, Crearea skillurilor proprii

Oricare

Un singur instalator pentru mulți agenți

Unealta npx skills descarcă un skill și îl leagă în folderul potrivit pentru agentul ales. Printre cei peste 27 de agenți compatibili sunt Claude Code, Gemini CLI, Codex, GitHub Copilot și Cursor.

bash
# toate skillurile dintr-un repository
npx skills add vercel-labs/agent-skills
# un singur skill
npx skills add vercel-labs/agent-skills --skill frontend-design
# pentru un singur agent
npx skills add vercel-labs/agent-skills -a codex
npx skills list

Sursă: o prezentare independentă a CLI-ului Vercel skills. Verifică documentația proiectului pentru opțiunile actuale.

04 · Skillurile pentru un site cinematic

Ce să cauți
RolCe să cauțiDe ce ajută
Direcție de designfrontend design, UI designÎndepărtează tipografia, culorile și layoutul de valorile implicite ale șabloanelor.
Rețeta de scrollcinematic scroll, scrollytelling, parallaxConține regulile pentru scroll lin, apariții și parallax, plus ce să eviți.
Biblioteca de animațieGSAP, ScrollTriggerFolosirea corectă a pluginurilor. GSAP și pluginurile lui sunt gratuite din 2025, vezi pagina de licență.
3D sau particulethree.js, shaders, WebGLConfigurarea scenei, puncte, shadere, interacțiune și performanță.
Calitateaccessibility review, skill creatorVerifică contrastul și folosirea de la tastatură și testează că propriul skill chiar pornește.

Chiar acest site a fost construit cu trei skilluri din setup-ul autorului: un skill artifact-design pentru regulile de layout și temă, un skill motion-design pentru principiile de easing și spring, și un skill cinematic-scroll-website pentru regulile Lenis, de apariție și de parallax. Este posibil ca aceste nume să nu existe în catalogul tău. Caută pe skills.sh cuvintele din tabel.

05 · Scrie-ți propriul skill

Copiază acest fișier

Dacă nu găsești un skill în care să ai încredere, scrie unul. Acesta e un skill complet pentru scroll cinematic. Salvează-l ca cinematic-scroll/SKILL.md, apoi instalează folderul cu oricare metodă de mai sus.

SKILL.md
---
name: cinematic-scroll
description: Construiește sau verifică un site modern și minimalist cu scroll cinematic: scroll lin cu inerție, hero cu parallax, apariții la scroll și un moment fixat. Folosește-l când utilizatorul cere un site cinematic, cu scrollytelling, parallax sau scroll lin.
---

# Scroll cinematic

## Reguli
1. Folosește Lenis pentru scroll lin și condu-l din requestAnimationFrame.
2. Hero-ul are două sau trei straturi de fundal cu data-speed între 0.15 și 0.5.
3. Fiecare secțiune de după hero stă în fluxul normal al documentului.
4. Conținutul apare o singură dată, cu opacitate și un translateY mic, când intră în ecran.
5. Cel mult o secțiune fixată pe pagină: scroll orizontal sau scrollytelling.
6. Nu folosi niciodată scroll-snap-type: y mandatory sau slide-uri pe tot ecranul.
7. Respectă prefers-reduced-motion: fără scroll lin, fără parallax, fără mișcare la apariție.
8. Nu inventa niciodată statistici, testimoniale sau logouri de clienți.

## Proces
1. Cere subiectul, publicul și acțiunea pe care trebuie s-o facă vizitatorul.
2. Propune lista de secțiuni și așteaptă aprobarea înainte să scrii cod.
3. Construiește cu HTML, CSS și JavaScript simple, în trei fișiere, dacă nu ți se spune altfel.
4. Servește prin HTTP, apoi verifică lățimile de 375, 768 și 1440 px.
5. Raportează ce ai testat și ce nu.
Test

Verifică dacă se încarcă

Întreabă AI-ul „Ce skilluri ai?” sau folosește /skills list în Gemini CLI. Apoi trimite o cerere care ar trebui să-l pornească, de exemplu „Construiește un site cu scroll lin și hero cu parallax”. Dacă nu pornește, rescrie descrierea cu cuvintele pe care le-ai folosit.

Practică · Lucrul cu AI

Aceeași sarcină, în unealta ta

Întreabă unealta ce știe deja, apoi las-o să-ți scrie primul skill, cât timp tu verifici fișierul.

Deschide un terminal în folderul proiectului și rulează claude. Apasă Shift+Tab până se pornește modul plan, lipește promptul, citește planul, apoi aprobă-l. Regulile proiectului stau în CLAUDE.md.

Ce skilluri sunt încărcate

Prompt
Listează skillurile pe care le poți folosi în această sesiune, cu un rând despre când se încarcă fiecare. Nu rula niciunul.

Scrie un skill

Prompt
Creează un skill numit scroll-motion-rules în .claude/skills/. SKILL.md are nevoie de un nume și de o descriere care spune că se aplică atunci când construiești sau verifici animații de scroll. Corpul listează regulile: animezi doar transform și opacity; fiecare efect are o variantă statică sub prefers-reduced-motion; ascunzi conținut doar sub o clasă .js; aparițiile urcă 24px în 0,9s cu cubic-bezier(.2,.7,.2,1), o singură dată. Arată-mi fișierul înainte să-l salvezi.

Practică · Exerciții

Încearcă, apoi compară
1

Rescrie o descriere

Deschide SKILL.md al unui skill instalat. Rescrie-i descrierea ca o singură propoziție care spune ce face și când trebuie să se încarce.

Indiciu: modelul citește doar descrierea ca să decidă dacă deschide restul.

Arată soluția

O descriere bună numește sarcina și cuvintele pe care le-ar folosi un om, de exemplu: „Construiește animații de scroll minimaliste. Folosește-l când adaugi apariții, parallax, secțiuni fixate sau scroll lin într-o pagină web.”

2

Fă-l să se încarce

Cere AI-ului o animație de apariție fără să-ți numești skillul. Verifică dacă a urmat regulile tale.

Indiciu: dacă nu, descrierea probabil nu se potrivește cu felul în care ai cerut.

Arată soluția

Întreabă „Ce skilluri ai folosit pentru asta?”. Dacă al tău lipsește, adaugă în descriere cuvintele pe care le-ai folosit de fapt (apariție, scroll, animație) și încearcă din nou într-o sesiune nouă.

3

Verifică înainte să instalezi

Alege un skill de la altcineva. Înainte să-l instalezi, citește fiecare fișier din folderul lui și notează orice n-ai vrea să facă.

Indiciu: nu te opri la SKILL.md: contează și scripturile, și fișierele de referință.

Arată soluția

Caută scripturi care rulează comenzi, cereri în rețea și instrucțiuni care n-au legătură cu descrierea. Un skill rulează cu permisiunile uneltei tale, așa că instalează doar ce ai citit și ai înțeles.

Practică · Proiectul cursului

Un site, construit pe tot parcursul

Dă proiectului cursului propriile reguli de mișcare, ca fiecare pas de mai târziu să le urmeze fără să i le amintești.

  1. Instalează un skill de design din secțiunea 04 pentru unealta ta.
  2. Adaugă în proiect propriul skill scroll-motion-rules, cu fișierul de mai jos.
  3. Întreabă AI-ul ce skilluri ar folosi ca să construiască hero-ul pentru [subiect] și păstrează răspunsul în notes.md.
SKILL.md
---
name: scroll-motion-rules
description: Reguli pentru animațiile de scroll din acest site. Folosește-l când adaugi sau verifici apariții, parallax, secțiuni fixate sau scroll lin.
---

# Reguli de mișcare la scroll

- Animezi doar transform și opacity.
- Fiecare efect are o variantă statică sub prefers-reduced-motion.
- Ascunzi conținut doar sub o clasă .js, ca nimic să nu se piardă dacă un script pică.
- Aparițiile urcă 24px în 0,9s cu cubic-bezier(.2, .7, .2, 1), o singură dată.

Practică · Testează

Verifici rezultatul
  • Folderul skillului conține un SKILL.md cu nume și descriere în frontmatter.
  • Întrebat ce skilluri poate folosi, AI-ul numește scroll-motion-rules.
  • O apariție scrisă de el animă doar transform și opacity și are o regulă pentru mișcare redusă.

Practică · Evaluare

Criterii de acceptare

0 din 4 criterii îndeplinite

Urmează Prompturi

Un brief în cinci părți, un exemplu înainte și după, un fișier cu regulile proiectului și șase tipare de ghidare.

Scurtături de tastatură: [ capitolul anterior · ] capitolul următor