maojiebc/majia-Popskill

O que majia-Popskill faz?

Gerenciador local de capacidades de IA — gerencie habilidades do Claude Code / Codex em uma única tabela: montagem via symlink · pacotes por fonte · atualização por hash de conteúdo.

Visão Geral

O Popskill é uma ferramenta de linha de comando que centraliza o gerenciamento de habilidades (skills) para agentes de IA como Claude Code e Codex. Com ele, você pode:

• Listar, instalar, remover e atualizar habilidades a partir de um arquivo de configuração (skills.toml).
• Montar habilidades como symlinks, evitando duplicação de arquivos.
• Agrupar habilidades em pacotes por fonte (ex: repositórios Git, diretórios locais).
• Verificar e atualizar habilidades usando hash de conteúdo, garantindo que apenas alterações reais disparem atualizações.

Como Funciona

1. Crie um arquivo skills.toml na raiz do seu projeto com a lista de habilidades desejadas.
2. Execute popskill install para baixar ou referenciar as habilidades.
3. O Popskill cria symlinks em um diretório de saída (ex: .claude/skills/) apontando para os arquivos de habilidade originais.
4. Use popskill update para verificar se há novas versões (baseado em hash ou commits Git).
5. Use popskill list para ver o status de cada habilidade.

Exemplo de Configuração (skills.toml)

[skills]
"agent-tools" = { source = "github:user/repo", path = "skills/agent-tools.md" }
"code-review" = { source = "local:./my-skills", path = "code-review.md" }

Comandos Principais

Comando	Descrição
popskill install	Instala todas as habilidades listadas no skills.toml
popskill update	Atualiza habilidades com base em hash de conteúdo
popskill list	Lista habilidades instaladas e seus status
popskill remove	Remove habilidades específicas ou todas

Requisitos

• Node.js >= 18
• npm ou yarn (para instalação global)

Instalação

npm install -g @maojiebc/popskill

Suporte a Agentes

• Claude Code — usa o diretório .claude/skills/
• Codex — usa o diretório .codex/skills/

Licença

MIT © maojiebc