npm package: @ruyfranca/myskills
Description: Biblioteca de skills customizadas para Antigravity / Claude Code
Author: Ruy
Latest version: 1.0.35

# mySkills

Biblioteca de skills, agents e workflows especializados para o **Antigravity**.

## ⚡ Quick Start

> Execute esses dois comandos em qualquer projeto para ativar o kit completo:

```bash
npx @ruyfranca/myskills init && npx @ruyfranca/myskills install-global
```

- `init` → instala a pasta `.agent/` (skills, agents, workflows) no projeto atual
- `install-global` → instala os workflows em `~/.gemini/antigravity/global_workflows/` para o menu `/` do Antigravity

> **Após rodar, feche e reabra o Antigravity.** Os comandos `/brainstorm`, `/debug`, `/plan` e todos os outros estarão disponíveis.

---

## 🚀 Skills Disponíveis

### [Product Manager](file:///Users/ruy/Code/mySkills/.agent/skills/product-manager/SKILL.md)
Uma skill de Senior Product Manager focada em:
- **Estratégia**: Desenvolvimento de visão e posicionamento de mercado.
- **Priorização**: Frameworks como RICE e análise de Valor vs. Complexidade.
- **Discovery**: Pesquisa de usuários e validação de problemas.
- **Execução**: Planejamento de roadmaps e coordenação de lançamentos.

### [Brainstorming](file:///Users/ruy/Code/mySkills/.agent/skills/brainstorming/SKILL.md)
Um processo de design colaborativo focado em:
- **Exploração**: Refinamento de ideias através de perguntas sequenciais.
- **Alternativas**: Proposta de múltiplos caminhos com análise de trade-offs.
- **Simplicidade**: Aplicação do princípio YAGNI para evitar complexidade desnecessária.

### [Senior Frontend](file:///Users/ruy/Code/mySkills/.agent/skills/senior-frontend/SKILL.md)
Toolkit completo para desenvolvimento frontend moderno:
- **Especialidade**: React, Next.js, TypeScript e Tailwind CSS.
- **Performance**: Análise de bundles e guias de otimização.
- **Ferramentas**: Scripts para geração de componentes e scaffolding.
- **Referências**: Guias detalhados de padrões e boas práticas.

### [Code Reviewer](file:///Users/ruy/Code/mySkills/.agent/skills/code-reviewer/SKILL.md)
Especialista em qualidade de código e padrões:
- **Análise**: Revisão de Pull Requests e identificação de anti-padrões.
- **Ferramentas**: Scripts para verificação de qualidade e geração de relatórios.
- **Checklists**: Guias passo a passo para revisões consistentes.

### [Systematic Debugging](file:///Users/ruy/Code/mySkills/.agent/skills/systematic-debugging/SKILL.md)
Processo rigoroso para resolução de bugs:
- **Metodologia**: Abordagem científica para isolamento e causa raiz.
- **Recursos**: Guias de tracing e "Defense in Depth".
- **Estratégia**: Fluxos específicos para depuração sob pressão.

### [Test-Driven Development (TDD)](file:///Users/ruy/Code/mySkills/.agent/skills/test-driven-development/SKILL.md)
Fluxo de desenvolvimento orientado a testes:
- **Ciclo**: Guia completo do Red-Green-Refactor.
- **Qualidade**: Prevenção de anti-padrões de teste e foco em design.

### [Business Analyst](file:///Users/ruy/Code/mySkills/.agent/skills/business-analyst/SKILL.md)
...
### [PDF Processing Pro](file:///Users/ruy/Code/mySkills/.agent/skills/pdf-processing-pro/SKILL.md)
Processamento avançado de documentos PDF:
- **Automação**: Preenchimento de formulários com validação e OCR.
- **Extração**: Detecção inteligente de tabelas e metadados.
- **Produção**: Scripts prontos para processamento em lote.

