plugin-structure

Ta umiejętność prowadzi Cię przez standardową organizację wtyczek Claude Code. Dowiesz się, jak rozmieścić komponenty (komendy, agenty, umiejętności, hooki) w odpowiednich katalogach, skonfigurować plik plugin.json w folderze .claude-plugin/, używać przenośnych ścieżek ${CLAUDE_PLUGIN_ROOT} i włączyć automatyczne odkrywanie komponentów. Idealna dla programistów tworzących dobrze zorganizowane wtyczki integrujące się z Claude Code.

1. Zapoznaj się z wymaganą strukturą katalogów wtyczki Claude Code. Główny folder wtyczki powinien zawierać podfoldery: .claude-plugin/ (z plikiem plugin.json), commands/, agents/, skills/, hooks/ i scripts/. Każdy z tych katalogów pełni określoną rolę w organizacji komponentów.

2. Utwórz plik manifestu plugin.json w folderze .claude-plugin/. Ten plik jest obowiązkowy i zawiera konfigurację wtyczki. Pamiętaj, że manifest MUSI znajdować się w .claude-plugin/, a nie w głównym katalogu wtyczki.

3. Organizuj komponenty na poziomie głównego katalogu wtyczki, nie wewnątrz .claude-plugin/. Umieszczaj komendy (pliki .md) w folderze commands/, definicje agentów w agents/, umiejętności w skills/ (każda w osobnym podkatalogu z plikiem SKILL.md), a konfigurację hooków w pliku hooks.json.

4. Używaj przenośnych odniesień do ścieżek za pomocą zmiennej ${CLAUDE_PLUGIN_ROOT} w swoich plikach konfiguracyjnych. Umożliwia to przenoszenie wtyczki bez konieczności aktualizacji ścieżek bezwzględnych.

5. Włącz automatyczne odkrywanie komponentów, przestrzegając konwencji nazewnictwa i rozmieszczenia katalogów. Claude Code automatycznie skanuje standardowe foldery i ładuje komponenty zgodnie z ich lokalizacją, o ile respektujesz opisaną strukturę katalogów.