Grimoire

Instalarea skill-urilor Codex cu Skill Installer

3 min read

Instalarea skill-urilor Codex cu Skill Installer

Ce face

skill-installer instalează skill-uri Codex în directorul din care Codex le poate încărca la următorul turn: $CODEX_HOME/skills. Dacă $CODEX_HOME nu este setat, folosește implicit ~/.codex/skills.

Implicit, listează și instalează skill-uri din lista curatoriată publică:

https://github.com/openai/skills/tree/main/skills/.curated

Poate lucra și cu skill-uri experimentale din:

https://github.com/openai/skills/tree/main/skills/.experimental

Mai poate instala skill-uri din alte repo-uri GitHub, inclusiv private, dar numai dacă runtime-ul are deja acces prin credențiale git existente sau prin GITHUB_TOKEN / GH_TOKEN. Nu obține singur acces, nu creează token-uri și nu trebuie să inventeze o listă când GitHub nu răspunde.

Ghidul acesta e unul dintre ghidurile zilnice: All guides.

Când îmi folosește

Îl folosești când vrei să adaugi skill-uri Codex fără să copiezi manual directoare.

Cazurile normale sunt:

  • vrei să vezi skill-urile disponibile în lista curatoriată;
  • vrei să vezi skill-urile experimentale;
  • vrei să instalezi un skill curatoriat după nume;
  • vrei să instalezi unul sau mai multe skill-uri dintr-un repo GitHub;
  • vrei să instalezi un skill dintr-un repo privat la care mediul are deja acces;
  • ai un URL GitHub complet către directorul skill-ului.

Nu este fluxul normal pentru skill-urile din .system. Acestea sunt preinstalate. Dacă întrebi despre ele, răspunsul corect este să ți se explice că nu trebuie instalate. Doar dacă insiști explicit pot fi descărcate și suprascrise.

Cum îl invoc / declanșez

Declanșarea depinde de runtime, dar intenția este simplă: ceri listarea sau instalarea skill-urilor Codex.

Exemple valide:

  • „listează skill-urile instalabile”
  • „ce skill-uri Codex sunt disponibile?”
  • „arată-mi skill-urile experimentale”
  • „instalează skill-ul X”
  • „instalează skill-ul din owner/repo, path path/to/skill”
  • „instalează skill-ul de la URL-ul GitHub acesta”

Scripturile canonice sunt:

scripts/list-skills.py

scripts/list-skills.py --format json

scripts/list-skills.py --path skills/.experimental

scripts/install-skill-from-github.py --repo <owner>/<repo> --path <path/to/skill> [<path/to/skill> ...]

scripts/install-skill-from-github.py --url https://github.com/<owner>/<repo>/tree/<ref>/<path>

Pentru un skill experimental:

scripts/install-skill-from-github.py --repo openai/skills --path skills/.experimental/<skill-name>

Toate aceste scripturi folosesc network. În sandbox, rularea lor trebuie făcută cu escaladarea necesară; altfel, rezultatul corect este eroare explicată, nu output fabricat.

Exemplu practic

Pentru lista curatoriată, se rulează listarea implicită:

scripts/list-skills.py

Răspunsul recomandat are forma:

Skills from {repo}:

1. skill-1

2. skill-2 (already installed)

3. ...

Which ones would you like installed?

Pentru skill-uri experimentale, se folosește explicit:

scripts/list-skills.py --path skills/.experimental

și sursa trebuie etichetată ca experimentală, nu prezentată ca listă curatoriată.

Pentru instalare dintr-un repo public:

scripts/install-skill-from-github.py --repo <owner>/<repo> --path <path/to/skill>

Pentru instalare prin URL complet:

scripts/install-skill-from-github.py --url https://github.com/<owner>/<repo>/tree/<ref>/<path>

Pentru instalarea mai multor skill-uri într-o singură rulare:

scripts/install-skill-from-github.py --repo <owner>/<repo> --path <path/one> <path/two>

După instalare, răspunsul trebuie să spună că skill-ul va fi disponibil la următorul turn.

Output / unde aterizează

Skill-urile instalate ajung în:

$CODEX_HOME/skills/<skill-name>

Dacă $CODEX_HOME lipsește, destinația implicită este:

~/.codex/skills/<skill-name>

Numele skill-ului este luat din basename-ul path-ului. Excepția este folosirea opțiunii --name, când numele este dat explicit.

Adnotările de tip (already installed) vin din comparația cu ce există deja în $CODEX_HOME/skills. Dacă directorul destinație al skill-ului există deja, instalarea se oprește; nu suprascrie accidental skill-uri existente.

Limite / gotchas

Listarea curatoriată este citită prin GitHub API din:

https://github.com/openai/skills/tree/main/skills/.curated

Dacă API-ul nu este disponibil, comportamentul corect este să explice eroarea și să iasă. Nu se inventează skill-uri, nu se completează „din memorie” și nu se promite instalare fără verificare.

Pentru repo-uri publice, metoda implicită este direct download. Dacă download-ul eșuează din motive de autentificare sau permisiuni, fallback-ul este git sparse checkout. Fallback-ul git încearcă întâi HTTPS, apoi SSH.

Opțiunile relevante sunt:

--ref <ref> cu default main

--dest <path>

--method auto|download|git

Repo-urile private funcționează doar dacă accesul există deja. Nu se cer sau afișează token-uri în clar. Nu se citesc, copiază sau rezumă credențiale. If auth fails, se raportează eșecul și metoda încercată, nu se maschează problema.

Graph View