### [Canvas Design](file:///Users/ruy/Code/mySkills/.agent/skills/canvas-design/SKILL.md)
Criação de arte visual de alto nível:
- **Filosofia**: Design baseado em manifestos estéticos.
- **Qualidade**: Geração de arte em PDF/PNG com nível de museu.
- **Tipografia**: Uso de biblioteca de fontes profissionais.

### [XLSX Automation](file:///Users/ruy/Code/mySkills/.agent/skills/xlsx/SKILL.md)
Especialista em automação e análise de planilhas:
- **Modelagem**: Criação de modelos financeiros dinâmicos com fórmulas.
- **Validação**: Scripts de recálculo e checagem de erros.
- **Padrões**: Formatação profissional e boas práticas de dados.

### [PPTX Automation](file:///Users/ruy/Code/mySkills/.agent/skills/pptx/SKILL.md)
...
### [Senior Fullstack](file:///Users/ruy/Code/mySkills/.agent/skills/senior-fullstack/SKILL.md)
...
### [Senior Prompt Engineer](file:///Users/ruy/Code/mySkills/.agent/skills/senior-prompt-engineer/SKILL.md)
Especialista em orquestração de LLMs e sistemas agenticos:
- **Otimização**: Refinamento de prompts e redução de alucinações.
- **Arquitetura**: Design de sistemas RAG e loops autônomos.
- **Avaliação**: Frameworks para medir performance de modelos de IA.

### [File Organizer](file:///Users/ruy/Code/mySkills/.agent/skills/file-organizer/SKILL.md)
Organização inteligente de arquivos e diretórios:
- **Curadoria**: Estruturação lógica de pastas baseada em contexto.
- **Duplicatas**: Identificação e remoção segura de arquivos repetidos.
- **Produtividade**: Automação de limpeza e manutenção de downloads.

### [Theme Factory](file:///Users/ruy/Code/mySkills/.agent/skills/theme-factory/SKILL.md)
Curadoria de temas profissionais para artefatos:
- **Estética**: Paletas de cores e pares de fontes selecionados por designers.
- **Showcase**: Visualização de 10 temas prontos para uso em slides e docs.
- **Consistência**: Aplicação sistemática de identidade visual.

### [Artifacts Builder](file:///Users/ruy/Code/mySkills/.agent/skills/artifacts-builder/SKILL.md)
Ferramentas avançadas para criação de artefatos interativos:
- **Stack**: React, Tailwind CSS e shadcn/ui.
- **Bundling**: Geração de arquivos HTML únicos e auto-contidos.
- **UX**: Foco em interfaces premium e dashboards complexos.

### [SEO Optimizer](file:///Users/ruy/Code/mySkills/.agent/skills/seo-optimizer/SKILL.md)
Especialista em otimização para mecanismos de busca:
- **Conteúdo**: Estratégia de palavras-chave e otimização On-Page.
- **Técnico**: Core Web Vitals, Schema markup e indexação.
- **E-E-A-T**: Foco em autoridade e confiança do conteúdo.

### [UI/UX Pro Max](file:///Users/ruy/Code/mySkills/.agent/skills/ui-ux-pro-max/SKILL.md)
Inteligência avançada de design e experiência do usuário:
- **Design System**: Gerador de sistemas de design com base em indústria e estilo.

### [Figma Dev Mode](file:///Users/ruy/Code/mySkills/.agent/skills/figma-dev-mode/SKILL.md)
Integração direta com o Figma através do Model Context Protocol (MCP):
- **Extração**: Inspeção de nós visuais, tokens de cor, tipografia e espaçamento.
- **Integração**: Configuração de `.mcp.json` para conectar o Claude/Cursor ao Figma Desktop.
- **Workflow**: Tradução perfeita do design para código.

### [Creative Design Figma](file:///Users/ruy/Code/mySkills/.agent/skills/creative-design-figma/SKILL.md)
Integração com o Figma Oficial na Nuvem:
- **Cloud MCP**: Extração de dados da API Oficial do Figma via `FIGMA_OAUTH_TOKEN`.
- **Flow**: Fluxos estruturados de Contexto Visual (`get_design_context`) e Print de Tela (`get_screenshot`).
- **Precisão**: Extração limpa de variáveis, componentes e assets (SVGs e imagens).

