Szablony Claude Code: umiejętności, agenci, hooki i nie tylko

Czym są szablony Claude Code?

Szablony Claude Code to pliki konfiguracyjne wielokrotnego użytku, które dostosowują sposób działania Claude Code w projekcie lub w całym twoim środowisku lokalnym. 

Ważne jest zrozumienie, że szablony są oparte na plikach. Nie instalujesz ich przez typowe GUI ustawień i nie przeklikujesz ekranów konfiguracji. Zamiast tego Claude Code wykrywa określone pliki i foldery, ładuje odpowiednie metadane do kontekstu i wykorzystuje te informacje, by zdecydować, jak się zachować.

W praktyce są to zwykle pliki w formacie Markdown, JSON lub oparte na shellu, przechowywane w folderach na poziomie projektu, takich jak .claude/, lub spakowane w katalogi wtyczek do współdzielenia.

Typowa struktura na poziomie projektu może wyglądać tak:

my-app/
├── CLAUDE.md
├── .mcp.json
└── .claude/
    ├── skills/
    │   └── database-migration/
    │       └── SKILL.md
    ├── agents/
    │   └── security-auditor.md
    ├── commands/
    │   └── summarize-pr.md
    └── settings.json

Szablony Claude Code vs CLAUDE.md

CLAUDE.md nadal jest ważny, ale pełni inną rolę. Traktuj CLAUDE.md jak brief projektu: czym jest projekt, które komendy mają znaczenie, jakie standardy kodowania obowiązują i o jakich konwencjach architektonicznych Claude powinien pamiętać. 

Aby zobaczyć pełniejszy przegląd, zajrzyj do naszego poradnika pisania CLAUDE.md.

Szablony są bardziej modułowe:

• Umiejętność może zakodować workflow migracji. 
• Agent może odizolować personę do przeglądu bezpieczeństwa. 
• Hook może uruchamiać się po edycjach plików. 
• Konfiguracja MCP może połączyć Claude z GitHubem, SQLite lub innym systemem zewnętrznym.

To także miejsce, gdzie szablony łączą się z szerszym projektowaniem przepływów pracy w Claude Code. Dobrze przygotowane szablony działają najlepiej w parze z dobrymi nawykami planowania, testowania i przekazywania kontekstu. 

Więcej takich praktyk znajdziesz w naszym przewodniku dobrych praktyk.

Własne komendy są również objęte systemem umiejętności, choć starszy format .claude/commands/ nadal działa. Zalecanym nowym formatem jest .claude/skills/<name>/SKILL.md, który obsługuje wywołanie przez slash-komendę oraz automatyczne wywołanie przez Claude.

Jakich rodzajów szablonów Claude Code mogę użyć?

Ekosystem szablonów Claude Code jest zazwyczaj podzielony na sześć kategorii: umiejętności, agenci, komendy, hooki, integracje MCP i wtyczki. 

Pierwsze pięć bezpośrednio zmienia zachowanie Claude. Wtyczki są nieco inne: to format dystrybucji, który może spakować umiejętności, agentów, hooki, komendy, serwery MCP i inne komponenty w pakiet wielokrotnego użytku.

Poniżej przyjrzymy się każdej z tych kategorii.

1. Umiejętności

Umiejętności to pakiety instrukcji do powtarzalnych, wieloetapowych zadań. Umiejętność to zwykle folder zawierający plik SKILL.md z frontmatterem YAML i korpusem w Markdownie. 

Frontmatter opisuje, co robi umiejętność i jak powinna się zachowywać; korpus mówi Claude, jakie kroki wykonać. Pełne omówienie znajdziesz w przewodniku Claude Skills.

Claude używa opisu umiejętności, by zdecydować, kiedy jest ona istotna. Domyślnie zarówno użytkownik, jak i Claude mogą wywołać umiejętność: możesz wpisać /skill-name, albo Claude załaduje ją automatycznie, gdy bieżące zadanie pasuje do jej opisu. Możesz też wyłączyć automatyczne wywołanie przez model w workflowach, w których chcesz mieć ręczną kontrolę, np. przy wdrożeniach.

Oto krótki przykład pliku: .claude/skills/database-migration/SKILL.md

---
name: database-migration
description: Use when creating, reviewing, or modifying database migrations. Ensures migrations are reversible, tested, and checked before and after execution.
allowed-tools:
  - Read
  - Write
  - Bash
---

# Database Migration Skill

When working on a database migration:

