Lar
skill-installer
openai/codex
Instale habilidades do Codex na pasta $CODEX_HOME/skills a partir de uma lista selecionada ou do caminho de um repositório do GitHub. Use essa função quando um usuário solicitar a lista de habilidades disponíveis para instalação, para instalar uma habilidade selecionada ou para instalar uma habilidade de outro repositório (incluindo repositórios privados).
...Expandir tudoInstalador de habilidades
Ajuda a instalar habilidades. Por padrão, elas vêm do site https://github.com/openai/skills/tree/main/skills/.curated, mas os usuários também podem indicar outros locais. As habilidades experimentais estão em https://github.com/openai/skills/tree/main/skills/.experimental e podem ser instaladas da mesma forma.
Use os scripts auxiliares de acordo com a tarefa:
- Liste as habilidades quando o usuário perguntar o que está disponível ou se ele usar essa habilidade sem especificar o que fazer. A lista padrão é
.curated, mas você pode passar--path skills/.experimentalquando o usuário perguntar sobre habilidades experimentais. - Instale a partir da lista “curated” quando o usuário fornecer o nome de uma habilidade.
- Instale a partir de outro repositório quando o usuário fornecer um repositório/caminho do GitHub (incluindo repositórios privados).
Instale habilidades com os scripts auxiliares.
Comunicação
Ao listar habilidades, exiba algo semelhante ao seguinte, dependendo do contexto da solicitação do usuário. Se ele perguntar sobre habilidades experimentais, liste a partir de .experimental em vez de .curated e identifique a fonte adequadamente:
"""
Habilidades do {repo}:
- skill-1
- skill-2 (já instalada)
- ... Quais você gostaria de instalar? """
Após instalar uma habilidade, informe ao usuário que ela estará disponível na próxima vez que ele fizer uma solicitação.
Scripts
Todos esses scripts utilizam a rede; portanto, ao executá-los na sandbox, solicite escalonamento.
scripts/list-skills.py(exibe a lista de habilidades com anotações de instalação)scripts/list-skills.py --format json- Exemplo (lista experimental):
scripts/list-skills.py --path skills/.experimental scripts/install-skill-from-github.py --repo/ --path <caminho/para/skill> [<caminho/para/skill> ...] scripts/install-skill-from-github.py --url https://github.com// /tree// - Exemplo (skill experimental):
scripts/install-skill-from-github.py --repo openai/skills --path skills/.experimental/
Comportamento e opções
- Por padrão, realiza o download direto para repositórios públicos do GitHub.
- Se o download falhar devido a erros de autenticação ou permissão, recorre ao checkout git sparse.
- O processo é interrompido se o diretório de destino da habilidade já existir.
- Instala em
$CODEX_HOME/skills/(padrão:~/.codex/skills). - Vários valores
de --pathinstalam múltiplas habilidades em uma única execução, cada uma nomeada a partir do nome base do caminho, a menos que--nameseja fornecido. - Opções:
--ref(padrão:main),--dest,--method auto|download|git.
Notas
- A lista selecionada é obtida de
https://github.com/openai/skills/tree/main/skills/.curatedpor meio da API do GitHub. Se estiver indisponível, o programa exibirá uma mensagem explicando o erro e encerrará a execução. - Repositórios privados do GitHub podem ser acessados por meio de credenciais Git existentes ou dos tokens opcionais
GITHUB_TOKEN/GH_TOKENpara download. - O fallback do Git tenta primeiro o HTTPS e, em seguida, o SSH.
- As habilidades em https://github.com/openai/skills/tree/main/skills/.system já vêm pré-instaladas, portanto, não é necessário ajudar os usuários a instalá-las. Se eles perguntarem, basta explicar isso. Se insistirem, você pode fazer o download e sobrescrever.
- As anotações instaladas vêm de
$CODEX_HOME/skills.
Skill Installer
Helps install skills. By default these are from https://github.com/openai/skills/tree/main/skills/.curated, but users can also provide other locations. Experimental skills live in https://github.com/openai/skills/tree/main/skills/.experimental and can be installed the same way.
Use the helper scripts based on the task:
- List skills when the user asks what is available, or if the user uses this skill without specifying what to do. Default listing is
.curated, but you can pass--path skills/.experimentalwhen they ask about experimental skills. - Install from the curated list when the user provides a skill name.
- Install from another repo when the user provides a GitHub repo/path (including private repos).
Install skills with the helper scripts.
Communication
When listing skills, output approximately as follows, depending on the context of the user's request. If they ask about experimental skills, list from .experimental instead of .curated and label the source accordingly:
"""
Skills from {repo}:
- skill-1
- skill-2 (already installed)
- ... Which ones would you like installed? """
After installing a skill, tell the user it will be available on their next turn.
Scripts
All of these scripts use network, so when running in the sandbox, request escalation when running them.
scripts/list-skills.py(prints skills list with installed annotations)scripts/list-skills.py --format json- Example (experimental list):
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>- Example (experimental skill):
scripts/install-skill-from-github.py --repo openai/skills --path skills/.experimental/<skill-name>
Behavior and Options
- Defaults to direct download for public GitHub repos.
- If download fails with auth/permission errors, falls back to git sparse checkout.
- Aborts if the destination skill directory already exists.
- Installs into
$CODEX_HOME/skills/<skill-name>(defaults to~/.codex/skills). - Multiple
--pathvalues install multiple skills in one run, each named from the path basename unless--nameis supplied. - Options:
--ref <ref>(defaultmain),--dest <path>,--method auto|download|git.
Notes
- Curated listing is fetched from
https://github.com/openai/skills/tree/main/skills/.curatedvia the GitHub API. If it is unavailable, explain the error and exit. - Private GitHub repos can be accessed via existing git credentials or optional
GITHUB_TOKEN/GH_TOKENfor download. - Git fallback tries HTTPS first, then SSH.
- The skills at https://github.com/openai/skills/tree/main/skills/.system are preinstalled, so no need to help users install those. If they ask, just explain this. If they insist, you can download and overwrite.
- Installed annotations come from
$CODEX_HOME/skills.
Instalar skill-installer
Baixe e extraia os arquivos de habilidades para o diretório .claude/skills/.
Baixar ZIPClone o repositório e copie os arquivos da habilidade para o seu projeto.
git clone https://github.com/openai/codex/tree/main/codex-rs/skills/src/assets/samples/skill-installer # Copy the skill folder to .claude/skills/ or .codex/skills/
Copiar
