Skill Installer v3.0

Visão Geral

Instala, valida, registra e verifica novas skills no ecossistema. 10 checks de segurança, cópia, registro no orchestrator e verificação pós-instalação.

Quando Usar Esta Skill

• Quando o usuário mencionar "instalar skill" ou tópicos relacionados
• Quando o usuário mencionar "install skill" ou tópicos relacionados
• Quando o usuário mencionar "registrar skill" ou tópicos relacionados
• Quando o usuário mencionar "nova skill" ou tópicos relacionados
• Quando o usuário mencionar "new skill" ou tópicos relacionados
• Quando o usuário mencionar "adicionar skill ao ecossistema" ou tópicos relacionados

Não Use Esta Skill Quando

• A tarefa não está relacionada ao instalador de skills
• Uma ferramenta mais simples e específica pode atender à solicitação
• O usuário precisa de assistência de propósito geral sem conhecimento de domínio

Como Funciona

Agente instalador de nível empresarial que garante que toda skill criada (via skill-creator ou manualmente) seja corretamente instalada, registrada e verificada no ecossistema. Inclui auto-reparo, rollback, dry-run, dashboard e diagnóstico avançado.

Princípio: Redundância Máxima

Seis camadas de validação garantem que nenhuma skill fique mal-instalada:

Localização

C:\Users\renat\skills\skill-installer\
├── SKILL.md              <- este arquivo
├── scripts/
│   ├── install_skill.py  <- instalador principal (11 passos) + todos os comandos
│   ├── detect_skills.py  <- scanner de skills nao-instaladas
│   ├── validate_skill.py <- validacao profunda (10 checks)
│   ├── package_skill.py  <- empacotador ZIP + verificador de integridade
│   └── requirements.txt
├── references/
│   └── known-locations.md
└── data/
    ├── install_log.json  <- log de operacoes (auto-gerado, com rotacao)
    ├── backups/          <- backups antes de sobrescrever
    └── staging/          <- area temporaria para copias seguras

Fluxo de Trabalho Principal

Quando esta skill for ativada, siga estes passos na ordem:

Cenário 1: Após o Skill-Creator Finalizar

O skill-creator acabou de criar uma skill em algum diretório. Execute:

python C:\Users\renat\skills\skill-installer\scripts\install_skill.py --source "<caminho-da-skill-criada>" --force

Substitua <caminho-da-skill-criada> pelo diretório onde o skill-creator salvou a skill.

Cenário 2: Usuário Pede Para Instalar Uma Skill Específica

python C:\Users\renat\skills\skill-installer\scripts\install_skill.py --source "<caminho>" [--name "nome-override"] [--force]

Cenário 3: Simular Instalação Sem Fazer Nada (Dry-Run)

python C:\Users\renat\skills\skill-installer\scripts\install_skill.py --source "<caminho>" --dry-run

Mostra exatamente o que seria feito em cada um dos 11 passos, sem alterar nenhum arquivo.

Cenário 4: Detectar E Instalar Skills Pendentes

python C:\Users\renat\skills\skill-installer\scripts\install_skill.py --detect
python C:\Users\renat\skills\skill-installer\scripts\install_skill.py --detect --auto

Escaneia locais conhecidos (Desktop, Downloads, Temp, workspaces) e apresenta candidatos com timestamps e tamanho. Com --auto instala todos automaticamente.

Cenário 5: Desinstalar Uma Skill

python C:\Users\renat\skills\skill-installer\scripts\install_skill.py --uninstall "nome-da-skill"

Remove de skills/, .claude/skills/, atualiza o registry e remove ZIP do Desktop. Backup automático é feito antes da remoção.

Cenário 6: Health Check + Auto-Repair

python C:\Users\renat\skills\skill-installer\scripts\install_skill.py --health
python C:\Users\renat\skills\skill-installer\scripts\install_skill.py --health --repair

--health verifica TODAS as skills: frontmatter, registro, registry, duplicatas. --health --repair encontra problemas E os corrige automaticamente:

• Skills não registradas -> registra
• Skills faltando no registry -> atualiza
• Duplicatas -> remove

Cenário 7: Rollback (Restaurar De Backup)

python C:\Users\renat\skills\skill-installer\scripts\install_skill.py --rollback "nome-da-skill"

…