1. Inspect the existing schema and migration history before writing changes.
2. Confirm whether the migration is additive, destructive, or data-transforming.
3. Create a reversible migration whenever the framework supports rollback.
4. Run the project’s migration check command before applying the migration.
5. Run tests that cover the affected models, queries, or API endpoints.
6. After writing the migration, summarize:
   - schema changes
   - rollback behavior
   - affected tables
   - test commands run

To jest przydatne, bo instrukcje mają charakter proceduralny. Nie prosisz tylko Claude, by „uważał przy migracjach”. Dajesz mu powtarzalną checklistę. 

Umiejętności najlepiej sprawdzają się przy wszystkim, co w innym wypadku wklejałbyś do Claude więcej niż dwa razy: generowaniu endpointów API, pisaniu changelogów, szkielecie testów, tworzeniu notatek wydawniczych, przeglądzie pull requestów czy sprawdzaniu migracji.

Po szerszą inspirację, co deweloperzy zamieniają w workflowy AI wielokrotnego użytku, zajrzyj do naszej listy Agent Skills.

2. Agenci

Agenci, precyzyjniej niestandardowi subagenci w Claude Code, to wyspecjalizowani asystenci AI z własną definicją w Markdownie, frontmatterem YAML, ograniczeniami narzędzi, wyborem modelu i promptem systemowym. 

Mogą znajdować się w .claude/agents/ dla zakresu projektu lub w ~/.claude/agents/ dla zakresu osobistego. Agentów tworzysz, prosząc o to Claude lub edytując pliki markdown bezpośrednio w folderze .claude/agents/.

Różnica między umiejętnościami a agentami jest realna. Umiejętność definiuje, jak wykonać zadanie. Agent definiuje, kim ma być Claude podczas pracy: jego rolę, fokus, uprawnienia i granice.

Spójrzmy na przykład agenta:

---
name: security-auditor
description: Reviews code for security vulnerabilities and produces a findings report without modifying files.
tools: Read, Glob, Grep, Bash
model: sonnet
---

You are a security auditor.

Your task is to inspect the codebase for vulnerabilities, risky patterns, and missing safeguards.

Rules:
- Do not edit files.
- Do not suggest broad rewrites unless directly tied to a security issue.
- Focus on authentication, authorization, input validation, secrets, dependency risk, and unsafe shell or SQL usage.
- Produce a findings report with severity, affected files, evidence, and recommended next steps.

Ten agent jest pomocny, bo daje Claude jasne granice. W ogólnej sesji Claude mógłby od razu przejść do naprawiania problemów, gdy je znajdzie. Agent „security auditor” ma za zadanie tylko sprawdzać i raportować oraz unikać modyfikacji. 

Agenci najlepiej sprawdzają się w wyspecjalizowanych domenach, takich jak audyt bezpieczeństwa, przegląd dokumentacji, przegląd architektury, inżynieria danych czy kontrola jakości kodu, gdzie liczy się izolacja kontekstu i granice uprawnień.

Agenci są też użyteczni w parze ze specjalistycznymi umiejętnościami. Np. agent audytor bezpieczeństwa może wywoływać umiejętność tworzenia raportu z ustaleń, a agent frontend reviewer może korzystać z umiejętności testowania komponentów.

3. Komendy

Komendy to skróty wywoływane przez slash, takie jak /generate-tests, /check-deps czy /summarize-pr. Historycznie własne komendy były przechowywane jako pliki Markdown w .claude/commands/, a nazwa pliku była nazwą komendy. 

Claude Code wciąż obsługuje ten starszy format, ale polecam używać umiejętności dla nowych workflowów przypominających komendy, bo obsługują to samo wywołanie /name oraz automatyczne wywołanie, gdy to właściwe.

Komendy są najlepsze, gdy chcesz, by wyzwalacz był jawny. Umiejętność może aktywować się automatycznie, gdy Claude wykryje pasujące zadanie, ale komenda powinna działać tylko wtedy, gdy ty zdecydujesz. To czyni komendy użytecznymi jako punkty kontrolne: „wygeneruj testy teraz”, „podsumuj ten PR teraz”, „sprawdź zależności teraz” lub „przygotuj wiadomość do commita teraz”.

4. Hooki

Hooki to reguły automatyzacji uruchamiane w odpowiedzi na zdarzenia cyklu życia Claude Code. To zdefiniowane przez użytkownika komendy shellowe wykonywane w określonych momentach cyklu życia Claude Code, dające deterministyczną kontrolę nad zachowaniem. 

Różnica między hookami a pozostałymi dotychczas omówionymi szablonami polega na tym, że nie są wyzwalane przez to, o co poprosisz, lecz przez to, co robi Claude.

