Instalador de Skills

O que Instalador de Skills faz?

Ajuda a instalar skills. Por padrão, elas vêm de https://github.com/openai/skills/tree/main/skills/.curated, mas os usuários também podem fornecer outras localizações. Skills experimentais estão em https://github.com/openai/skills/tree/main/skills/.experimental e podem ser instaladas da mesma forma.

Use os scripts auxiliares com base na tarefa:

• Listar skills quando o usuário perguntar o que está disponível, ou se o usuário usar esta skill sem especificar o que fazer. A listagem padrão é .curated, mas você pode passar --path skills/.experimental quando eles perguntarem sobre skills experimentais.
• Instalar a partir da lista curada quando o usuário fornecer um nome de skill.
• Instalar de outro repositório quando o usuário fornecer um repositório/caminho do GitHub (incluindo repositórios privados).

Instale skills com os scripts auxiliares.

Comunicação

Ao listar skills, a saída deve ser aproximadamente como a seguir, dependendo do contexto da solicitação do usuário. Se eles perguntarem sobre skills experimentais, liste de .experimental em vez de .curated e indique a fonte de acordo:

Skills de {repo}:
1. skill-1
2. skill-2 (já instalada)
3. ...
Quais você gostaria de instalar?

Após instalar uma skill, informe ao usuário que ela estará disponível na próxima vez que ele interagir.

Scripts

Todos esses scripts usam rede, portanto, ao executar no sandbox, solicite escalonamento ao executá-los.

• scripts/list-skills.py (imprime a lista de skills com anotações de instaladas)
• scripts/list-skills.py --format json
• Exemplo (lista experimental): scripts/list-skills.py --path skills/.experimental
• scripts/install-skill-from-github.py --repo <proprietario>/<repo> --path <caminho/para/skill> [<caminho/para/skill> ...]
• scripts/install-skill-from-github.py --url https://github.com/<proprietario>/<repo>/tree/<ref>/<caminho>
• Exemplo (skill experimental): scripts/install-skill-from-github.py --repo openai/skills --path skills/.experimental/<nome-da-skill>

Comportamento e Opções

• Padrão é baixar diretamente para repositórios públicos do GitHub.
• Se o download falhar com erros de autenticação/permissão, faz fallback para git sparse checkout.
• Aborta se o diretório de skill de destino já existir.
• Instala em $CODEX_HOME/skills/<nome-da-skill> (padrão ~/.codex/skills).
• Múltiplos valores --path instalam várias skills em uma execução, cada uma nomeada a partir do nome base do caminho, a menos que --name seja fornecido.
• Opções: --ref <ref> (padrão main), --dest <caminho>, --method auto|download|git.

Notas

• A listagem curada é obtida de https://github.com/openai/skills/tree/main/skills/.curated via API do GitHub. Se estiver indisponível, explique o erro e saia.
• Repositórios privados do GitHub podem ser acessados via credenciais git existentes ou variáveis de ambiente opcionais GITHUB_TOKEN/GH_TOKEN para download.
• O fallback git tenta HTTPS primeiro, depois SSH.
• As skills em https://github.com/openai/skills/tree/main/skills/.system são pré-instaladas, portanto não é necessário ajudar os usuários a instalá-las. Se eles perguntarem, apenas explique isso. Se insistirem, você pode baixar e sobrescrever.
• Anotações de instaladas vêm de $CODEX_HOME/skills.