SKILL.md

Plik SKILL.md jest podstawową jednostką umiejętności Claude Code. Składa się z dwóch części: frontmatter YAML, ograniczonego znacznikami ---, oraz treści markdown, która zawiera instrukcje, którymi Claude się kieruje podczas wykonywania umiejętności.

Plik SKILL.md znajduje się w określonej strukturze katalogów. Dla osobistych umiejętności dostępnych we wszystkich projektach, znajduje się on pod ścieżką ~/.claude/skills/<nazwa-umiejętności>/SKILL.md. Dla umiejętności specyficznych dla projektu, ścieżka to .claude/skills/<nazwa-umiejętności>/SKILL.md. Jeśli umiejętność jest częścią wtyczki, znajdzie się ona pod ścieżką <wtyczka>/skills/<nazwa-umiejętności>/SKILL.md.

Nazwa katalogu zawierającego plik SKILL.md określa polecenie, którego używasz do wywołania umiejętności za pomocą polecenia ukośnika (np. /nazwa-umiejętności). Jednak pole name w frontmatter YAML ustawia etykietę wyświetlaną na liście umiejętności. Wyjątkiem są pliki SKILL.md w katalogu głównym wtyczki, gdzie pole name bezpośrednio określa nazwę polecenia, ponieważ nie ma dedykowanego katalogu umiejętności, z którego można by je wywnioskować.

Oprócz samego pliku SKILL.md, katalog umiejętności może zawierać dodatkowe pliki, takie jak dokumentacja referencyjna lub skrypty. Te dodatkowe pliki są ładowane przez Claude Code tylko wtedy, gdy są potrzebne podczas działania umiejętności. Claude Code aktywnie monitoruje te katalogi umiejętności. W związku z tym zmiany wprowadzone w pliku SKILL.md lub dodanie nowych plików wejdą w życie w bieżącej sesji bez konieczności ponownego uruchamiania. Jednak utworzenie katalogu umiejętności najwyższego poziomu, który nie istniał na początku sesji, będzie wymagało ponownego uruchomienia, aby Claude Code mógł go rozpoznać.

Umiejętności Claude Code są zgodne z otwartym standardem Agent Skills, promując interoperacyjność i spójne podejście do tworzenia umiejętności. Wskazówki dotyczące tworzenia dobrze ustrukturyzowanych plików umiejętności można znaleźć w sekcji Authoring Skills.