Mówiąc prościej: nie musisz liczyć na to, że Claude pamięta o formatowaniu pliku po edycji; hook zrobi to automatycznie.

Obecne nazwy zdarzeń hooków obejmują m.in. PreToolUse, PostToolUse, Notification i Stop. 

Przykład: uruchom formatter po tym, jak Claude edytuje lub zapisze plik:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

Example: block risky shell commands before Claude runs them:
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 .claude/hooks/block-dangerous-bash.py"
          }
        ]
      }
    ]
  }
}

Hooki są najlepsze do zasad, których Claude nie powinien móc pominąć: uruchamianie lintera, formatowanie edytowanych plików, blokowanie chronionych edycji, sprawdzanie wygenerowanego kodu czy wysyłanie powiadomień, gdy Claude potrzebuje twojego wkładu. 

Szczegółowy samouczek znajdziesz w naszym Claude Code Hooks Guide.

5. Integracje MCP

Integracje MCP łączą Claude Code z zewnętrznymi narzędziami, źródłami danych i API poprzez Model Context Protocol. MCP działa jako warstwa łącząca między systemami AI a narzędziami zewnętrznymi. W Claude Code oznacza to, że Claude może wyjść poza pliki lokalne i komendy shellowe. 

Pozwala to Claude na interakcję z zewnętrznymi usługami, takimi jak GitHub, bazy danych, systemy dokumentacji, platformy chmurowe czy wewnętrzne API — w zależności od tego, które serwery MCP skonfigurujesz. Pełne wyjaśnienie i projekt demonstracyjny znajdziesz w naszym poradniku Model Context Protocol.

Serwer MCP może udostępniać trzy szerokie rodzaje możliwości:

• Narzędzia: wykonywalne funkcje, które Claude może wywołać, np. utworzenie zgłoszenia w GitHubie czy wykonanie zapytania do bazy.
• Zasoby: źródła kontekstu tylko do odczytu, takie jak plik, wiersz bazy danych czy dokument.
• Prompty: szablony zadań wielokrotnego użytku udostępniane przez serwer.

Plik .mcp.json na poziomie projektu może konfigurować wiele serwerów obok siebie:

{
  "mcpServers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "sqlite": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sqlite",
        "./data/app.db"
      ]
    }
  }
}

To ma znaczenie, bo Claude może wnioskować tylko na podstawie kontekstu i narzędzi, do których ma dostęp. Bez MCP może przeglądać pliki lokalne, ale nie twój tracker zgłoszeń, bazę danych, środowisko chmurowe czy wewnętrzne API. 

MCP sprawdza się najlepiej, gdy Claude musi pracować z prawdziwym stackiem, a nie statycznym zrzutem kodu, i gdy potrzebuje dostępu do danych zewnętrznych.

6. Wtyczki

Wtyczki to spakowane pakiety. Mogą zawierać umiejętności, agentów, hooki, konfiguracje MCP, komendy i inne komponenty w jednej instalowalnej strukturze. 

W Claude Code wtyczka zwykle zawiera manifest .claude-plugin/plugin.json oraz foldery komponentów, takie jak skills/, agents/, hooks/ i .mcp.json w katalogu głównym wtyczki.

Przykładowa struktura wtyczki:

frontend-workflow-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── component-test/
│       └── SKILL.md
├── agents/
│   └── frontend-reviewer.md
├── hooks/
│   └── hooks.json
└── .mcp.json

Przykład pliku JSON wtyczki:

{
  "name": "frontend-workflow",
  "displayName": "Frontend Workflow",
  "version": "1.0.0",
  "description": "Frontend development workflow with review agents, test skills, and formatting hooks",
  "author": {
    "name": "Your Team"
  }
}

Wtyczki nie dodają nowego typu zachowania. Sprawiają, że pozostałe typy są przenośne. Używaj wtyczek, gdy chcesz udostępnić pełną konfigurację zespołowi, ponownie wykorzystać ten sam workflow w wielu projektach albo zainstalować pakiet utrzymywany przez społeczność zamiast ręcznie tworzyć każdy plik.

Aby zbudować wtyczkę od zera, zobacz przewodnik krok po kroku po wtyczkach Claude Code na DataCamp.

Który typ szablonu wybrać?

Doskonale rozumiem — te typy potrafią mieszać w głowie. Wszystkie mogą zmieniać zachowanie Claude. Różnią się głównie tym, jak są wyzwalane i jaką kontrolę dają.

Aby było jaśniej, oto porównanie:

Pomaga prosta zasada decyzyjna:

