Ako svaki developer u timu svaki dan ponavlja Claude Codeu iste upute, problem nije u alatu nego u procesu. "Koristi naše naming konvencije", "testovi idu ovako", "ne diraj migracije bez reviewa" - sve su to timska pravila koja ne bi smjela ostati samo u nečijoj glavi ili u historyju jedne sesije.
Claude Code skills su praktičan način da se ponavljive upute pretvore u verzionirani workflow. Ne rješavaju sve, ali jako dobro rješavaju dosadan i važan problem: kako AI alatu dati isti standard svaki put.
Skill nije dugačak prompt
Loš skill je dokument u koji ste natrpali sve i svašta o projektu. Dobar skill je usko definiran: kada se koristi, koji input očekuje, koje korake agent smije poduzeti, što mora provjeriti i kakav output treba vratiti.
--- name: api-endpoint-review description: Koristi kada treba pregledati backend API endpoint prije mergea. --- Check: - request validation - auth and authorization - error handling - test coverage - logging and observability Return prioritized findings with file:line references.
Ovakav skill ima jasnu granicu. Ne pokušava biti "naš cijeli engineering proces", nego jedan review zadatak koji se ponavlja.
Gdje skills najviše pomažu
Dobri kandidati
- code review checkliste
- generiranje API endpointa po lokalnom standardu
- priprema migracija uz sigurnosna pravila
- pisanje release notesa iz diff-a
- debugging workflow za poznate tipove problema
Loši kandidati
- preširoke upute tipa "piši bolji kod"
- pravila koja nitko u timu ne provodi
- workflowi koji zahtijevaju produkcijske ovlasti bez kontrole
- dokumentacija koja se ne održava s codebaseom
Timski skills trebaju živjeti u repozitoriju
Osobni skills su korisni za individualne navike, ali pravi pomak je kad projektni skills stoje uz codebase. Tada se reviewaju u pull requestovima, mijenjaju zajedno s arhitekturom i postaju dio onboarding materijala.
To je važna razlika: AI workflow postaje dio engineeringa, a ne privatni štos jednog developera. Kada se promijeni standard za testiranje ili deploy, mijenja se i skill.
Skills nisu zamjena za specifikaciju
Skill definira kako raditi. Specifikacija definira što se gradi i zašto. Najbolje rezultate dobijete kad kombinirate oboje: spec-driven pristup daje modelu jasan problem, a skill mu daje timske standarde za implementaciju.
Ako vas zanima taj dio, povezana tema je spec-driven development i AI. Skills i specifikacije se nadopunjuju u ozbiljnom AI-assisted developmentu.
Zaključak
Claude Code skills imaju smisla kada uklanjaju ponavljanje i drže standard. Ako ih pišete kao kratke, uske i održavane workflowe, mogu ozbiljno poboljšati konzistentnost AI outputa u timu.
Ako ih koristite kao mjesto za sve moguće upute, samo ste stvorili novi oblik dokumentacije koju nitko ne čita. Kao i kod svakog engineering procesa, vrijednost je u jasnoći, granicama i tome da se redovito održavaju.
Josip Budalić
HOTFIX tim
Josip vodi HOTFIX d.o.o. i radi na software arhitekturi, AI-assisted development workflowima, modernizaciji codebasea i praktičnoj isporuci softwarea.