plugin-development
Twórz wtyczki Claude Code z ekspertyzą – od struktury po best practices
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Przewodnik dla twórców wtyczek Claude Code. Nauczysz się poprawnej struktury katalogów, konfiguracji plugin.json, pisania komend slash, aktywacji umiejętności i zarządzania sub-agentami. Zawiera konkretne reguły nazewnictwa, wymagane pliki (SKILL.md, AGENT.md) i typowe błędy do uniknięcia. Idealne dla każdego, kto chce budować produkcyjne wtyczki zgodnie ze standardami.
Jak używać
Zainstaluj umiejętność w swoim środowisku Claude Code – będzie dostępna automatycznie, gdy zaaktualizujesz wtyczki.
Kiedy zaczniesz pracę nad nową wtyczką, utwórz katalog główny w ~/.claude/plugins/nazwa-wtyczki/ i przygotuj obowiązkową strukturę: podfolder .claude-plugin/ z plikiem plugin.json, katalog commands/ na komendy slash, katalog skills/ na umiejętności (każda w osobnym podkatalogu z plikiem SKILL.md) oraz katalog agents/ na agentów.
Skonfiguruj plugin.json z minimalnymi polami: name, description (zawierającą słowa kluczowe aktywacji) i version. Dodaj opcjonalnie author, homepage, repository, license i keywords dla pełnej dokumentacji.
Pamiętaj o krytycznych regułach nazewnictwa: używaj kebab-case dla nazw podkatalogów (np. my-skill), pliki umiejętności muszą być dokładnie SKILL.md (wielkie litery), a pliki agentów AGENT.md – błędy w nazewnictwie to najczęstsza przyczyna problemów.
Pisz komendy slash w plikach markdown w katalogu commands/ – każda komenda powinna mieć nagłówek w formacie # /nazwa-wtyczki:nazwa-komendy, zgodnie z dokumentacją wtyczki.
Przetestuj strukturę katalogów i konfigurację przed wdrożeniem – umiejętność pomoże ci zidentyfikować błędy strukturalne i zasugeruje poprawki zgodnie z best practices.