Instalador de Skills

O que Instalador de Skills faz?

Ajuda a instalar skills. Por padrão, estas são originárias de https://github.com/openai/skills/tree/main/skills/.curated, mas os usuários também podem fornecer outros locais. Skills experimentais ficam 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 ele perguntar sobre skills experimentais.
• Instalar a partir da lista curada quando o usuário fornecer um nome de skill.
• Instalar a partir 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 a seguinte, dependendo do contexto da solicitação do usuário. Se ele perguntar sobre skills experimentais, liste a partir de .experimental em vez de .curated e rotule a fonte de acordo: """ Skills de {repo}:

1. skill-1
2. skill-2 (já instalada)
3. ... Quais você gostaria que fossem instaladas? """

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

Scripts

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

• scripts/list-skills.py (imprime a lista de skills 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 <dono>/<repo> --path <caminho/para/skill> [<caminho/para/skill> ...]
• scripts/install-skill-from-github.py --url https://github.com/<dono>/<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: download direto para repositórios públicos do GitHub.
• Se o download falhar com erros de autenticação/permissão, recorre à clonagem seletiva (sparse checkout) do git.
• Interrompe se o diretório de destino da skill já existir.
• Instala em $CODEX_HOME/skills/<nome-da-skill> (padrão: ~/.codex/skills).
• Múltiplos valores --path instalam várias skills em uma única 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 não estiver disponível, explique o erro e saia.
• Repositórios privados do GitHub podem ser acessados por meio de credenciais git existentes ou GITHUB_TOKEN/GH_TOKEN opcionais para download.
• A opção de 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.
• As anotações de instalação vêm de $CODEX_HOME/skills.