Składniki wtyczki - skille, hooki, MCP
Wtyczka Claude Code składa się z komponentów, między innymi skilli, agentów, hooków i serwerów MCP. Każdy komponent ma domyślny katalog, a opcjonalny klucz manifestu może zastąpić tę lokalizację lub dodać kolejną; nazwa komponentu jest widoczna dla użytkownika. Dodajesz tylko te składniki, których potrzebuje wtyczka — żaden nie jest wymagany.
Skill to plik SKILL.md zapisany we własnym katalogu pod skills/. Claude odczytuje opis każdego skilla i, gdy prośba użytkownika do niego pasuje, wczytuje instrukcje skilla i postępuje zgodnie z nimi. Użytkownik może też uruchomić skill bezpośrednio jako /my-plugin:review.
Hook automatycznie uruchamia działanie w określonym momencie cyklu życia Claude Code; może to być polecenie powłoki, żądanie HTTP, wywołanie narzędzia MCP, prompt do modelu albo subagent. Plik hooków zapisuje się jako hooks/hooks.json w katalogu głównym wtyczki; pokazany przykład uruchamia skrypt formatowania po zapisie lub edycji pliku przez Claude. Katalog scripts/ jest jedynie konwencją, więc hook musi wskazywać skrypt przez jego ścieżkę.
Serwer MCP udostępnia Claude narzędzia z systemu zewnętrznego i jest deklarowany w pliku .mcp.json w katalogu głównym wtyczki. Po dodaniu komponentu uruchom /reload-plugins w działającej sesji albo rozpocznij nową, aby Claude Code go wczytał. Przed wczytaniem komponentu możesz sprawdzić jego plik poleceniem claude plugin validate . z katalogu wtyczki.
--- description: Reviews a pull request for style and test coverage. Use when asked to review code. --- Review the changed files. Report style problems first, then missing tests.
{
"hooks": {
"PostToolUse": [
{
"matcher": "Write|Edit",
"hooks": [
{
"type": "command",
"command": "\"${CLAUDE_PLUGIN_ROOT}/scripts/format.sh\""
}
]
}
]
}
}{
"mcpServers": {
"db": {
"command": "node",
"args": ["${CLAUDE_PLUGIN_ROOT}/server.js"]
}
}
}Zastosowanie w praktyce
Dodaj skill do przeglądów kodu, gdy chcesz, aby pasująca prośba ładowała określone instrukcje, na przykład sprawdzanie stylu i pokrycia testami. Wykorzystaj hook, gdy działanie ma następować automatycznie po edycji pliku, na przykład uruchomienie formatowania. Dodaj serwer MCP, gdy chcesz udostępnić Claude narzędzia pochodzące z systemu zewnętrznego. Po dodaniu skilli, hooków lub serwera MCP przeładuj wtyczki w działającej sesji albo rozpocznij nową, aby załadować komponent.
scripts/: to konwencja, a hook musi wskazywać plik po ścieżce.