Skill description

Pole frontmatter description jest tym, czego Claude używa do decydowania, kiedy zastosować umiejętność. Jest to pojedyncza, najbardziej obciążająca linia w pliku SKILL.md, ponieważ jest to jedyna część umiejętności, która jest zawsze w kontekście. Jeśli description zostanie pominięte, Claude Code użyje pierwszego akapitu zawartości markdown.

Umieść kluczowy przypadek użycia NAJPIERW. Połączony tekst description i when-to-use jest obcinany do 1536 znaków na liście umiejętności, aby zmniejszyć zużycie kontekstu. Ten limit można skonfigurować za pomocą ustawienia skillListingMaxDescChars. Istnieje również ogólny budżet listy dla wszystkich umiejętności, który można dostosować za pomocą ustawienia skillListingBudgetFraction lub zmiennej środowiskowej SLASH_COMMAND_TOOL_CHAR_BUDGET. Aby zwolnić budżet, wpisy o niskim priorytecie można ustawić na 'tylko nazwa' w skillOverrides, aby były wyświetlane bez opisu.

Dobra opis mówi, co robi umiejętność I KIEDY jej użyć, słowami użytkownika, a nie autora. Protokół testowy SkillProof ocenia to bezpośrednio: etap wyzwalania zapisuje trzy sformułowania, które POWINNY aktywować umiejętność, i dwa sąsiednie, które NIE POWINNY, a następnie szczerze ocenia, czy opis wygrał obciążenie. Niejasne opisy są najczęstszym powodem, dla którego technicznie dobra umiejętność nigdy się nie uruchamia. Na przykład, opis umiejętności Skill Audit jasno określa jej cel: "Audytuje bazę kodu pod kątem jakości, spójności i błędnych wzorców przed wydaniem."