Skill description

Položka frontmatter description je to, co Claude používá k rozhodnutí, kdy použít skill. Je to jediný nejvíce zatížený řádek v souboru SKILL.md, protože je to jediná část skillu, která je vždy v kontextu. Pokud je description vynechán, Claude Code použije první odstavec markdown obsahu.

Umístěte klíčový případ použití NA PRVNÍ MÍSTO. Kombinovaný text description a when-to-use je zkrácen na 1 536 znaků v seznamu skills, aby se snížila spotřeba kontextu. Tento limit je konfigurovatelný pomocí nastavení skillListingMaxDescChars. Existuje také celkový rozpočet pro seznam napříč všemi skills, nastavitelný pomocí nastavení skillListingBudgetFraction nebo proměnné prostředí SLASH_COMMAND_TOOL_CHAR_BUDGET. Pro uvolnění rozpočtu mohou být nízko prioritní položky nastaveny na 'pouze název' v skillOverrides, takže se zobrazí bez popisu.

Dobrý popis říká, co skill dělá A KDY jej použít, slovy uživatele, nikoli autora. Testovací protokol SkillProof toto přímo hodnotí: fáze spouštění zapíše tři formulace, které BY MĚLY skill aktivovat, a dvě sousední, které by NEMĚLY, a poté upřímně posoudí, zda popis vyhraje zátěž. Vágní popisy jsou nejčastějším důvodem, proč technicky dobrý skill nikdy nevystřelí. Například skill Skill Audit má popis, který jasně uvádí svůj účel: "Audits a codebase for quality, consistency, and broken patterns before release."