# NEXT Starter Skills 1.0.0

Pakiet dla początkujących uczestników hackathonu. Dwanaście skilli w formacie Agent Skills; bez zależności w samych skillach. Foldery są źródłem pakietu publikowanego przez `python3 scripts/package_skills.py`.

## Instalacja

Najprościej wklej prompt z podstrony `/start-z-agentem.html` do agenta z dostępem do plików. Instalacja odbywa się wyłącznie w wybranym projekcie. Nie loguje konta GitHub i nie tworzy repozytorium.

Instalator Python 3.9+ działa na macOS, Windows i Linux. Pobierz go, obejrzyj i uruchom przez dostępnego agenta. Obsługuje URL pakietu, lokalne ZIP oraz lokalne źródła po sklonowaniu repo. Domyślnie wykonuje podgląd; `--apply` zapisuje pliki. Nie nadpisuje różniących się plików. Nie uruchamia kodu zawartego w archiwum. Manifest SHA-256 wykrywa uszkodzenie paczki, ale nie dowodzi zaufania do jej autora.

```sh
python3 install.py --archive next-starter-skills.zip --agent codex --project /sciezka/do/projektu
python3 install.py --archive next-starter-skills.zip --agent codex --project /sciezka/do/projektu --apply
```

W Windows użyj `py -3` zamiast `python3`, jeśli tak nazywa się interpreter. Agent rozpozna właściwą komendę.

Codex: `.agents/skills/`; Claude Code: `.claude/skills/`; Cursor: `.cursor/skills/`. Przy innym agencie użyj `NEXT-PLAYBOOK.md` jako załącznika lub instrukcji w rozmowie. Czat bez dostępu do plików nie wykona lokalnej instalacji ani commitów.

Opcja repozytorium: sklonuj `https://github.com/MoxxyLabs/next-hackathon.git`, a następnie wskaż instalatorowi `--source-dir <repo>/skills`. Dostępność nowych plików na GitHubie wymaga wcześniejszego opublikowania tej zmiany. Nie używaj `curl | sh`.

Restart rozmowy może być potrzebny do wykrycia nowych skilli. Sprawdź ich listę w agencie, a następnie poproś: „Użyj next-start. Pomóż mi zbudować pierwszą wersję aplikacji”.

## Aktualizacja i usunięcie

Ponowne uruchomienie tej samej wersji jest bezpieczne: identyczne pliki są pomijane. Przy konflikcie zachowaj lokalne skille, porównaj treść i zdecyduj o zmianie ręcznie. Usuń tylko dwanaście folderów `next-*` z docelowego katalogu skilli; nie usuwaj całego katalogu. Instalator nie zmienia globalnej konfiguracji.

## Źródła formatu

- https://developers.openai.com/codex/skills/
- https://code.claude.com/docs/en/skills
- https://cursor.com/docs/skills

Wersja pakietu: 1.0.0. Instrukcje dla uczestników: do 16 drużyn po 3–4 osoby, do 64 uczestników. Materiały przygotowawcze nie zastępują regulaminu wydarzenia.