Umiejętność (skills) to supermoc dla asystenta: krótki zestaw instrukcji, który uczy go dobrze wykonywać jedno zadanie. W Codexie umiejętność to folder z plikiem SKILL.md w środku. Plik musi mieć name i description. Na początku Codex czyta tylko nazwę i opis. Pełne instrukcje wczytuje dopiero wtedy, gdy zdecyduje się użyć umiejętności.
Codex stosuje otwarty standard Agent Skills, więc wiele folderów z umiejętnościami działa w więcej niż jednym asystencie.
Opcja A: zainstaluj gotową umiejętność
Uruchom instalator umiejętności
Uruchom Codexa komendą codex. Potem wpisz instalator razem z nazwą umiejętności. OpenAI w swoim przykładzie instaluje umiejętność linear:
$skill-installer linearMożesz też poprosić instalator zwykłymi słowami, żeby pobrał umiejętność z innego repozytorium (folderu projektu na stronie takiej jak GitHub).
Zrestartuj, jeśli umiejętności brakuje
Codex sam znajduje nowe umiejętności. Jeśli nowa umiejętność się nie pojawi, zamknij Codexa komendą /quit i uruchom codex jeszcze raz.
Opcja B: skopiuj folder umiejętności ręcznie
Włóż folder do folderu z umiejętnościami
Codex szuka umiejętności w tych miejscach:
| Gdzie | Ścieżka | Działa w |
|---|---|---|
| Osobiste | $HOME/.agents/skills | Wszystkich projektach |
| Projekt | .agents/skills w folderze projektu | Tylko w tym projekcie |
$HOME to folder domowy. Skopiuj cały folder umiejętności, razem z plikiem SKILL.md, do jednej z tych ścieżek.
Przeczytaj plik SKILL.md
Zanim użyjesz umiejętności, otwórz SKILL.md w edytorze tekstu. Pole description mówi Codexowi, kiedy użyć umiejętności. Reszta to instrukcje, których Codex będzie przestrzegać. Folder umiejętności może też zawierać skrypty (małe programy), więc używaj tylko umiejętności od osób, którym ufasz.
Użyj umiejętności
Są dwa sposoby:
- Wpisz
/skillsi wybierz umiejętność z listy. - Wpisz
$i nazwę umiejętności w swojej prośbie.
Codex może też sam wybrać umiejętność, gdy Twoja prośba pasuje do opisu umiejętności.
Wyłącz umiejętność
Żeby wyłączyć umiejętność bez jej usuwania, OpenAI pokazuje taki wpis dla pliku ustawień ~/.codex/config.toml:
[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = falsePo zmianie pliku zrestartuj Codexa.
Umiejętności, które sprawdziliśmy, znajdziesz na naszej liście umiejętności. Jeśli chcesz porównać umiejętności z agentami i konektorami, przeczytaj Umiejętności, agenci i konektory – wyjaśnienie.
Źródła
- developers.openai.com/codex/skills
- developers.openai.com/codex/cli/slash-commands