Skills Installer CLI

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

🔐 Como Funciona

1. Usuário executa: 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. Instalação: Seleciona e instala skills desejadas
5. Sessão: Login válido por 7 dias (não precisa autenticar toda vez)

🚀 Uso (Para Usuários Finais)

# Executar (primeira vez - abrirá navegador para login):
npx @agencialiveseo/skill-cli

# Próximas execuções (sessão ativa - sem login):
npx @agencialiveseo/skill-cli

# Fazer logout:
npx @agencialiveseo/skill-cli logout

Requisitos:

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

🛡️ 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.js
6. Publicar no npm

1. Criar Repositório de Skills

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

liveseo-skills/
├── skills/
│   ├── python-optimizer/
│   │   ├── SKILL.md
│   │   ├── skill.json
│   │   └── README.md
│   ├── react-components/
│   │   ├── SKILL.md
│   │   └── skill.json
│   └── ...
└── README.md

Exemplo de skill.json:

{
  "name": "python-optimizer",
  "version": "1.0.0",
  "description": "Otimiza código Python automaticamente",
  "author": "Agência LiveSEO",
  "tags": ["python", "optimization", "performance"]
}

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.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 | | 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

# Testar localmente
node cli.js

🤝 Contribuindo

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

📝 Licença

MIT