Frontmatter — Słownik umiejętności Claude Code

Frontmatter to blok YAML oddzielony --- na górze pliku SKILL.md. Służy jako konfiguracja umiejętności, kontrolując jej metadane i zachowanie podczas wykonywania.

Kluczowe pola w frontmatterze pozwalają na szczegółową kontrolę:

name: Nazwa wyświetlana umiejętności. Jeśli pominięte, używana jest nazwa katalogu umiejętności.
description: Kluczowe pole wyjaśniające, co robi umiejętność i jaki jest jej cel. Jeśli jest brakujące, umiejętność używa pierwszego akapitu treści markdown. To pole jest kluczowe dla automatycznego wywoływania.
when_to_use: Dostarcza dodatkowego kontekstu do wyzwalania umiejętności, dodanego do description.
argument-hint: Podaje wskazówkę wyświetlaną podczas autouzupełniania, np. [numer-wydania].
arguments: Definiuje nazwane argumenty pozycyjne, które można używać z podstawieniem $nazwa.
disable-model-invocation: Ustawienie tej wartości na true zapobiega automatycznemu wywoływaniu umiejętności przez Claude.
user-invocable: Ustawione na false, aby ukryć umiejętność z menu poleceń /. Należy pamiętać, że poprawna pisownia to user-invocable z 'c'.
allowed-tools: Określa narzędzia, które mogą być używane bez wyraźnej zgody, gdy umiejętność jest aktywna.
disallowed-tools: Wymienia narzędzia, które są usuwane z dostępnej puli, gdy umiejętność jest aktywna.
model: Określa, którego modelu Claude używa, gdy umiejętność jest aktywna.
effort: Kategoryzuje złożoność umiejętności z poziomami takimi jak low, medium, high, xhigh lub max.
context: Ustawienie tej wartości na fork uruchamia umiejętność w kontekście rozwidlonego podagenta.
agent: Określa typ podagenta używanego, gdy context jest ustawione na fork.
hooks: Pozwala na definiowanie haków (hooks) zakresowych do cyklu życia umiejętności.
paths: Używa wzorców glob, aby ograniczyć automatyczne aktywowanie umiejętności.
shell: Definiuje używaną powłokę, bash lub powershell.

Chociaż wiele pól oferuje precyzyjną kontrolę, pole description jest szczególnie ważne dla umożliwienia automatycznego wywoływania umiejętności. Na przykład umiejętność Skill Creator używa frontmatter do zdefiniowania swojej nazwy, opisu i argumentów, kierując użytkowników, jak tworzyć nowe umiejętności.