• Jeśli chcesz automatycznie egzekwować zasadę za każdym razem, gdy Claude dotyka kodu, użyj hooka. 
• Jeśli chcesz, by Claude przyjął głęboką ekspertyzę domenową w konkretnym zadaniu, użyj agenta. 
• Jeśli chcesz zakodować workflow, który Claude ma konsekwentnie powtarzać, użyj umiejętności. 
• Jeśli chcesz sam wywołać akcję w odpowiednim momencie, użyj komendy lub umiejętności działającej jak komenda. 
• Jeśli Claude potrzebuje zewnętrznych usług lub danych na żywo, użyj MCP. 
• Jeśli chcesz zainstalować lub udostępnić pełny zestaw workflowów, użyj wtyczki.

W prawdziwych projektach te typy zwykle się łączą. Wtyczka bezpieczeństwa może spakować agenta security-auditor, umiejętność audit-findings, komendę sprawdzania zależności i hook pre-commit. Agent definiuje rolę, umiejętność określa strukturę raportu, komenda daje ci jawny punkt kontrolny, a hook egzekwuje zabezpieczenie.

Dla workflowów, w których Claude powinien podążać za formalnym planem przed implementacją, spec-driven development jest często lepszym wyborem niż doraźne podpowiedzi.

Gdzie znajdę szablony Claude Code?

Masz trzy praktyczne źródła: Anthropic, kolekcje społecznościowe i siebie samego.

Najpierw zacznij od oficjalnych zasobów Anthropic i dokumentacji. Dokumentacja Claude Code od Anthropic obejmuje umiejętności, subagentów, hooki, MCP i wtyczki i to najlepsze miejsce, by zweryfikować aktualne formaty plików i zachowanie przed publikacją czegokolwiek do produkcji.

Po drugie, korzystaj z kolekcji społecznościowych. Najbardziej widocznym hubem społeczności jest aitmpl.com, które opisuje się jako katalog gotowych do użycia konfiguracji dla projektów Claude Code. W aktualnej nawigacji znajdziesz Skills, Agents, Commands, Settings, Hooks, MCPs i Plugins. 

Aktualna interaktywna komenda instalacyjna to:

npx claude-code-templates@latest

Dokumentacja projektu pokazuje też krótszy alias:

npx cct@latest

Dla konkretnych komponentów, aktualny README na GitHubie pokazuje komendy instalacji, takie jak:

npx claude-code-templates@latest --agent development-tools/code-reviewer --yes
npx claude-code-templates@latest --command performance/optimize-bundle --yes
npx claude-code-templates@latest --hook git/pre-commit-validation --yes
npx claude-code-templates@latest --mcp database/postgresql-integration --yes

Pokazano też instalację całego zestawu w trybie wsadowym przy użyciu wielu flag w jednej komendzie.

Oceniając szablony społecznościowe, sprawdź kilka sygnałów jakości:

• Czy description jest wystarczająco precyzyjny, by Claude prawidłowo wyzwalał umiejętność lub agenta?

• Czy allowed-tools są wąsko określone, czy też szablon niepotrzebnie żąda szerokich uprawnień do zapisu i bash?

• Czy repozytorium było ostatnio utrzymywane?

• Czy szablon wyjaśnia, co zmienia?

• Czy zawiera hooki lub serwery MCP, które wykonują kod, którego nie przejrzałeś?

Po trzecie, napisz własne. To zwykle najlepsza odpowiedź dla workflowów ściśle powiązanych z twoim stackiem. Szablon społecznościowy może dać użyteczną bazę, ale nie zna twojej wewnętrznej polityki migracji, konwencji nazewniczych, modelu danych czy akceptowalnego ryzyka wdrożeń.

Na koniec

Szablony Claude Code sprawiają, że Claude Code przechodzi od asystenta sesyjnego do trwałego środowiska developerskiego. 

Sześć wymienionych kategorii to w gruncie rzeczy warstwy: umiejętności kodują workflowy, agenci definiują role, komendy tworzą jawne akcje, hooki egzekwują zabezpieczenia, MCP łączy systemy zewnętrzne, a wtyczki pakują wszystko do ponownego użycia.

Najlepszym startem nie jest wielka paczka wtyczek. Zacząłbym od jednej umiejętności dla najbardziej powtarzalnego workflowu. Gdy zobaczysz, gdzie domyślne zachowanie Claude wciąż tworzy tarcia, dodaj agenta do specjalistycznego przeglądu, hook do egzekwowania zasad lub serwer MCP dla dostępu do żywych systemów.

Aby uczyć się dalej o Claude Code, sprawdź nasze kursy Claude Code 101 i Claude Code in Action.