skill-developer

Create and manage Claude Code skills following Anthropic best practices. Use when creating new skills, modifying skill-rules.json, understanding trigger patterns, working with hooks, debugging skill activation, or implementing progressive disclosure. Covers skill structure, YAML frontmatter, trigger types (keywords, intent patterns, file paths, content patterns), enforcement levels (block, suggest, warn), hook mechanisms (UserPromptSubmit, PreToolUse), session tracking, and the 500-line rule.

1. Aktywuj umiejętność, gdy pracujesz nad tworzeniem nowych umiejętności Claude Code lub modyfikujesz plik skill-rules.json. Umiejętność automatycznie się włączy, gdy wspomniasz o tworzeniu, dodawaniu lub debugowaniu umiejętności.

2. Zapoznaj się ze strukturą umiejętności: każda umiejętność wymaga YAML frontmatter z nazwą, opisem i warunkami aktywacji. Zdefiniuj wzorce wyzwalania — mogą to być słowa kluczowe, wzorce intencji, ścieżki plików lub wzorce zawartości.

3. Wybierz odpowiedni poziom egzekwowania dla swojej umiejętności: block (całkowicie blokuje akcję), suggest (proponuje zmianę) lub warn (wyświetla ostrzeżenie). Decyzja zależy od krytyczności reguły.

4. Skonfiguruj haki aktywacji — UserPromptSubmit do proaktywnych sugestii przed przetworzeniem promptu oraz PreToolUse do interwencji przed użyciem narzędzia. Haki pozwalają na inteligentne wyzwalanie umiejętności w odpowiednim momencie.

5. Pamiętaj o regule 500 linii: każda umiejętność powinna być zwarta i skoncentrowana. Stosuj progressive disclosure — ujawniaj zaawansowane opcje stopniowo, aby nie przeciążać użytkownika.

6. Testuj aktywację umiejętności, debugując wzorce wyzwalania i sprawdzając, czy umiejętność włącza się w oczekiwanych scenariuszach. Wykorzystaj system śledzenia sesji do monitorowania, kiedy i dlaczego umiejętność się aktywuje.