Scrierea Skill-urilor

Ce face

Skill-ul aplică Test-Driven Development la documentația de proces. Scrii mai întâi scenarii de presiune cu subagenti, vezi cum agentul încalcă regulile (baseline), apoi redactezi skill-ul (SKILL.md) și verifici că testele trec. Principiul de bază: dacă nu ai văzut agentul eșuând fără skill, nu știi dacă skill-ul învață exact ce trebuie. Skill-urile personale stau în directoarele specifice agentului (~/.claude/skills pentru Claude Code, ~/.agents/skills/ pentru Codex).

Când îmi folosește

Îl folosești când creezi skill-uri noi, editezi skill-uri existente sau verifici că funcționează înainte de deploy. Creezi skill când tehnica nu e intuitivă, o vei refolosi în mai multe proiecte sau alții ar beneficia de ea. Nu-l folosi pentru soluții unice, practici deja documentate bine sau reguli mecanice ce pot fi automatizate cu regex sau validare.

Cum îl invoc / declanșez

verifică doctrina pentru detalii exacte. Procesul urmează ciclul RED-GREEN-REFACTOR: rulezi scenariul de baseline înainte de a scrie skill-ul, notezi raționalizările agentului, scrii documentația minimă care rezolvă exact acele încălcări, apoi retestezi.

Exemplu practic

Vrei un skill despre „condition-based-waiting”. Rulezi un subagent pe un task cu timeout-uri fixe și vezi cum alege valori arbitrare. Documentezi pașii: „așteaptă până când condiția X e adevărată, verifică la fiecare 2s, max 30s”. Rulezi din nou subagentul cu skill-ul prezent și confirmi că respectă regula. Dacă găsește o portiță (de exemplu „dar dacă timeout-ul e mic…”), închizi gaura și re-verifici.

Output / unde aterizează

Skill-ul devine un fișier SKILL.md în directorul agentului respectiv. El devine referință reutilizabilă pentru instanțe viitoare Claude sau Codex și apare în lista de skill-uri disponibile.

Limite / gotchas

Nu crea skill-uri pentru convenții specifice unui singur proiect (alea merg în CLAUDE.md). Skill-urile trebuie să fie tehnici, pattern-uri sau referințe, nu povești despre cum ai rezolvat o problemă o dată. Dacă skill-ul nu trece testul după scriere, înseamnă că ai omis o raționalizare sau ai scris prea abstract. All guides