> Źródło: https://redai.pl/dev/skille-czatu/ (dokumentacja modułów portalu redAi). Cała dokumentacja w jednym pliku: https://redai.pl/dev/moduly.md

## Skille czatu

Moduł może dać czatom instancji nowe umiejętności: katalog `skille/<nazwa>/` z plikiem `SKILL.md` (i plikami obok, np. skryptami pomocniczymi albo wzorami).

```
narzedzia/faktury_kosztowe/skille/
  ksiegowanie/
    SKILL.md
    wzor-opisu.md
```

```markdown
---
name: faktury-kosztowe-ksiegowanie
description: Opisuje fakturę kosztową do księgowania według zasad firmy. Użyj, gdy użytkownik prosi o opis albo dekretację faktury kosztowej.
---

# Opis faktury do księgowania

1. Poproś o numer faktury albo plik.
2. Opisz fakturę według wzoru z pliku wzor-opisu.md.
3. ...
```

- Nazwa katalogu skilla: małe litery, cyfry, `-` i `_`, do 61 znaków.
- Gdy moduł jest włączony, portal kopiuje skille do katalogu skilli czatów instancji jako `<klucz z myślnikami>-<nazwa>` (np. `faktury-kosztowe-ksiegowanie`). Kopia ma znacznik, po którym portal ją rozpoznaje.
- Wyłączenie albo usunięcie modułu kasuje tylko te kopie. Skilli założonych w czacie ręcznie portal nie rusza, także gdy mają tę samą nazwę.
- Skille działają **we wszystkich czatach instancji**, nie tylko u osób z dostępem do modułu. Nie wkładajcie do nich niczego, czego nie może zobaczyć każdy użytkownik instancji.
- Skill opisuje, jak czat ma pracować. Nie może kazać czatowi omijać zabezpieczeń, wysyłać danych poza instancję ani ruszać plików portalu.

**Moduł z samymi skillami.** Moduł nie musi mieć ekranu. Wystarczy manifest (`nazwa`, `opis`, `wersja`, `zmiany`) i folder `skille/`, bez `trasy.php` i widoków. Taki moduł jest na liście Modułów jak każdy inny: administrator włącza go przełącznikiem w karcie, a portal kopiuje skille do czatów. Nie ma tylko pozycji w menu ani przycisku „Otwórz”.