@crewhu/agent-skills

CLI para instalar Agent Skills da Crewhu em projetos Claude Code.

Como usar

# Listar skills disponíveis
npx @crewhu/agent-skills list

# Instalar uma skill
npx @crewhu/agent-skills install --skill spec-driven

# Remover uma skill
npx @crewhu/agent-skills uninstall --skill spec-driven

Ao instalar, os arquivos da skill são copiados para .claude/skills/<nome>/ no projeto atual.

Estrutura do projeto

crewhu-agent-skills/
├── package.json          ← Pacote npm com "bin" apontando pro CLI
├── bin/
│   └── cli.js            ← CLI principal (JavaScript puro, zero deps)
└── skills/               ← Catálogo de skills
    └── spec-driven/
        ├── SKILL.md      ← Instruções da skill (lidas pelo Claude)
        └── skill.json    ← Metadados (nome, versão, descrição)

Como adicionar uma nova skill

1. Crie uma pasta em skills/<nome-da-skill>/
2. Adicione um SKILL.md com as instruções para o Claude
3. Adicione um skill.json com metadados:

   {
     "name": "nome-da-skill",
     "version": "1.0.0",
     "description": "Descrição curta da skill"
   }

4. Publique nova versão: npm version patch && npm publish

Como publicar no npm

# 1. Criar org @crewhu no npmjs.com (uma vez só)
# 2. Login
npm login

# 3. Publicar
npm publish --access public

Depois disso, qualquer pessoa pode instalar com:

npx @crewhu/agent-skills install --skill spec-driven

Como testar localmente (sem publicar)

# Opção 1: rodar direto
node bin/cli.js list
node bin/cli.js install --skill spec-driven

# Opção 2: npm link (simula npx global)
npm link
crewhu-skills list
crewhu-skills install --skill spec-driven