Napisz umiejętność wielokrotnego użytku
Na tej stronie
Jeśli instrukcje GPT są jego sercem, to umiejętność (skill) jest sercem wtyczki. To format, którego używasz do zapisania przepływu pracy wielokrotnego użytku: instrukcji, zasobów i w razie potrzeby skryptów. Umiejętności OpenAI遵循 otwarty standard zwany „agent skills“ (agentskills.io), co oznacza, że dobrze napisana umiejętność nie jest zablokowana w ramach jednego narzędzia. Ta lekcja nauczy cię, jak taką napisać.
Anatomia umiejętności
Umiejętność to folder zawierający jeden wymagany plik, SKILL.md, oraz elementy opcjonalne.
synthese-document/
├── SKILL.md ← wymagane: instrukcje + metadane
├── scripts/ ← opcjonalne: kod wykonywalny
├── references/ ← opcjonalne: dokumentacja
├── assets/ ← opcjonalne: szablony, zasoby
└── agents/
└── openai.yaml ← opcjonalne: wygląd i zależności
Plik SKILL.md musi zawierać pola name i description. Oto minimalny przykład:
---
name: synthese-document
description: Podsumowuje dostarczony dokument w trzech częściach (przegląd, kluczowe punkty, otwarte pytania). Używaj, gdy użytkownik poprosi o podsumowanie lub raport z załączonego dokumentu.
---
# Podsumowanie dokumentu
1. Przeczytaj cały dokument przed rozpoczęciem pisania.
2. Napisz trzy sekcje: Przegląd (3 zdania), Kluczowe punkty (maks. 5 punktów), Otwarte pytania.
3. Polegaj wyłącznie na dokumencie; jeśli brakuje informacji, napisz „nie podano“.
4. Do formatowania użyj szablonu z `assets/modele.md`.
Opis jest kluczowy
ChatGPT i Codex aktywują umiejętność na dwa sposoby. Albo wywołujesz ją jawnie – wpisując @ w ChatGPT lub /skills i $ w Codex – albo narzędzie wybiera ją automatycznie, gdy twoje żądanie pasuje do jej opisu. Dlatego dokumentacja kładzie nacisk na to pole: potrzebujesz zwięzłego opisu, który zaczyna się od głównego przypadku użycia i słów wyzwalających, oraz jasno określa jego ograniczenia.
Konkretny mechanizm napędza to wymaganie: postępujące ujawnianie (progressive disclosure). Początkowo ChatGPT i Codex odczytują tylko nazwę i opis każdej zainstalowanej umiejętności; pełne instrukcje z SKILL.md ładują dopiero, gdy faktycznie używają umiejętności. Pozwala to zainstalować wiele umiejętności bez zapychania kontekstu, ale oznacza też, że niejasny opis prowadzi do umiejętności, która albo nigdy nie zostanie wybrana we właściwym momencie, albo zostanie wybrana w złym czasie.
Ustawienia opcjonalne
Plik agents/openai.yaml pozwala dopracować wyświetlanie w aplikacji desktopowej (nazwa, krótki opis, ikony, kolor, domyślny monit), zadeklarować narzędzia, od których zależy umiejętność – na przykład serwer MCP – oraz ustawić politykę wywoływania. Ustawienie allow_implicit_invocation: false zapobiega samodzielnemu wybieraniu umiejętności przez ChatGPT: przydatne w przypadku wrażliwych przepływów pracy, które chcesz uruchamiać tylko na żądanie.
Gdzie żyją umiejętności i jak je udostępniać
Samodzielna umiejętność działa w aplikacji desktopowej ChatGPT, w Codex przez wiersz poleceń oraz w rozszerzeniu edytora; w Codex umiejętności projektu trafiają do folderu .agents/skills w repozytorium. Aby udostępnić umiejętność innym, OpenAI zaleca spakowanie jej w wtyczkę: wtyczka może łączyć wiele umiejętności i dodawać połączenia do serwerów MCP lub elementy prezentacyjne. Umiejętności zawarte we wtyczce stają się wtedy dostępne w trybach Chat i Work w ChatGPT, w sieci, na komputerze i urządzeniach mobilnych. W ChatGPT w sieci zakładka Skills w katalogu wtyczek pozwala również utworzyć umiejętność poprzez rozmowę (używając wbudowanej umiejętności skill-creator), w edytorze lub przez import, oraz udostępnić ją w ramach swojego obszaru roboczego; ta zakładka jest zarezerwowana dla kwalifikujących się planów Business, Enterprise, Healthcare i Edu.
Twoja kolej
Od GPT do umiejętności. Weź instrukcje z GPT, którego zbudowałeś w lekcjach od 4 do 7. Przekształć je w SKILL.md: krótka nazwa, opis mówiący, kiedy jej używać, a kiedy nie, ponumerowane kroki oraz twoje pliki wiedzy przechowywane w references/. Następnie przetestuj umiejętność dwukrotnie: raz, wywołując ją przez @, a raz za pomocą zwykłego żądania, które powinno ją uruchomić.
Źródła oficjalne: Build skills (dokumentacja ChatGPT: SKILL.md, opis, lokalizacje) · Skills in ChatGPT (Centrum pomocy OpenAI: zakładka Skills, plany, udostępnianie)
Kluczowe wnioski
- Umiejętność to folder z plikiem
SKILL.md(wymagane nazwa + opis) i opcjonalnymi zasobami; przestrzega otwartego standardu agent skills - Opis decyduje o tym, kiedy umiejętność zostanie wybrana: zacznij od przypadku użycia, słów wyzwalających i ograniczeń
- Postępujące ujawnianie: najpierw czytane są tylko nazwa i opis; instrukcje ładują się w momencie użycia
- Aby udostępnić umiejętność, spakuj ją we wtyczkę
Sprawdź swoją wiedzę
Od GPT do wtyczek: zweryfikuj całą podróż.
1. Custom Instructions, Memory, GPT: jaka jest różnica?
Odpowiedź: Custom Instructions barwią wszystkie twoje rozmowy; Memory przechowuje fakty o tobie w czasie; GPT to zapakowany asystent – instrukcje, wiedza, narzędzia – udostępnialny innym.
2. Co powinna zawierać dobra instrukcja systemowa GPT?
Odpowiedź: Rolę, zakres (co robi, a czego nie), ton, format odpowiedzi i obsługę przypadków brzegowych – napisaną jak opis stanowiska, a nie lista życzeń.
3. Do czego służy baza wiedzy?
Odpowiedź: Do dostarczania GPT dokumentów referencyjnych, które konsultuje, aby odpowiedzieć – twoich przewodników, katalogów lub procedur, zamiast polegać wyłącznie na pamięci treningowej.
4. Co dzieje się z akcjami GPT podczas migracji do wtyczki?
Odpowiedź: Nie są przenoszone: musisz sprawdzić, czy aplikacja już istnieje w katalogu wtyczek, w przeciwnym razie odbuduj integrację, na przykład za pomocą serwera MCP. Instrukcje stają się umiejętnością, a baza wiedzy plikami referencyjnymi.
5. Co sprawdzasz przed udostępnieniem GPT lub wtyczki?
Odpowiedź: Testy na rzeczywistych przypadkach i przypadkach brzegowych, zgodność z politykami użytkowania, jasność opisu, politykę prywatności dla każdej publicznej akcji oraz upewnienie się, że w instrukcjach lub plikach nie czają się dane wrażliwe.
Udostępnione narzędzie zobowiązuje twórcę: testuj tak, jakby twoi użytkownicy już tam byli, i zmigruj swoje GPT przed 11 grudnia 2026 r.