Frontmatter

Frontmatter je blok YAML ohraničený --- v horní části souboru SKILL.md. Slouží jako konfigurace pro dovednost, řídí její metadata a chování při provádění.

Klíčová pole v rámci frontmatteru umožňují detailní kontrolu:

• name: Zobrazovaný název dovednosti. Pokud je vynechán, použije se název adresáře dovednosti.
• description: Klíčové pole vysvětlující, co dovednost dělá a jaký je její zamýšlený případ použití. Pokud toto pole chybí, dovednost se vrátí k použití prvního odstavce obsahu v markdownu. Toto pole je zásadní pro automatické vyvolání.
• when_to_use: Poskytuje další kontext pro spouštění dovednosti, připojený k description.
• argument-hint: Nabízí nápovědu zobrazovanou během automatického doplňování, například [issue-number].
• arguments: Definuje pojmenované poziční argumenty, které lze použít s náhradou $name.
• disable-model-invocation: Nastavení této hodnoty na true zabrání Claude automaticky vyvolávat dovednost.
• user-invocable: Nastaveno na false pro skrytí dovednosti z nabídky příkazů /. Všimněte si, že správný pravopis je user-invocable s 'c'.
• allowed-tools: Určuje nástroje, které lze použít bez explicitního povolení, zatímco je dovednost aktivní.
• disallowed-tools: Seznam nástrojů, které jsou odebrány z dostupného fondu, zatímco je dovednost aktivní.
• model: Určuje, který model Claude používá, zatímco je dovednost aktivní.
• effort: Kategorizuje složitost dovednosti s úrovněmi jako low, medium, high, xhigh nebo max.
• context: Nastavení této hodnoty na fork spustí dovednost v kontextu rozvětveného podagenta.
• agent: Určuje typ podagenta, který se použije, když je context nastaven na fork.
• hooks: Umožňuje definovat háčky (hooks) v rozsahu životního cyklu dovednosti.
• paths: Používá vzory glob pro omezení, kdy se dovednost automaticky aktivuje.
• shell: Definuje shell, který se má použít, buď bash nebo powershell.

Ačkoli mnoho polí nabízí jemné řízení, pole description je obzvláště důležité pro umožnění automatického vyvolání dovednosti. Například dovednost Skill Creator používá frontmatter k definování svého názvu, popisu a argumentů, čímž vede uživatele, jak vytvářet nové dovednosti.