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.
Python ai-agentsaiopsdashboarddockerfastapihomelabincident-managementllmmonitoringopenaireactroot-cause-analysisself-hosteduptime-monitoring
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.mdnew file mode 100644index 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 filediff --git a/.claude/skills/minimal-diff/minimal-diff.md b/.claude/skills/minimal-diff/minimal-diff.mdnew file mode 100644index 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 filediff --git a/.claude/skills/simplify-existing-code.md/simplify-existing-code.md b/.claude/skills/simplify-existing-code.md/simplify-existing-code.mdnew file mode 100644index 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