mySkills

Este repositório contém uma coleção de skills especializadas para o Antigravity, projetadas para estender as capacidades do assistente em áreas específicas como gestão de produtos, marketing e negócios.

🚀 Skills Disponíveis

Product Manager

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

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

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

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

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)

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

...

PDF Processing Pro

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

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

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

...

Senior Fullstack

...

Senior Prompt Engineer

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

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

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

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

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

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

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

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, Python Patterns, MCP Builder.
• Architecture: Database Design, Deployment Procedures, API Patterns.
• Frontend & Web: Tailwind Patterns, Next.js React Expert, Web Design Guidelines.
• Testing & Security: Vulnerability Scanner, Webapp Testing, Red Team Tactics.
• DevOps & SysAdmin: Server Management, Bash Linux, Powershell Windows.

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

📜 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

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

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

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

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

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.

Lead Research Assistant

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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 de skills pode ser usada em qualquer projeto local sem a necessidade de clonar o repositório manualmente.

Comandos Disponíveis

# 1. Listar todas as skills na biblioteca
npx @ruyfranca/myskills list

# 2. Listar todos os agents na biblioteca
npx @ruyfranca/myskills list-agents

# 3. Inicializar kit completo em um novo projeto
# (Instala a pasta .agent completa com skills, agents e workflows)
npx @ruyfranca/myskills init

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

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

# 6. Instalar TODAS as 40+ skills individuais
npx @ruyfranca/myskills add --all

# Exemplo prático:
npx @ruyfranca/myskills init
npx @ruyfranca/myskills add frontend-developer --agent

🔄 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:

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:

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

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