Skip to content

Self-hosted monitoring for homelabs: host and container metrics and uptime checks from all your machines in one dashboard, with an optional AI agent that diagnoses incidents and suggests fixes.

feat(skills): added claude skills to enhance development, going to make further improvements in the future

karloks20052d8bb1e9a95a
diff --git a/.claude/skills/code-simplicity/code-simplicity.md b/.claude/skills/code-simplicity/code-simplicity.md
new file mode 100644
index 0000000..3e525a5
--- /dev/null
+++ b/.claude/skills/code-simplicity/code-simplicity.md
@@ -0,0 +1,49 @@
+---
+name: code-simplicity
+description: Koristi kad treba napisati, dodati ili izmijeniti kod, a postoji rizik od prekomjerne složenosti: nepotrebnih apstrakcija, slojeva, konfiguracijskih opcija, dodatne "proširivosti", pretjerane obrade grešaka ili nezatraženih testova, logiranja i dokumentacije. Ne koristi za sigurnosne revizije (za to je security-audit).
+---
+
+# Pojednostavljenje koda
+
+Cilj je najmanji kod koji ispravno rješava zadatak i lako se čita i mijenja. Kraći kod koji radi bolji je od dužeg koji je "robustniji", ali nepotrebno složen.
+
+## Pravila
+
+1. **Apstrakcije tek kad ih zadatak traži.** Ne uvodi apstraktne klase, sučelja, tvorničke funkcije, strategije ni slojeve za nešto što se koristi na jednom mjestu. Ponavljanje dvaju-triju redaka obično je bolje od prerane apstrakcije.
+2. **Bez nezatraženih parametara i opcija.** Ne dodaji konfiguraciju, zastavice ni parametre za scenarije koje nitko nije spomenuo.
+3. **Obrada grešaka samo za stvarne ulaze.** Validiraj podatke koji dolaze izvana (korisnik, datoteka, mreža, API). Ne brani se od stanja koja se u kontekstu zadatka ne mogu dogoditi.
+4. **Bez dodataka koji nisu tražени.** Ne dodaji logiranje, testove, dokumentaciju ni README izmjene osim ako su tražene. Komentar samo tamo gdje nešto nije očito iz koda.
+5. **Ne mijenjaj ono što nije dio zadatka.** Ako vidiš prostor za poboljšanje u susjednom kodu, spomeni ga u odgovoru, ali ga ne diraj.
+6. **Složenija struktura zahtijeva objašnjenje.** Ako misliš da je potreban veći dizajn, prvo kratko objasni zašto i pitaj, pa tek onda piši.
+
+## Provjera prije predaje
+
+Prije nego predaš kod, pročitaj ga i pitaj se:
+- Mogu li ukloniti sloj, klasu ili funkciju a da ponašanje ostane isto?
+- Postoji li parametar, grana ili provjera koja ne odgovara nijednom stvarnom slučaju?
+- Je li naziv dovoljno jasan da komentar nije potreban?
+
+Ako je odgovor "da" na bilo koje od prva dva pitanja, skrati.
+
+## Primjer
+
+Zadatak: "Napiši funkciju koja vraća zbroj cijena u košarici."
+
+Preopširno:
+```python
+class PriceCalculator:
+ def __init__(self, strategy=None, currency="EUR", rounding=2):
+ ...
+ def calculate(self, items):
+ ...
+```
+
+Dovoljno:
+```python
+def total(items):
+ return sum(item.price for item in items)
+```
+
+## Izuzeci
+
+Složenost je opravdana kad zadatak to izričito traži, kad kod ide u veći sustav s jasno definiranim sučeljima, ili kad postojeći kod u projektu već koristi određeni obrazac. U tom slučaju prati postojeći obrazac, a ne uvodi novi. Ako nisi siguran, pitaj korisnika.
\ No newline at end of file
diff --git a/.claude/skills/minimal-diff/minimal-diff.md b/.claude/skills/minimal-diff/minimal-diff.md
new file mode 100644
index 0000000..a54b3b2
--- /dev/null
+++ b/.claude/skills/minimal-diff/minimal-diff.md
@@ -0,0 +1,22 @@
+---
+name: minimal-diff
+description: Koristi kad treba izmijeniti postojeći kod, popraviti grešku ili dodati manju funkcionalnost u postojeću bazu. Ne koristi za pisanje novog koda od nule (za to je code-simplicity).
+---
+
+# Minimalne izmjene postojećeg koda
+
+Mijenjaj samo ono što je potrebno za zadatak.
+
+## Pravila
+
+1. **Prvo pročitaj okolni kod** i prati njegov stil, nazive i obrasce, čak i ako bi ti drugačije izgledao.
+2. **Ne preuređuj susjedni kod.** Bez preimenovanja, premještanja, reformatiranja ili "čišćenja" koje nije dio zadatka.
+3. **Ne dodaji promjene koje nisu tražene**, uključujući popravke tuđih grešaka koje nisu u opsegu zadatka. Spomeni ih u odgovoru.
+4. **Drži diff malim.** Ako izmjena zahtijeva više od očekivanog, zaustavi se i objasni zašto prije nastavka.
+5. **Ne mijenjaj javna sučelja** (potpise funkcija, API odgovore, nazive polja) bez izričitog dopuštenja.
+
+## Provjera prije predaje
+
+- Je li svaka promijenjena linija potrebna za zadatak?
+- Je li stil u skladu s okolnim kodom?
+- Ako sam nešto primijetio izvan opsega, jesam li to spomenuo, a ne promijenio?
\ No newline at end of file
diff --git a/.claude/skills/simplify-existing-code.md/simplify-existing-code.md b/.claude/skills/simplify-existing-code.md/simplify-existing-code.md
new file mode 100644
index 0000000..1e495cb
--- /dev/null
+++ b/.claude/skills/simplify-existing-code.md/simplify-existing-code.md
@@ -0,0 +1,26 @@
+---
+name: simplify-existing-code
+description: Koristi kad treba pojednostaviti postojeći kod koji je prekomplikiran: ukloniti nepotrebne apstrakcije, slojeve, nekorištene parametre ili mrtvi kod, a da se ponašanje ne promijeni. Ne koristi za pisanje novog koda (code-simplicity) ni za male ciljane popravke (minimal-diff).
+---
+
+# Pojednostavljenje postojećeg koda
+
+Cilj je manje koda uz isto ponašanje. Prije nego što išta mijenjaš, moraš razumjeti što kod radi.
+
+## Postupak
+
+1. **Utvrdi ponašanje.** Pročitaj kod i kratko opiši što radi, uključujući rubne slučajeve. Ako postoje testovi, pokreni ih prije izmjena i zabilježi rezultat.
+2. **Traži kandidate za uklanjanje:** apstraktne klase s jednom implementacijom, wrapper funkcije koje samo prosljeđuju poziv, parametri koji se uvijek dobivaju istu vrijednost, grane koje se nikad ne izvršavaju, nekorištene funkcije (provjeri pretragom po projektu prije brisanja).
+3. **Mijenjaj u malim koracima.** Jedna vrsta pojednostavljenja po koraku, nakon čega provjeri testove ili ponašanje.
+4. **Ne diraj javna sučelja** koja koriste drugi dijelovi sustava, osim ako je to dio dogovorenog zadatka.
+5. **Sačuvaj prijašnje ponašanje u iznimkama i rubnim slučajevima.** Pojednostavljenje ne smije tiho promijeniti poruke grešaka, redoslijed obrade ili tipove povratnih vrijednosti.
+
+## Što ne raditi
+
+- Ne prepisuj kod u "savršeniji" obrazac ako to nije potrebno za smanjenje složenosti.
+- Ne uklanjaj obradu grešaka za ulaze izvana, čak i ako izgleda suvišno.
+- Ne mijenjaj ponašanje kako bi kod bio kraći.
+
+## Izvještaj
+
+Na kraju ukratko navedi: što si uklonio ili pojednostavio, je li ponašanje ostalo isto (i kako si to provjerio) te što si primijetio, ali nisi dirao.
\ No newline at end of file