pca-skill-manager - SKILL.md Agent Skill

name: pca-skill-manager description: "Acelera a criacao e manutencao de skills do Claude. Automatiza o scaffolding de pastas, validacao de metadados YAML e empacotamento ZIP correto."

Gestor de Habilidades PCA

Visão Geral

Esta habilidade atua como um "Meta-Assistente". Ela ajuda o Engenheiro de Habilidades a criar novas ferramentas para o projeto PCA Camocim sem erros manuais. Ela garante que todas as novas skills sigam o padrão de "Boneca Russa" e passem na validação estrita do Claude.

Ferramentas (Scripts)

Esta skill utiliza scripts Python localizados em scripts/ para gerir o ciclo de vida de outras skills:

Validar (Quick Validate): Verifica se o Skill.md tem chaves inválidas (como version ou dependencies no lugar errado) e se a estrutura de pastas está correta.
```
python scripts/quick_validate.py "caminho/para/nova_skill"
```
Empacotar (Package Skill): Cria o arquivo .zip final pronto para upload, ignorando arquivos desnecessários (.DS_Store, __pycache__) e garantindo que a pasta raiz esteja correta.
```
python scripts/package_skill.py "caminho/para/nova_skill"
```
Iniciar (Init Skill): Cria o esqueleto de uma nova skill com os templates padrão.
```
python scripts/init_skill.py "nome-da-skill"
```

Fluxo de Trabalho Recomendado

Criar uma Nova Habilidade

Quando o usuário disser "Crie uma estrutura para a skill 'pca-analytics'":

Execute init_skill.py para gerar a pasta e o Skill.md básico.
Peça ao usuário as instruções específicas.
Preencha o Skill.md.

Finalizar uma Habilidade

Quando o usuário disser "Empacote a skill 'pca-analytics'":

Execute quick_validate.py para garantir que não haverá rejeição no upload.
Se passar, execute package_skill.py.
Forneça o caminho do ZIP gerado.

Referências

Consulte a pasta references/ para padrões de saída e fluxos de trabalho ideais na criação de agentes.