Skills Installer CLI

CLI para instalar e gerenciar skills nas IDEs (Cursor, Claude Code, Antigravity) com autenticação Google OAuth.

🔐 Como Funciona

1. Usuário executa: liveseo-skills (global) ou npx @agencialiveseo/skill-cli
2. Autenticação: Abre navegador automaticamente para login com Google
3. Validação: Apenas emails @liveseo.com.br são aceitos
4. Ação: Escolha entre Instalar, Atualizar ou Desinstalar skills
5. Sessão: Login válido por 7 dias (não precisa autenticar toda vez)

🚀 Uso (Para Usuários Finais)

Instalação Global (recomendado)

Instale uma vez e use o comando liveseo-skills de qualquer lugar:

npm install -g @agencialiveseo/skill-cli

Depois é só executar:

# Abrir o menu principal (instalar, atualizar ou desinstalar):
liveseo-skills

# Exibir tela de boas-vindas:
liveseo-skills --demo

# Fazer logout:
liveseo-skills logout

# Desinstalar skills diretamente:
liveseo-skills uninstall

Sem instalação (via npx)

npx @agencialiveseo/skill-cli

Requisitos:

• Email corporativo @liveseo.com.br
• Navegador web
• Node.js 14+

📋 Fluxo de Uso

Ao executar liveseo-skills, o menu principal oferece três opções:

| Ação | Descrição | |---|---| | Instalar nova skill | Navega por categorias e instala skills no(s) IDE(s) selecionado(s) | | Atualizar skills instaladas | Detecta skills com versão desatualizada e reinstala | | Desinstalar skill | Remove skills instaladas de um IDE específico |

Após cada operação, o CLI pergunta se deseja continuar ou sair — sem precisar redigitar o comando.

🛡️ Segurança

✅ Sem tokens para usuários - Credenciais ficam protegidas via GitHub Secrets ✅ Controle de acesso - Só emails @liveseo.com.br podem usar ✅ Read-only - Token GitHub tem permissão apenas de leitura ✅ Sessão local - Armazenada com segurança em ~/.skills-session ✅ Expiração - Sessão expira após 7 dias

🛠️ Setup (Para Desenvolvedores)

Configuração Completa

Para configurar Google OAuth e publicar a CLI, siga o guia detalhado:

📘 GOOGLE_OAUTH_SETUP.md - Guia completo passo a passo

Resumo rápido:

1. Criar projeto no Google Cloud Console
2. Configurar OAuth Consent Screen (Internal para Workspace)
3. Criar OAuth Client ID com redirect para http://localhost:3000/callback
4. Configurar credenciais — local: .env | CI: GitHub Secrets (ver abaixo)
5. Criar token GitHub (read-only) e configurar em lib/installer-core.js
6. Publicar no npm

1. Criar Repositório de Skills

Crie um repositório no GitHub chamado liveseo-skills com esta estrutura:

liveseo-skills/
├── tecnico/
│   ├── nome-da-skill/
│   │   ├── SKILL.md
│   │   └── skill.json
│   └── ...
├── conteudo/
├── qualidade/
└── outros/

Exemplo de skill.json:

{
  "name": "Nome da Skill",
  "version": "1.0.0",
  "description": "Descrição da skill",
  "category": "tecnico",
  "author": "Agência LiveSEO",
  "tags": ["seo", "tecnico"]
}

O campo category é utilizado pelo fluxo de atualização para localizar a skill remotamente.

2. Configurar package.json

{
  "name": "@agencialiveseo/skill-cli",
  "repository": {
    "type": "git",
    "url": "git+https://github.com/agencialiveseo/skill-cli-oauth.git"
  }
}

No arquivo lib/installer-core.js, confirme as constantes:

const GITHUB_ORG  = 'agencialiveseo';
const GITHUB_REPO = 'liveseo-skills';

3. Configurar GitHub Secrets

Acesse: Repositório → Settings → Secrets and variables → Actions

| Secret | Descrição | |---|---| | GOOGLE_CLIENT_ID | OAuth Client ID do Google Cloud Console | | GOOGLE_CLIENT_SECRET | OAuth Client Secret | | SKILLS_JWT_SECRET | String aleatória para assinar sessões locais | | GTHB_TOKEN | Token GitHub read-only para acessar o repositório de skills | | NPM_TOKEN | Token de publicação do npmjs.com |

4. Publicar no npm

Opção A: Manual

npm install
npm publish --access public

Opção B: Automático (via GitHub Actions)

Basta criar uma tag:

npm version patch
git push origin --tags

O GitHub Actions injeta as credenciais e publica automaticamente.

📦 Skills Disponíveis

Gerenciadas no repositório agencialiveseo/liveseo-skills.

🔧 Desenvolvimento Local

# Instalar dependências
npm install

# Copiar e preencher variáveis de ambiente
cp .env.example .env
# Edite .env com GTHB_TOKEN e as credenciais OAuth

# Testar diretamente
node cli.js

# Ou testar como instalação global
npm link
liveseo-skills
npm unlink -g @agencialiveseo/skill-cli  # para desfazer

🤝 Contribuindo

1. Fork o projeto
2. Crie uma branch (git checkout -b feature/nova-funcionalidade)
3. Commit suas mudanças (git commit -am 'Add nova funcionalidade')
4. Push para a branch (git push origin feature/nova-funcionalidade)
5. Abra um Pull Request

📝 Licença

MIT