---
## 📚 Mais de 70 Skills Especializadas!
A biblioteca foi expandida massivamente com recursos do Antigravity Kit. Algumas novas categorias incluem:

- **Ecosystems**: [Rust Pro](file:///Users/ruy/Code/mySkills/.agent/skills/rust-pro/SKILL.md), [Python Patterns](file:///Users/ruy/Code/mySkills/.agent/skills/python-patterns/SKILL.md), [MCP Builder](file:///Users/ruy/Code/mySkills/.agent/skills/mcp-builder/SKILL.md).
- **Architecture**: [Database Design](file:///Users/ruy/Code/mySkills/.agent/skills/database-design/SKILL.md), [Deployment Procedures](file:///Users/ruy/Code/mySkills/.agent/skills/deployment-procedures/SKILL.md), [API Patterns](file:///Users/ruy/Code/mySkills/.agent/skills/api-patterns/SKILL.md).
- **Frontend & Web**: [Tailwind Patterns](file:///Users/ruy/Code/mySkills/.agent/skills/tailwind-patterns/SKILL.md), [Next.js React Expert](file:///Users/ruy/Code/mySkills/.agent/skills/nextjs-react-expert/SKILL.md), [Web Design Guidelines](file:///Users/ruy/Code/mySkills/.agent/skills/web-design-guidelines/SKILL.md).
- **Testing & Security**: [Vulnerability Scanner](file:///Users/ruy/Code/mySkills/.agent/skills/vulnerability-scanner/SKILL.md), [Webapp Testing](file:///Users/ruy/Code/mySkills/.agent/skills/webapp-testing/SKILL.md), [Red Team Tactics](file:///Users/ruy/Code/mySkills/.agent/skills/red-team-tactics/SKILL.md).
- **DevOps & SysAdmin**: [Server Management](file:///Users/ruy/Code/mySkills/.agent/skills/server-management/SKILL.md), [Bash Linux](file:///Users/ruy/Code/mySkills/.agent/skills/bash-linux/SKILL.md), [Powershell Windows](file:///Users/ruy/Code/mySkills/.agent/skills/powershell-windows/SKILL.md).

## 🤖 20+ Agentes Especializados
Agora você pode contar com um time completo de agentes:
- **Core Team**: `project-planner`, `orchestrator`, `documentation-writer`, `java-architect`.
- **Development**: `spring-boot-engineer`, `frontend-specialist`, `backend-specialist`, `database-architect`, `mobile-developer`, `game-developer`.
- **Review & Security**: `security-auditor`, `penetration-tester`, `qa-automation-engineer`.
- **Optimization**: `performance-optimizer`, `seo-specialist`, `code-archaeologist`.

## ⚡ 50+ Slash Commands (Workflows)
Integramos todos os fluxos de trabalho essenciais:
- `/plan`, `/create`, `/debug`, `/test`, `/deploy`, `/enhance`, `/status`, `/orchestrate`, `/preview` e muito mais.

---

## 🆕 Skills da Comunidade (sickn33/antigravity-awesome-skills)
Skills adicionadas da coleção curada do repositório externo:

### [Analyze Project](file:///Users/ruy/Code/mySkills/.agent/skills/analyze-project/SKILL.md)
Analisador forense de sessões do Antigravity:
- **Diagnóstico**: Identifica causas raiz de problemas nas sessões (agente, usuário, repositório).
- **Padrões**: Classifica o "shape" do retrabalho (limpo, expansão de escopo, churn, etc.).
- **Relatório**: Gera `session_analysis_report.md` com insights e recomendações acionáveis.

### [Leiloeiro Risco](file:///Users/ruy/Code/mySkills/.agent/skills/leiloeiro-risco/SKILL.md)
Auditor de risco sênior em leilões de imóveis (pt-BR):
- **Score**: Sistema de pontuação de 36 pontos (jurídico, financeiro, operacional, mercado).
- **Stress Test**: Análise em 4 cenários (otimista, base, pessimista, catastrófico) com ROI ponderado.
- **Decisão**: Árvore de decisão clara com limites de score para arrematar ou não.

### [Antigravity Design Expert](file:///Users/ruy/Code/mySkills/.agent/skills/antigravity-design-expert/SKILL.md)
Especialista em UI/UX glassmorphism e design espacial:
- **Estética**: Interfaces flutuantes com glassmorphism, profundidade 3D e perspectiva isométrica.
- **Animação**: GSAP + ScrollTrigger para animações suaves vinculadas ao scroll.
- **Performance**: `will-change: transform`, GPU offloading, `prefers-reduced-motion` respeitado.

---

## 📜 Regras e Automação de Elite
Agora incluímos a infraestrutura completa para transformar o assistente em um engenheiro de verdade:

### 🛠️ Scripts de Automação (`.agent/scripts/`)
Scripts prontos para serem executados pelos agentes:
- **`checklist.py`**: Executor mestre de verificações (Segurança, Lint, Schema, UX, SEO).
- **`verify_all.py`**: Suíte completa de validação pré-deploy.
- **`session_manager.py`**: Analisador de contexto do projeto para o assistente.
- **`auto_preview.py`**: Gestor de servidor de preview local.

### ⚖️ Protocolos de Inteligência (`.agent/rules/`)
Regras globais que guiam o comportamento da IA:
- **`GEMINI.md`**: Define o protocolo "Agent & Skill", garantindo que a IA aplique as skills e use os agentes de forma sistemática e correta.

---
- **Implementação**: Guias para React, Next.js, Vue e Tailwind.
- **Acessibilidade**: Checklist rigoroso de conformidade WCAG.

- **Compliance**: Guias para implementações seguras e resilientes.

### [Email Composer](file:///Users/ruy/Code/mySkills/.agent/skills/email-composer/SKILL.md)
Composição profissional de e-mails para diversos contextos:
- **Negócios**: Estruturas para propostas, follow-ups e reuniões.
- **Técnico**: Updates de infraestrutura, avisos de manutenção e suporte.
- **Etiqueta**: Boas práticas de tom, clareza e Call to Action (CTA).

### [API Integration Specialist](file:///Users/ruy/Code/mySkills/.agent/skills/api-integration-specialist/SKILL.md)
Especialista em integração de sistemas e APIs de terceiros:
- **Segurança**: Implementação de OAuth 2.0, chaves de API e verificação de webhooks.
- **Resiliência**: Padrões de retentativa (backoff), circuit breakers e tratamento de erros.
- **Eficiência**: Gerenciamento de rate limits, paginação e transformação de dados.

### [Mobile Design](file:///Users/ruy/Code/mySkills/.agent/skills/mobile-design/SKILL.md)
Design e desenvolvimento mobile de alta performance:
- **UX**: Touch-first design, Fitts' Law e otimização da Thumb Zone.
- **Plataformas**: Convenções específicas para iOS (SwiftUI) e Android (Material 3).
- **Performance**: Técnicas para 60fps, otimização de listas e gerenciamento de bateria.

### [Senior QA](file:///Users/ruy/Code/mySkills/.agent/skills/senior-qa/SKILL.md)
Garantia de qualidade e automação rigorosa:
- **Estratégia**: Planejamento de testes seguindo a Pirâmide de Testes.
- **Automação**: Scaffolding para testes E2E, unitários e de integração.

### [Writing Plans](file:///Users/ruy/Code/mySkills/.agent/skills/writing-plans/SKILL.md)
Planejamento detalhado de implementação:
- **Bite-sized**: Fragmentação de tarefas complexas em ações de 2-5 minutos.
- **TDD Nativo**: Planos focados em testes falhos antes da implementação.
- **Precisão**: Documentação exata de arquivos, comandos e snippets para execução direta.
- **Análise**: Ferramentas de análise de cobertura e métricas de qualidade.

### [SDD Spec Writer](file:///Users/ruy/Code/mySkills/.agent/skills/sdd-spec-writer/SKILL.md)
Especialista em Spec-Driven Development (SDD):
- **Contratos Claros**: Cria specs executáveis com precisão milimétrica.
- **Decisão Guiada**: Analisa complexidade para decidir entre execução via Humanos vs IAs.
- **Checklist de Validação**: Garante cobertura de edge cases e caminhos de erro obrigatórios.

### [Lead Research Assistant](file:///Users/ruy/Code/mySkills/.agent/skills/lead-research-assistant/SKILL.md)
Inteligência comercial e qualificação de leads:
- **Prospecção**: Busca ativa de empresas que se encaixam no Perfil de Cliente Ideal (ICP).
- **Qualificação**: Atribuição de scores de prioridade (1-10) baseados em sinais reais de mercado.
- **Estratégia**: Criação de pontos de contato personalizados e identificação de tomadores de decisão.

### [CTO Advisor](file:///Users/ruy/Code/mySkills/.agent/skills/cto-advisor/SKILL.md)
Liderança técnica estratégica e governança de arquitetura:
- **Estratégia**: Roadmaps de longo prazo, inovação e alinhamento de negócios.
- **Arquitetura**: Gestão de ADRs e revisões sistemáticas de infraestrutura.
- **Execução**: Escalonamento de times e métricas de excelência (DORA).

### [Supabase Postgres](file:///Users/ruy/Code/mySkills/.agent/skills/supabase-postgres/SKILL.md)
Otimização profunda de Postgres e Supabase:
- **Performance**: Estratégias de indexação (composite, partial, covering) e análise de queries.
- **Segurança**: Row-Level Security (RLS) avançado e gestão de privilégios.
- **Arquitetura**: Design de schema, gerenciamento de conexões e concorrência.

### [Clean Code](file:///Users/ruy/Code/mySkills/.agent/skills/clean-code/SKILL.md)
Padrões de codificação pragmáticos e legíveis:
- **Simplicidade**: Foco em KISS, DRY e YAGNI para evitar over-engineering.
- **Refatoração**: Uso de cláusulas de guarda e redução de aninhamento (flat code).
- **Nomes**: Convenções que revelam a intenção do código sem necessidade de comentários.

### [Senior DevOps](file:///Users/ruy/Code/mySkills/.agent/skills/senior-devops/SKILL.md)
Automação de infraestrutura e delivery:
- **IaC**: Scaffolding para Terraform e configurações multi-cloud.
- **CI/CD**: Geração de pipelines de entrega contínua com foco em qualidade.
- **Deployment**: Estratégias avançadas de atualização e recuperação de desastres.

### [Docker Expert](file:///Users/ruy/Code/mySkills/.agent/skills/docker-expert/SKILL.md)
Especialista em conteinerização e orquestração:
- **Otimização**: Multi-stage builds e redução drástica do tamanho de imagens.
- **Segurança**: Configuração de usuários não-root e gestão segura de segredos.
- **Compose**: Orquestração de múltiplos serviços com redes isoladas e healthchecks.

### [Software Architecture](file:///Users/ruy/Code/mySkills/.agent/skills/software-architecture/SKILL.md)
Arquitetura de sistemas e liderança técnica:
- **Clean Architecture**: Separação clara entre domínio, casos de uso e infraestrutura.
- **DDD**: Alinhamento do código com as regras de negócio e linguagem ubíqua.
- **Padrões**: Aplicação sistemática de SOLID, KISS e DRY.

### [NestJS Expert](file:///Users/ruy/Code/mySkills/.agent/skills/nestjs/SKILL.md)
Desenvolvimento backend empresarial com NestJS:
- **Arquitetura**: Módulos independentes, injeção de dependência e desacoplamento.
- **Lifecycle**: Uso estratégico de Guards, Interceptors, Pipes e Middleware.
- **Integração**: Conexão resiliente com Prisma, TypeORM e Mongoose.

### [Next.js Best Practices](file:///Users/ruy/Code/mySkills/.agent/skills/nextjs-best-practices/SKILL.md)
Modernidade em React com App Router:
- **RSC**: Decisão entre Server e Client Components para performance máxima.
- **Data Fetching**: Busca de dados no servidor com Streaming e Suspense.
- **Mutações**: Uso de Server Actions e gerenciamento de estado simplificado.

### [Copywriting](file:///Users/ruy/Code/mySkills/.agent/skills/copywriting/SKILL.md)
Escrita persuasiva para conversão e marketing:
- **Landing Pages**: Headline, Subhead e CTAs focadas em clareza e ação.
- **Vendas**: Transformação de funcionalidades em benefícios reais para o cliente.
- **Psicologia**: Gatilhos mentais e estruturas de convencimento lógico.

### [Executing Marketing Campaigns](file:///Users/ruy/Code/mySkills/.agent/skills/marketing-campaigns/SKILL.md)
Planejamento e execução de campanhas digitais:
- **Estratégia**: Definição de objetivos, personas e mix de canais (E-mail, Social, Paid).
- **Conteúdo**: Criação de ativos de campanha alinhados com a identidade da marca.
- **Analytics**: Monitoramento de conversão, CTR e ROI para otimização em tempo real.

### [Web Performance](file:///Users/ruy/Code/mySkills/.agent/skills/web-performance/SKILL.md)
Otimização profunda de performance web:
- **Core Web Vitals**: Foco em LCP, FID e CLS para SEO e UX.
- **Ativos**: Otimização de imagens (WebP/AVIF), responsive design e lazy loading.
- **Bundle**: Redução de JS, code splitting e estratégias de cache agressivas.

### [Invoice Organizer](file:///Users/ruy/Code/mySkills/.agent/skills/invoice-organizer/SKILL.md)
Organização automatizada de faturas e recibos:
- **Extração**: Leitura inteligente de fornecedor, data, valor e faturas via OCR.
- **Estruturação**: Renomeação padronizada e arquivamento por ano/categoria.
- **Relatórios**: Geração de resumos CSV prontos para a contabilidade.

- **Validação**: Frameworks de testes de usabilidade e síntese de pesquisa.

### [Content Research Writer](file:///Users/ruy/Code/mySkills/.agent/skills/content-research-writer/SKILL.md)
Parceiro de pesquisa e redação para conteúdo profissional:
- **Pesquisa**: Busca de dados, citações e evidências para sustentar argumentos.
- **Escrita**: Otimização de hooks, feedbacks por seção e preservação de voz.
- **Estrutura**: Auxílio em outlines, newsletters e documentação técnica.

### [UI Design System](file:///Users/ruy/Code/mySkills/.agent/skills/ui-design-system/SKILL.md)
Toolkit para sistemas de design e consistência visual:
- **Tokens**: Geração automatizada de tokens de cores, tipografia e espaçamento.
- **Sistemas**: Arquitetura de componentes escaláveis e responsivos.
- **Handoff**: Documentação facilitada para a transição entre design e desenvolvimento.

## 📦 Instalação e Uso via NPX

Esta biblioteca pode ser usada em qualquer projeto sem clonar o repositório.

### 🏁 Primeiros Passos (Recomendado)

```bash
# Instala o kit completo + ativa o menu / no Antigravity
npx @ruyfranca/myskills init && npx @ruyfranca/myskills install-global
```

Após executar, **feche e reabra o Antigravity**. Os slash commands (`/brainstorm`, `/debug`, `/plan`, etc.) estarão disponíveis em qualquer projeto.

### Todos os Comandos

```bash
# Listar skills disponíveis
npx @ruyfranca/myskills list

# Listar agents disponíveis
npx @ruyfranca/myskills list-agents

# Inicializar kit completo no projeto atual (.agent/ com skills, agents, workflows)
npx @ruyfranca/myskills init

# 🌐 Ativar o menu / do Antigravity com todos os workflows (roda uma vez por máquina)
npx @ruyfranca/myskills install-global

# Instalar uma skill individual
npx @ruyfranca/myskills add <nome-da-skill>

# Instalar um agent individual
npx @ruyfranca/myskills add <nome-do-agent> --agent

# Instalar todas as 40+ skills
npx @ruyfranca/myskills add --all

# Atualizar o kit no projeto atual (skills + agents + workflows + global_workflows)
npx @ruyfranca/myskills update

# Atualizar apenas um componente específico:
npx @ruyfranca/myskills update --skills
npx @ruyfranca/myskills update --agents
npx @ruyfranca/myskills update --workflows
```

### 🚨 Resolução de Problemas (Troubleshooting)

**Erro no Antigravity: `ConnectError: [unknown] Failed to fetch` ou crash de inicialização**

Se após utilizar o `install-global` o seu Antigravity parar de funcionar com um erro de *Skills Configuration* ou *Failed to load MCP servers*, **não se desespere**, você não perdeu seu histórico. Isso ocorria em versões anteriores (`<= 1.0.31`) devido a um parser interno do Antigravity que rejeitava arquivos `.md` com cabeçalhos estruturais YAML duplicados.

**Como resolver de vez o lado do cliente:**
1. Apague apenas a pasta global de workflows que está engasgando o backend:
   - **Mac/Linux**: `rm -rf ~/.gemini/antigravity/global_workflows`
   - **Windows PowerShell**: `Remove-Item -Recurse -Force ~\.gemini\antigravity\global_workflows`
2. Pressione `Cmd+R` (ou `Ctrl+R`) no Antigravity e verifique que ele voltou ao normal e ligou com sucesso.
3. Agora rode o comando com a versão atualizada (a partir de `1.0.32` já contém a correção embutida):
   ```bash
   npx @ruyfranca/myskills@latest install-global
   ```
O Antigravity vai reiniciar perfeitamente já com seus global workflows ativos!

---

## 🔄 Fluxo de Atualização (Para Desenvolvedores)

Se você adicionou novas skills ou editou arquivos no repositório, siga estes passos para refletir as mudanças no `npx`:

### 1. Atualizar o GitHub
Garanta que todas as alterações foram enviadas para o repositório remoto:
```bash
git add .
git commit -m "feat: adiciona nova skill X"
git push origin main
```

### 2. Publicar Versão no NPM
O NPM não permite publicar a mesma versão duas vezes. Você deve incrementar a versão no `package.json` e publicar:

```bash
# Sobe a versão (patch: 1.0.0 -> 1.0.1)
npm version patch

# Publica o pacote atualizado
npm publish --access public
```

*Nota: Se você tiver 2FA ativado, o terminal abrirá o navegador ou solicitará o código OTP.*

## 🛠️ Como Usar

Você pode acessar as skills diretamente via comandos de barra no chat:

- `/product-manager`: Ativa a persona de Product Manager e carrega as instruções de estratégia e roadmap.
- `/brainstorm`: Inicia um processo de design colaborativo para explorar ideias antes da implementação.
- `/senior-frontend`: Ativa o especialista em frontend para React, Next.js e otimização de performance.
- `/code-reviewer`: Ativa o revisor de código para garantir qualidade e padrões técnicos.
- `/debugging`: Inicia o processo de depuração sistemática para bugs complexos.
- `/tdd`: Ativa o fluxo de desenvolvimento orientado a testes (Red-Green-Refactor).
- `/business-analyst`: Ativa o analista de negócios para definição de requisitos e alinhamento.
- `/ui-design-system`: Ativa o especialista em Design System para criar e gerenciar tokens e consistência visual.
- `/pdf-pro`: Ativa o especialista em processamento de PDFs, formulários e OCR.
- `/canvas-design`: Ativa o artista visual para criação de artes e posters de alta qualidade.
- `/xlsx`: Ativa o especialista em automação e análise de planilhas Excel.
- `/pptx`: Ativa o especialista em criação, edição e análise de apresentações PowerPoint.
- `/senior-fullstack`: Ativa o especialista em desenvolvimento fullstack ponta a ponta.
- `/prompt-engineer`: Ativa o especialista em engenharia de prompt e sistemas de IA.
- `/file-organizer`: Ativa o organizador inteligente de arquivos e pastas.
- `/theme-factory`: Ativa a fábrica de temas visuais e identidade de marca.
- `/artifacts-builder`: Ativa o construtor de artefatos interativos complexos (React/shadcn).
- `/seo`: Ativa o especialista em SEO e estratégia de conteúdo.
- `/ui-pro-max`: Ativa a inteligência avançada de design UI/UX.
- `/security`: Ativa o especialista em segurança e auditoria de sistemas.
- `/email-composer`: Ativa o redator especializado em e-mails corporativos e técnicos.
- `/senior-devops`: Ativa o especialista em infraestrutura segura e automação de entrega.
- `/ux-researcher-designer`: Ativa o kit completo de pesquisa e design focado no usuário.
- `/content-research`: Ativa o parceiro de escrita para pesquisa e criação de conteúdo de alta qualidade.
- `/api-integration`: Ativa o especialista em integração de APIs e sistemas externos.
- `/mobile-design`: Ativa o especialista em design e desenvolvimento mobile de alta performance.
- `/senior-qa`: Ativa o especialista em garantia de qualidade e automação de testes.
- `/writing-plans`: Ativa o arquiteto para criação de planos de implementação detalhados e TDD.
- `/lead-research`: Ativa o especialista em pesquisa e qualificação de leads para vendas e parcerias.
- `/cto-advisor`: Ativa o conselheiro estratégico para liderança técnica e arquitetura.
- `/clean-code`: Ativa o guardião dos padrões de código limpo e pragmático.
- `/supabase-postgres`: Ativa o especialista em Postgres e Supabase para otimização e segurança.
- `/docker`: Ativa o especialista em conteinerização e docker-compose.
- `/architecture`: Ativa o arquiteto de software para design de sistemas e Clean Architecture.
- `/java`: Ativa o arquiteto Java de alta senioridade focado em soluções Enterprise Node, DDD e Microserviços.
- `/spring-boot`: Ativa o engenheiro Spring Boot para desenvolvimento backend corporativo Java.
- `/nestjs`: Ativa o especialista em NestJS para desenvolvimento backend enterprise.
- `/nextjs`: Ativa o arquiteto Next.js para aplicações modernas com App Router.
- `/copywriting`: Ativa o redator focado em conversão e marketing copy.
- `/marketing-campaigns`: Ativa o gestor de campanhas para planejamento e execução estratégica.
- `/web-perf`: Ativa o engenheiro de performance para otimização de Core Web Vitals.
- `/invoice-organizer`: Ativa o assistente de organização financeira e contábil.
- `/figma`: Ativa a integração MCP com o Figma Dev Mode para extração visual.
- `/creative-design-figma`: Ativa a integração MCP Oficial usando tokens de Nuvem do Figma.
- `/memory-spring-cleaning`: Executa uma varredura para sincronizar código e memória (docs/rules), removendo drift e arquivos legados.
- `/sdd-spec`: Ativa o gerador de especificações baseadas em Spec-Driven Development (SDD).

## 📁 Estrutura do Projeto

- `.agent/skills/`: Contém as definições detalhadas das skills em formato Markdown (`SKILL.md`).
- `.agent/workflows/`: Contém as configurações dos comandos de barra (`/`) para facilitar o acesso às skills.

---
*Este repositório foi criado para centralizar e organizar inteligência especializada para desenvolvimento de produtos e negócios.*