sample-with-references

Sample with References to umiejętność dla Claude'a, która pokazuje, jak efektywnie organizować dokumentację za pomocą progresywnego ujawniania. Zamiast ładować całą zawartość naraz, umiejętność przechowuje główny opis w SKILL.md, a szczegółowe referencje w osobnych plikach (REFERENCE.md, WORKFLOWS.md, EXAMPLES.md). Claude wczytuje dodatkowe materiały tylko wtedy, gdy są potrzebne. Wzorzec ten idealnie sprawdza się dla umiejętności z obszerną dokumentacją API, wieloma przepływami pracy lub dużymi przykładami kodu – pozwala zaoszczędzić tokeny i utrzymać kontekst czysty.

1. Zainstaluj umiejętność w swoim projekcie Claude'a, kopiując folder sample-with-references do katalogu .claude/skills/ w repozytorium. 2. Utwórz strukturę plików: SKILL.md dla przeglądu (do 500 linii), REFERENCE.md dla szczegółowych informacji, WORKFLOWS.md dla instrukcji krok po kroku oraz EXAMPLES.md dla przykładów kodu. Każdy plik powinien być niezależny i nie odwoływać się do innych plików referencyjnych. 3. W SKILL.md umieść krótki opis umiejętności i linki do plików referencyjnych przy użyciu ścieżek względnych, np. REFERENCE.md. Utrzymuj główny plik zwięzły – Claude wczyta go automatycznie przy starcie. 4. Gdy zapytasz Claude'a o szczegóły, system automatycznie załaduje odpowiedni plik referencyjny z żądanym materiałem. Nie musisz ręcznie wskazywać, które pliki mają być wczytane. 5. Stosuj opisowe nazwy plików (WORKFLOWS.md zamiast doc1.md) i dodaj spis treści do plików dłuższych niż 100 linii, aby ułatwić nawigację. 6. Monitoruj użycie tokenów – ten wzorzec zmniejsza zużycie, ponieważ szczegółowe materiały są ładowane tylko na żądanie, a nie na starcie umiejętności.