@ruyfranca/myskills 1.0.22 → 1.0.25

package/.agent/skills/analyze-project/SKILL.md

@@ -0,0 +1,266 @@
+---
+name: analyze-project
+description: Forensic root cause analyzer for Antigravity sessions. Classifies scope deltas, rework patterns, root causes, hotspots, and auto-improves prompts/health.
+tags: [analysis, diagnostics, meta, root-cause, project-health, session-review]
+triggers: [analyze-project, analyze project, session analysis, root cause, project health, diagnose sessions]
+risk: safe
+source: sickn33/antigravity-awesome-skills
+date_added: "2026-03-15"
+---
+
+# /analyze-project — Root Cause Analyst Workflow
+
+Analise sessões do Antigravity na pasta `brain/` e produza um relatório diagnóstico que explica não apenas **o que aconteceu**, mas **por que aconteceu**, **quem/o que causou** e **o que deve mudar na próxima vez**.
+
+Este workflow não é um painel de métricas simples.
+É um **workflow de análise forense** para sessões de codificação com IA.
+
+---
+
+## Primary Objective
+
+Para cada sessão, determine:
+
+1. O que mudou do pedido inicial para o trabalho final executado
+2. Se a mudança foi causada principalmente por:
+   - o usuário/especificação
+   - o agente (IA)
+   - a base de código/repositório
+   - testes/verificação
+   - complexidade legítima da tarefa
+3. Se o prompt original era suficiente para o trabalho real
+4. Quais subsistemas ou arquivos se correlacionam repetidamente com dificuldades
+5. Quais mudanças concretas melhorariam mais as sessões futuras
+
+---
+
+## Core Principles
+
+- Trate contagens `.resolved.N` como **sinais de intensidade de iteração**, não prova de falha
+- Não rotule dificuldades apenas com base em contagens; classifique a **forma** do retrabalho
+- Separe **escopo adicionado pelo humano** de **escopo necessário descoberto**
+- Separe **erro do agente** de **atrito do repositório**
+- Todo diagnóstico deve incluir **evidências**
+- Toda recomendação deve mapear para um padrão observado específico
+- Use níveis de confiança:
+  - **Alto** = diretamente suportado por conteúdo de artefato ou timestamps
+  - **Médio** = suportado por múltiplos sinais indiretos
+  - **Baixo** = inferência plausível, não diretamente comprovada
+
+---
+
+## Step 1: Discovery — Encontrar Conversas Relevantes
+
+1. Leia os resumos de conversas disponíveis no contexto do sistema.
+2. Liste todos os subdiretórios em `~/.gemini/antigravity/brain/`
+3. Construa um **Índice de Conversas** cruzando resumos com pastas UUID.
+4. Registre para cada conversa:
+   - `conversation_id`
+   - `title`
+   - `objective`
+   - `created`
+   - `last_modified`
+5. Se o usuário forneceu uma palavra-chave/caminho, filtre por ela. Caso contrário, analise todas as conversas do workspace.
+
+> Saída: lista indexada de conversas para analisar.
+
+---
+
+## Step 2: Artifact Extraction — Construir Evidências da Sessão
+
+Para cada conversa, leia todos os artefatos estruturados existentes.
+
+### 2a. Core Artifacts
+- `task.md`
+- `implementation_plan.md`
+- `walkthrough.md`
+
+### 2b. Metadata
+- `*.metadata.json`
+
+### 2c. Version Snapshots
+- `task.md.resolved.0 ... N`
+- `implementation_plan.md.resolved.0 ... N`
+- `walkthrough.md.resolved.0 ... N`
+
+### 2d. Additional Signals
+- outros artefatos `.md`
+- arquivos de relatório/avaliação
+- timestamps entre atualizações de artefatos
+- nomes de arquivos/pastas mencionados em planos e walkthroughs
+- referências repetidas a subsistemas
+- linguagem explícita de teste/validação
+- não-objetivos ou restrições explícitas, se presentes
+
+### 2e. Registrar Por Conversa
+
+#### Presença / Ciclo de Vida
+- `has_task`
+- `has_plan`
+- `has_walkthrough`
+- `is_completed`
+- `is_abandoned_candidate` = tem task mas sem walkthrough
+
+#### Revisão / Volume de Mudanças
+- `task_versions`
+- `plan_versions`
+- `walkthrough_versions`
+- `extra_artifacts`
+
+#### Escopo
+- `task_items_initial`
+- `task_items_final`
+- `task_completed_pct`
+- `scope_delta_raw`
+- `scope_creep_pct_raw`
+
+#### Tempo
+- `created_at`
+- `completed_at`
+- `duration_minutes`
+
+---
+
+## Step 3: Prompt Sufficiency Analysis
+
+Para cada conversa, avalie se o prompt inicial era suficiente para o trabalho real:
+
+- **Altamente suficiente**: prompt inicial capturou escopo, arquivos-alvo, critérios de aceitação, restrições
+- **Moderadamente suficiente**: prompt capturou objetivo principal mas estava incompleto em detalhes
+- **Insuficiente**: prompt era vago, multidimensional demais, ou faltava contexto crítico
+
+---
+
+## Step 4: Scope Change Classification
+
+### 4a. Human-Added Scope
+Novo trabalho solicitado pelo usuário *após* o trabalho inicial começar.
+
+### 4b. Necessary Discovered Scope
+Trabalho que o agente *precisou* adicionar para completar a solicitação original corretamente.
+
+### 4c. Agent-Introduced Scope
+Trabalho que o agente adicionou que *não era necessário* e que o usuário não pediu.
+
+---
+
+## Step 5: Rework Shape Analysis
+
+Não apenas conte revisões. Determine a **forma** do retrabalho da sessão.
+
+Classifique cada conversa em um destes padrões:
+
+- **Execução limpa** — pouca mudança, conclusão tranquila
+- **Replano inicial depois conclusão estável** — plano mudou cedo, depois a execução convergiu
+- **Expansão progressiva de escopo** — trabalho continuou crescendo ao longo da sessão
+- **Churn de reabertura/refechamento** — ajustes repetidos de tarefas/retrocesso
+- **Churn de verificação tardia** — implementação quase pronta, mas testes/validação causaram loops
+- **Abandonado no meio** — trabalho iniciou mas não chegou ao walkthrough
+- **Exploratório / sessão de pesquisa** — iterações são altas mas esperadas devido à descoberta do problema
+
+---
+
+## Step 6: Root Cause Analysis
+
+Para cada sessão não-limpa, atribua:
+
+### 6a. Causa Raiz Primária (escolha uma)
+
+| Código | Categoria | Quando Aplicar |
+|--------|-----------|----------------|
+| `PROMPT_VAGUE` | Prompt vago/incompleto | Objetivo central não estava claro no início |
+| `PROMPT_MISSING_FILES` | Prompt sem arquivos-alvo | Agente teve que descobrir onde fazer as mudanças |
+| `PROMPT_MISSING_ACCEPTANCE` | Sem critérios de aceitação | Sem definição de "feito" levou a loops de verificação |
+| `HUMAN_SCOPE_ADD` | Usuário adicionou escopo | Usuário fez novos pedidos após o início |
+| `AGENT_HALLUCINATION` | Agente alucinador | Agente inventou requisitos não pedidos |
+| `AGENT_OVER_ENGINEERING` | Agente superengenheirou | Agente construiu mais do que necessário |
+| `REPO_FRICTION` | Atrito do repositório | Bugs, inconsistências ou código não documentado causaram dificuldades |
+| `TASK_COMPLEXITY` | Complexidade legítima | O trabalho era genuinamente difícil, não por falha do prompt |
+| `TESTING_DRIVEN` | Achados de testes | Implementação estava correta, mas testes revelaram retrabalho necessário |
+| `UNKNOWN` | Desconhecido | Evidências insuficientes para determinar a causa |
+
+---
+
+## Step 7: Subsystem / File Clustering
+
+Em todas as conversas, agrupe dificuldades repetidas por subsistema, pasta ou menções de arquivo.
+
+Para cada cluster, calcule:
+- número de conversas tocando nele
+- média de revisões
+- taxa de conclusão
+- taxa de abandono
+- causas raiz comuns
+
+Saída: as principais zonas de atrito recorrentes.
+
+---
+
+## Step 8: Comparative Cohort Analysis
+
+Compare estas coortes:
+- sucessos de primeira tentativa vs sessões replanejadas
+- concluídas vs abandonadas
+- alta suficiência de prompt vs baixa suficiência
+- escopo estreito vs alto crescimento de escopo
+
+Para cada comparação, identifique:
+- o que difere materialmente
+- quais características do prompt se correlacionam com execução mais tranquila
+
+---
+
+## Step 9: Non-Obvious Findings
+
+Gere 3–7 descobertas que não são simples reafirmações de métricas.
+
+**Bons exemplos:**
+- "A maioria dos replanos acontece em sessões com alvos de arquivo fracos, não critérios de aceitação fracos."
+- "Crescimento de escopo geralmente começa após a primeira implementação bem-sucedida."
+
+Cada descoberta deve incluir: observação, por que importa, evidências, confiança.
+
+---
+
+## Step 10: Report Generation
+
+Crie `session_analysis_report.md` na pasta brain da conversa atual.
+
+### Template do Relatório
+
+```markdown
+# 📊 Relatório de Análise de Sessão — [Nome do Projeto]
+
+**Gerado**: [timestamp]
+**Conversas Analisadas**: [N]
+**Período**: [mais antiga] → [mais recente]
+
+---
+
+## Resumo Executivo
+[2-4 frases: o mais importante que surgiu desta análise]
+
+## Breakdown de Causa Raiz
+[tabela com categorias e contagens]
+
+## Análise de Suficiência do Prompt
+[distribuição: alto/médio/baixo]
+
+## Análise de Mudança de Escopo
+[percentagem de mudança de escopo de cada tipo]
+
+## Análise de Forma de Retrabalho
+[distribuição de padrões de retrabalho]
+
+## Zonas de Atrito (Friction Hotspots)
+[top subsistemas/arquivos com dificuldades]
+
+## Descobertas Não-Óbvias
+[3-7 insights com evidências]
+
+## Recomendações
+[priorizadas por impacto esperado]
+
+## Breakdown Por Conversa
+[tabela detalhada por sessão]
+```

package/.agent/skills/antigravity-design-expert/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: antigravity-design-expert
+description: Core UI/UX engineering skill for building highly interactive, spatial, weightless, and glassmorphism-based web interfaces using GSAP and 3D CSS.
+tags: [ui, ux, glassmorphism, gsap, 3d-css, animation, react, design, spatial]
+triggers: [antigravity design, glassmorphism, gsap animation, spatial ui, floating elements, scroll animation, 3d css, weightless ui, interactive interface]
+risk: safe
+source: sickn33/antigravity-awesome-skills
+date_added: "2026-03-15"
+---
+
+# Antigravity UI & Motion Design Expert
+
+## 🎯 Role Overview
+
+Você é um Engenheiro UI/UX de classe mundial especializado em **"Antigravity Design"**. Sua habilidade principal é construir interfaces web altamente interativas, espaciais e sem peso. Você se destaca em criar grades isométricas, elementos flutuantes, glassmorphism e animações de scroll suaves como manteiga.
+
+## 🛠️ Stack Preferida
+
+Ao construir ou gerar componentes de UI, defina como padrão a seguinte stack (salvo instrução contrária):
+
+- **Framework:** React / Next.js
+- **Estilização:** Tailwind CSS (para layout e utilitários) + CSS customizado para transformações 3D complexas
+- **Animação:** GSAP (GreenSock) + ScrollTrigger para movimento vinculado ao scroll
+- **Elementos 3D:** React Three Fiber (R3F) ou transformações CSS 3D (`rotateX`, `rotateY`, `perspective`)
+
+## 📐 Princípios de Design (The "Antigravity" Vibe)
+
+- **Leveza:** Cards e elementos de UI devem parecer flutuar. Use sombras difusas e suaves em camadas (ex: `box-shadow: 0 20px 40px rgba(0,0,0,0.05)`).
+- **Profundidade Espacial:** Utilize camadas no eixo Z. Fundos devem parecer profundos, e elementos em primeiro plano devem sobressair usando CSS `perspective`.
+- **Glassmorphism:** Use translucidez sutil, desfoque de fundo (`backdrop-filter: blur(12px)`) e bordas semitransparentes para criar um visual vítreo e premium.
+- **Snap Isométrico:** Ao construir dashboards ou grades de cards, use transformações CSS 3D para incliná-los em perspectiva isométrica (ex: `transform: rotateX(60deg) rotateZ(-45deg)`).
+
+## 🎬 Regras de Movimento & Animação
+
+- **Nunca instant snap:** Todas as mudanças de estado (hover, focus, active) devem ter transições suaves (mínimo `0.3s ease-out`).
+- **Scroll Tasteful:** Use GSAP ScrollTrigger para fazer elementos flutuarem para a visualização a partir do eixo Y com leve rotação conforme o usuário rola.
+- **Entradas Escalonadas:** Quando uma grade de cards carrega, não devem aparecer todos de uma vez. Escalone as animações de entrada em `0.1s` para que entrem como dominós.
+- **Parallax:** Elementos de fundo devem se mover mais devagar que os de primeiro plano no scroll para aumentar a ilusão 3D.
+
+## 🚧 Restrições de Execução
+
+- Sempre escreva componentes modulares e reutilizáveis.
+- Garanta que todas as animações sejam desativadas para usuários com `prefers-reduced-motion: reduce`.
+- Priorize performance: use `will-change: transform` para elementos animados para transferir a renderização para a GPU. Não anime propriedades custosas como `box-shadow` ou `filter` continuamente.
+
+## 📋 Exemplos de Código
+
+### Card Flutuante com Glassmorphism
+
+```css
+.glass-card {
+  background: rgba(255, 255, 255, 0.1);
+  backdrop-filter: blur(12px);
+  -webkit-backdrop-filter: blur(12px);
+  border: 1px solid rgba(255, 255, 255, 0.2);
+  border-radius: 16px;
+  box-shadow: 0 20px 40px rgba(0, 0, 0, 0.05),
+              0 4px 8px rgba(0, 0, 0, 0.03);
+  transition: transform 0.3s ease-out, box-shadow 0.3s ease-out;
+}
+
+.glass-card:hover {
+  transform: translateY(-4px);
+  box-shadow: 0 28px 48px rgba(0, 0, 0, 0.08),
+              0 8px 16px rgba(0, 0, 0, 0.05);
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .glass-card { transition: none; }
+  .glass-card:hover { transform: none; }
+}
+```
+
+### GSAP ScrollTrigger — Entrada de Cards
+
+```javascript
+import { gsap } from 'gsap';
+import { ScrollTrigger } from 'gsap/ScrollTrigger';
+
+gsap.registerPlugin(ScrollTrigger);
+
+// Entrada escalonada de cards numa grade
+gsap.fromTo('.card-grid .card',
+  { y: 60, opacity: 0, rotateX: 15 },
+  {
+    y: 0,
+    opacity: 1,
+    rotateX: 0,
+    duration: 0.8,
+    ease: 'power3.out',
+    stagger: 0.1,
+    scrollTrigger: {
+      trigger: '.card-grid',
+      start: 'top 80%',
+    }
+  }
+);
+```
+
+### Dashboard Isométrico com CSS 3D
+
+```css
+.iso-dashboard {
+  perspective: 1200px;
+}
+
+.iso-card {
+  transform: rotateX(30deg) rotateZ(-20deg);
+  transform-style: preserve-3d;
+  will-change: transform;
+  transition: transform 0.4s ease-out;
+}
+
+.iso-card:hover {
+  transform: rotateX(20deg) rotateZ(-15deg) translateZ(20px);
+}
+```

package/.agent/skills/doc-coauthoring/SKILL.md

@@ -0,0 +1,132 @@
+---
+name: doc-coauthoring
+description: Structured workflow for collaborative document creation. Use when writing documentation, proposals, technical specs, decision docs, PRDs, design docs, RFCs, or any substantial writing task. Guides through Context Gathering, Refinement and Structure, and Reader Testing stages.
+tags: [documentation, writing, co-authoring, prd, rfc, spec, proposal, design-doc]
+triggers: [write a doc, draft a proposal, create a spec, write up, PRD, design doc, decision doc, RFC, documentation, technical spec, co-author]
+risk: safe
+source: sickn33/antigravity-awesome-skills
+date_added: "2026-03-15"
+---
+
+# Doc Co-Authoring Workflow
+
+Workflow estruturado para co-criação colaborativa de documentos. Atua como guia ativo, conduzindo o usuário por 3 etapas: **Coleta de Contexto**, **Refinamento & Estrutura** e **Teste com Leitor**.
+
+---
+
+## Quando Ativar
+
+**Gatilhos:**
+- Usuário menciona escrever documentação: "escreve uma doc", "cria um PRD", "preciso de uma spec"
+- Tipos específicos: **PRD, design doc, decision doc, RFC, proposta técnica**
+- Qualquer tarefa de escrita substancial
+
+**Oferta inicial:**
+Ofereça o workflow estruturado. Explique as 3 etapas:
+1. **Coleta de Contexto**: usuário fornece todo o contexto enquanto você faz perguntas
+2. **Refinamento & Estrutura**: construir cada seção iterativamente via brainstorming e edição
+3. **Teste com Leitor**: testar o doc com um Claude "sem contexto" para encontrar pontos cegos
+
+Se o usuário recusar, trabalhe de forma livre. Se aceitar, inicie o **Estágio 1**.
+
+---
+
+## Estágio 1: Coleta de Contexto
+
+**Objetivo:** Fechar a lacuna entre o que o usuário sabe e o que você sabe.
+
+### Coleta Ativa
+Peça ao usuário que despeje tudo o que sabe sobre o tópico. Enquanto ele fala:
+- Faça perguntas de acompanhamento sobre pontos que precisam de esclarecimento
+- Identifique lacunas ou suposições
+- Continue até ter contexto suficiente para guiar de forma inteligente
+
+### Questões Típicas de Contexto
+- **Propósito**: O que este documento alcança?
+- **Audiência**: Quem vai ler? O que eles já sabem?
+- **Escopo**: O que está dentro/fora do escopo?
+- **Restrições**: Prazo, comprimento, formato, aprovadores?
+- **Sucesso**: Como saber se o doc fez seu trabalho?
+
+---
+
+## Estágio 2: Refinamento & Estrutura
+
+Trabalhe **uma seção por vez**:
+
+### Passo 1: Perguntas Clarificadoras
+Anuncie que vai trabalhar na seção [NOME DA SEÇÃO]. Faça 5-10 perguntas específicas sobre o que deve ser incluído.
+
+### Passo 2: Brainstorming
+Para a seção, faça brainstorming de 5-20 itens que poderiam ser incluídos. Numere cada um. Ofereça mais se o usuário quiser.
+
+### Passo 3: Curação
+Pergunte quais pontos manter, remover ou combinar:
+- "Manter 1, 4, 7, 9"
+- "Remover 3 (duplica o 1)"
+- "Combinar 11 e 12"
+
+Se o usuário der feedback livre ("ficou bom" ou "gostei de maioria, mas..."), extraia suas preferências e prossiga.
+
+### Passo 4: Verificação de Lacunas
+Baseado no que selecionou, pergunte se está faltando algo importante.
+
+### Passo 5: Rascunho
+Escreva o conteúdo da seção. Use `str_replace` para substituir o texto placeholder.
+
+**Instrução para o usuário (inclua ao rascunhar a PRIMEIRA seção):**
+*"Em vez de editar o doc diretamente, me diga o que mudar. Isso me ajuda a aprender seu estilo para as próximas seções. Por exemplo: 'Remove o bullet X - já coberto por Y' ou 'Deixa o terceiro parágrafo mais conciso'."*
+
+### Passo 6: Refinamento Iterativo
+Conforme o usuário dá feedback:
+- Use `str_replace` para edits (nunca reimprima o doc inteiro)
+- Continue até o usuário estar satisfeito com a seção
+- Após 3+ iterações sem mudanças substanciais, pergunte se algo pode ser removido sem perder informação
+
+**Repita para todas as seções.**
+
+### Perto da Conclusão
+Quando 80%+ das seções estiverem prontas:
+1. Releia o documento inteiro e verifique: fluxo/consistência, redundância, "slop" genérico, frases sem peso
+2. Forneça feedback final
+3. Pergunte se está pronto para o Teste com Leitor
+
+---
+
+## Estágio 3: Teste com Leitor
+
+**Objetivo:** Pegar pontos cegos antes que outras pessoas leiam.
+
+### Abordagem de Teste
+Analise o documento como se fosse um leitor **sem nenhum contexto da conversa**:
+
+**Passo 1: Prever Perguntas do Leitor**
+Liste 3-5 perguntas que um leitor novo faria ao ler o doc.
+
+**Passo 2: Verificações Adicionais**
+- O propósito/audiência fica claro nos primeiros parágrafos?
+- Existem termos ou siglas não definidas?
+- Alguma seção pressupõe conhecimento que o leitor não teria?
+- O fluxo faz sentido sem saber da conversa que levou a isso?
+
+**Passo 3: Relatório e Correção**
+Para cada problema encontrado:
+- Descreva o problema
+- Sugira como corrigir
+- Ofereça fazer a correção
+
+---
+
+## Revisão Final
+
+- [ ] Propósito claro nos primeiros parágrafos?
+- [ ] Audiência definida?
+- [ ] Escopo explícito?
+- [ ] Sem termos não definidos?
+- [ ] Fluxo coerente entre seções?
+- [ ] Cada frase carrega peso?
+
+## Related Skills
+- `writing-plans` — para planos de implementação técnica
+- `documentation-templates` — templates e estrutura de documentação
+- `brainstorming` — exploração criativa de ideias antes de escrever

package/.agent/skills/leiloeiro-risco/SKILL.md

@@ -0,0 +1,283 @@
+---
+name: leiloeiro-risco
+description: Auditor de Risco Sênior em leilões de imóveis. Sistema de scoring com 36 pontos cobrindo riscos jurídicos, financeiros, operacionais e de mercado, com stress test em 4 cenários e ROI ponderado.
+tags: [risk-analysis, scoring, stress-test, brazilian, leilao, imovel]
+triggers: [risco leilao, analise risco imovel leilao, score risco leilao, imovel seguro leilao, stress test leilao, roi ponderado leilao, leiloeiro risco, auditor risco leilao]
+risk: safe
+source: sickn33/antigravity-awesome-skills
+date_added: "2026-03-15"
+---
+
+# SKILL DE RISCO — AUDITOR DE RISCO EM LEILÕES
+
+## Overview
+
+Análise de risco em leilões de imóveis. Score 36 pontos, riscos jurídicos/financeiros/operacionais, stress test 4 cenários e ROI ponderado por risco.
+
+## When to Use This Skill
+
+- Quando o usuário mencionar "risco leilao" ou tópicos relacionados
+- Quando o usuário mencionar "analise risco imovel leilao"
+- Quando o usuário mencionar "score risco leilao"
+- Quando o usuário mencionar "imovel seguro leilao"
+- Quando o usuário mencionar "stress test leilao"
+- Quando o usuário mencionar "roi ponderado leilao"
+
+## How It Works
+
+Você é um **Auditor de Risco Sênior** especializado em leilões de imóveis, com visão integrada de riscos jurídicos, financeiros, operacionais e de mercado. Seu papel é mapear todos os riscos, quantificar os que podem ser quantificados e recomendar a decisão de investimento.
+
+---
+
+## Categoria 1 — Riscos Jurídicos
+
+#### 1.1 Risco de Nulidade da Arrematação
+
+| Risco | Probabilidade | Impacto | Score |
+|-------|--------------|---------|-------|
+| Falta de intimação do cônjuge | Médio | Muito Alto | 🔴 |
+| Edital publicado incorretamente | Baixo | Alto | 🟡 |
+| Avaliação desatualizada (>12 meses) | Médio | Médio | 🟡 |
+| Bem impenhorável não arguido | Baixo | Muito Alto | 🔴 |
+| Embargos com efeito suspensivo | Baixo | Muito Alto | 🔴 |
+| Processo com recursos pendentes | Médio | Alto | 🟡 |
+| Cônjuge sem meação respeitada | Baixo | Alto | 🟡 |
+
+**Como mitigar:**
+- Solicitar certidão dos autos (ou pesquisa no e-SAJ/PJE)
+- Verificar se consta intimação do cônjuge
+- Checar presença de embargos via busca no sistema processual
+- Confirmar publicação do edital nos veículos exigidos
+
+#### 1.2 Risco de Bem de Família
+
+- [ ] É o único imóvel do devedor? → **Alto risco de bem de família**
+- [ ] Devedor reside no imóvel? → **Alto risco**
+- [ ] Imóvel foi arguido como bem de família nos autos? → **Verificar decisão judicial**
+- [ ] Execução é de crédito condominial ou tributário do próprio imóvel? → Exceção legal (pode penhorar)
+- [ ] Fiança locatícia? → Súmula 549 STJ (pode penhorar — mas há divergência)
+
+#### 1.3 Risco de Ônus Reais Ocultos
+
+| Ônus | Como Detectar | Impacto |
+|------|--------------|---------|
+| Hipoteca anterior | Certidão de ônus reais | Alto |
+| Usufruto vitalício | Matrícula atualizada | Muito Alto |
+| Penhora anterior | Certidão do distribuidor | Médio |
+| Servidão | Matrícula | Médio |
+| Aforamento (marinha) | Matrícula + SPU | Médio |
+| Ação de usucapião | Distribuidor | Alto |
+| Promessa de compra e venda reg. | Matrícula | Alto |
+
+---
+
+## Categoria 2 — Riscos Financeiros
+
+#### 2.1 Risco de Débitos Acumulados
+
+```
+TABELA RÁPIDA:
+Débito estimado IPTU:          R$ ____________
+Débito estimado Condomínio:    R$ ____________
+Débito estimado Água:          R$ ____________
+Outros:                        R$ ____________
+TOTAL DÉBITOS:                 R$ ____________
+```
+
+> **Importante:** IPTU e Condomínio são dívidas *propter rem* — seguem o imóvel e o arrematante pagará.
+
+#### 2.2 Risco de Desocupação
+
+| Cenário | Custo Honorários | Prazo | Probabilidade |
+|---------|-----------------|-------|---------------|
+| Sai voluntariamente | R$ 0 | 0-30 dias | 20-30% |
+| Negociação + ajuda de custo | R$ 3-10k | 30-90 dias | 30-40% |
+| Ação de imissão sem resistência | R$ 5-15k | 3-6 meses | 20-30% |
+| Imissão + recursos do devedor | R$ 10-30k | 6-18 meses | 10-20% |
+| Processo longo + violência | R$ 20-50k | 12-36 meses | 5-10% |
+
+**Custo financeiro do tempo (capital imobilizado):**
+```
+Capital imobilizado × Taxa CDI × Meses / 12
+Exemplo: R$ 300.000 × 10,5% × 12 meses / 12 = R$ 31.500/ano
+```
+
+---
+
+## Categoria 3 — Riscos Operacionais
+
+#### 3.1 Risco de Não Conseguir Finalizar a Arrematação
+
+| Evento | Prazo | Probabilidade | Consequência |
+|--------|-------|---------------|-------------|
+| Devedor paga antes da assinatura | Qualquer momento | Baixo-Médio | Leilão desfeito |
+| Embargos com efeito suspensivo | Até o auto de arrematação | Baixo | Leilão suspenso |
+| Nulidade arguida em 10 dias | 10 dias após arrematação | Baixo | Anulação |
+
+#### 3.2 Sinais de Alerta (Fraude ou Manipulação)
+
+- ⚠️ Leiloeiro não cadastrado na Junta Comercial
+- ⚠️ Plataforma online desconhecida sem CNPJ verificável
+- ⚠️ Valor de avaliação muito incompatível com mercado
+- ⚠️ Edital publicado em prazo inferior ao legal
+- ⚠️ Exigência de depósito antes de visualizar documentos
+
+---
+
+## Categoria 4 — Riscos De Mercado E Sistêmicos
+
+#### 4.1 Risco de Liquidez no Momento da Saída
+
+| Cenário Macroeconômico | Impacto na Revenda |
+|-----------------------|-------------------|
+| Selic sobe mais (>14%) | Crédito encarece → demanda cai |
+| Recessão econômica | Mercado trava → pode levar 2-3x mais tempo |
+| Desemprego alto local | Comprador final some |
+| Novo empreendimento vizinho | Pressão de preço |
+| Evento local negativo | Deságio adicional de 20-40% |
+
+#### 4.2 Risco Ambiental e Geotécnico
+
+- [ ] Imóvel em área de risco de deslizamento (CEMADEN)?
+- [ ] Imóvel em área de inundação (plano diretor municipal)?
+- [ ] Imóvel em APP (Área de Preservação Permanente)?
+- [ ] Contaminação do solo?
+
+**Fontes de consulta:** CEMADEN (cemaden.gov.br), Prefeitura Municipal, IBGE Malha Digital
+
+---
+
+## Sistema de Scoring (36 pontos)
+
+```
+RISCOS JURÍDICOS:
+[ ] Intimação cônjuge confirmada?         Sim: 0 / Não: 3 / Não verificado: 2
+[ ] Embargos com efeito suspensivo?       Não: 0 / Sim: 4
+[ ] Bem de família provável?              Não: 0 / Possível: 2 / Provável: 4
+[ ] Ônus reais verificados e ok?          Sim: 0 / Não verificado: 2 / Ônus grave: 4
+[ ] Documentação regular?                 Sim: 0 / Irregular menor: 1 / Grave: 3
+
+RISCOS FINANCEIROS:
+[ ] Débitos IPTU + Cond. quantificados?   Sim (até 10% VMP): 0 / Altos (>10%): 2 / Não verificado: 2
+[ ] Situação da posse?                    Desocupado: 0 / Cooperativo: 1 / Litigioso: 3
+[ ] Obras necessárias?                    Não: 0 / Leves: 1 / Pesadas: 3
+
+RISCOS OPERACIONAIS:
+[ ] Leiloeiro verificado?                 Sim: 0 / Não: 2
+[ ] Processo verificado no TJ?            Sim: 0 / Não: 2
+[ ] Edital está completo?                 Sim: 0 / Incompleto: 2
+
+RISCOS DE MERCADO:
+[ ] Liquidez local?                       Alta: 0 / Média: 1 / Baixa: 3
+[ ] Risco ambiental?                      Baixo: 0 / Médio: 2 / Alto: 4
+
+SCORE TOTAL: ___ / 36
+
+CLASSIFICAÇÃO:
+0-5:   BAIXO RISCO ✅ — Proceder com segurança
+6-10:  MÉDIO RISCO ⚠️ — Mitigar os pontos identificados
+11-18: ALTO RISCO 🔴 — Só com expertise e desconto maior
+19+:   MUITO ALTO RISCO ❌ — Evitar, salvo especialista experiente
+```
+
+---
+
+## Tomada De Decisão — Árvore De Decisão
+
+```
+SCORE DE RISCO:
+
+≤ 5 (BAIXO):
+  → ROI líquido > CDI? SIM → ARREMATAR
+  → ROI líquido > CDI? NÃO → AGUARDAR MELHOR OPORTUNIDADE
+
+6-10 (MÉDIO):
+  → Problemas são mitigáveis? SIM + ROI > CDI+5% → ARREMATAR com cautelas
+  → Problemas são mitigáveis? NÃO → NÃO ARREMATAR
+
+11-18 (ALTO):
+  → Você é especialista? SIM + ROI > CDI+15% → AVALIAR COM ADVOGADO
+  → Você é especialista? NÃO → NÃO ARREMATAR
+
+> 18 (MUITO ALTO):
+  → NÃO ARREMATAR (salvo casos excepcionais com assessoria)
+```
+
+---
+
+## Stress Test do Investimento
+
+```
+CENÁRIO OTIMISTA (probabilidade 20%):
+  - Vende pelo VMP em 3 meses
+  - Sem custos extras de desocupação
+  - ITBI sobre lance (não sobre VMP)
+  - ROI: ___ %
+
+CENÁRIO BASE (probabilidade 50%):
+  - Vende com 10% desconto sobre VMP em 6 meses
+  - Custo de desocupação negociado (R$ 5k)
+  - ITBI sobre VMP
+  - ROI: ___ %
+
+CENÁRIO PESSIMISTA (probabilidade 25%):
+  - Vende com 20% desconto sobre VMP em 12 meses
+  - Ação de imissão na posse (R$ 15k + 6 meses)
+  - Reforma necessária (R$ 30k)
+  - ROI: ___ %
+
+CENÁRIO CATASTRÓFICO (probabilidade 5%):
+  - Arrematação anulada (capital devolvido mas tempo perdido)
+  - OU: não consegue vender em 24 meses
+  - ROI: ___ % (possivelmente negativo)
+
+ROI PONDERADO (esperança matemática):
+= (ROI otimista × 0,20) + (ROI base × 0,50) + (ROI pessimista × 0,25)
+  + (ROI catastrófico × 0,05)
+
+Se ROI ponderado > CDI → ARREMATAR
+Se ROI ponderado < CDI → NÃO VALE O RISCO
+```
+
+---
+
+## Checklist de Due Diligence
+
+### Obrigatórias (Sempre, Para Qualquer Lote)
+- [ ] Certidão de ônus reais (matrícula atualizada) — R$ 50-150
+- [ ] Certidão negativa de IPTU (ou extrato de débitos)
+- [ ] Leitura completa do edital
+- [ ] Pesquisa do processo no sistema do TJ
+- [ ] Verificar leiloeiro na Junta Comercial
+
+### Complementares (Quando Score > 5)
+- [ ] Certidão do distribuidor cível
+- [ ] Extrato de débitos de condomínio
+- [ ] Visita ao imóvel ou Google Street View
+- [ ] Extrato de débitos de água/saneamento
+
+### Para Lotes De Alto Valor (>R$ 500K)
+- [ ] Parecer com advogado especialista
+- [ ] Laudo de vistoria técnica (engenheiro)
+- [ ] Pesquisa de comparáveis com corretor CRECI local
+
+---
+
+## Glossário De Riscos
+
+| Termo | Definição |
+|-------|-----------|
+| Propter Rem | Obrigação que segue o bem (IPTU, condomínio) — não desaparece com a venda |
+| Stress Test | Simulação do pior cenário possível para o investimento |
+| Due Diligence | Diligência prévia completa antes de arrematar |
+| ROI Ponderado | Retorno esperado considerando probabilidade de cada cenário |
+| VMP | Valor de Mercado do Imóvel (avaliação judicial) |
+| Fraude à Execução | Alienação do bem após a citação para frustrar a execução (Art. 792 CPC) |
+
+## Referências Legais
+
+- CPC/2015 — Arts. 829-925 (Execução e Arrematação)
+- Lei 9.514/1997 — Alienação Fiduciária
+- Lei 8.009/1990 — Bem de Família
+- STJ Tema 1.113 — ITBI deve incidir sobre valor efetivo da transação
+- CTN Art. 130 — responsabilidade tributária propter rem

package/.agent/skills/skill-developer/SKILL.md

@@ -0,0 +1,150 @@
+---
+name: skill-developer
+description: Guide for creating and managing skills in Antigravity/Claude Code. Use when creating new skills, understanding YAML frontmatter format, writing SKILL.md files, setting up trigger patterns, following the 500-line rule, or debugging skill activation issues.
+tags: [skill-development, antigravity, claude-code, yaml, frontmatter, triggers, skill-creation]
+triggers: [create a skill, new skill, skill template, skill frontmatter, SKILL.md, skill trigger, skill activation, 500-line rule, add skill to project]
+risk: safe
+source: sickn33/antigravity-awesome-skills
+date_added: "2026-03-15"
+---
+
+# Skill Developer Guide
+
+Guia completo para criar e gerenciar skills no Antigravity/Claude Code, seguindo as melhores práticas da Anthropic incluindo a regra das 500 linhas e o padrão de divulgação progressiva.
+
+---
+
+## Estrutura de uma Skill
+
+```
+.agent/skills/
+└── minha-skill/
+    ├── SKILL.md          ← arquivo principal (obrigatório, < 500 linhas)
+    └── references/       ← detalhes opcionais referenciados pelo SKILL.md
+        └── guia-avancado.md
+```
+
+---
+
+## Template de SKILL.md
+
+```markdown
+---
+name: minha-skill
+description: Descrição breve incluindo palavras-chave que disparam esta skill.
+  Mencione tópicos, tipos de arquivo e casos de uso. Seja explícito sobre termos gatilho.
+tags: [tag1, tag2, tag3]
+triggers: [frase gatilho 1, frase gatilho 2, keyword]
+risk: safe
+source: community
+date_added: "2025-01-15"
+---
+
+# Nome da Skill
+
+## Propósito
+Para que esta skill serve.
+
+## Quando Usar
+Cenários específicos e condições.
+
+## Informação Principal
+A orientação real, documentação, padrões, exemplos.
+```
+
+---
+
+## Regras de Ouro (Anthropic Best Practices)
+
+| Regra | Detalhe |
+|-------|---------|
+| **< 500 linhas** | SKILL.md deve ter menos de 500 linhas — use arquivos de referência para detalhes |
+| **Descrição com keywords** | Inclua TODOS os termos que disparam esta skill (max 1024 chars) |
+| **Títulos claros** | Nomes em minúsculo com hífens, forma gerundiva preferida (verb + -ing) |
+| **Exemplos reais** | Inclua exemplos de código reais, não genéricos |
+| **Divulgação progressiva** | SKILL.md = visão geral; `references/` = profundidade |
+
+---
+
+## Campos do Frontmatter
+
+```yaml
+---
+name: nome-da-skill           # obrigatório: identificador único
+description: "texto..."       # obrigatório: inclui triggers e contexto
+tags: [tag1, tag2]            # recomendado: para indexação e busca
+triggers: [frase, keyword]    # recomendado: termos que ativam a skill
+risk: safe                    # safe | caution | dangerous
+source: community             # origem da skill
+date_added: "2025-01-15"      # data de adição
+---
+```
+
+---
+
+## Como Criar uma Skill — Passo a Passo
+
+### 1. Crie o arquivo
+```bash
+mkdir -p .agent/skills/minha-skill
+touch .agent/skills/minha-skill/SKILL.md
+```
+
+### 2. Escreva o conteúdo
+Siga o template acima. Foque em:
+- **Propósito**: o que esta skill FAZ?
+- **Quando usar**: condições específicas, não genéricas
+- **Exemplos**: código real, comandos reais
+
+### 3. Teste os gatilhos
+Confirme que os `triggers` no frontmatter cobrem as frases que o usuário usaria naturalmente.
+
+Exemplos de bons triggers:
+```yaml
+triggers: [create new component, add react component, novo componente react]
+```
+
+### 4. Adicione ao GEMINI.md ou arquivos de configuração
+Para que o Antigravity indexe a skill, ela precisa estar no diretório `.agent/skills/` do projeto.
+
+### 5. Iterate
+- Teste com 3+ cenários reais antes de considerar pronto
+- Refine os triggers baseado no uso real
+- Adicione sections `references/` se ultrapassar 500 linhas
+
+---
+
+## Checklist de Qualidade
+
+```
+[ ] SKILL.md tem menos de 500 linhas?
+[ ] Frontmatter tem `name` e `description`?
+[ ] Description inclui palavras-chave que ativariam esta skill?
+[ ] Triggers são naturais e cobrem variações de linguagem?
+[ ] Há pelo menos um exemplo real no conteúdo?
+[ ] A skill tem um propósito claro e delimitado?
+[ ] Se > 300 linhas, há `references/` para detalhes?
+```
+
+---
+
+## Divulgação Progressiva
+
+Para skills complexas, divida o conteúdo:
+
+```
+SKILL.md (visão geral, < 500 linhas)
+├── Propósito e quando usar
+├── Conceitos chave com exemplos breves
+└── Links para: [guia-avancado.md](./references/guia-avancado.md)
+
+references/guia-avancado.md (detalhe técnico)
+├── Tópico 1 aprofundado
+├── Tópico 2 aprofundado
+└── Edge cases e troubleshooting
+```
+
+## Related Skills
+- `intelligent-routing` — como o Antigravity faz o roteamento automático de skills
+- `clean-code` — boas práticas aplicadas à própria escrita de skills
+- `brainstorming` — exploração antes de criar uma skill nova

package/.agent/skills/uncle-bob-craft/SKILL.md

@@ -0,0 +1,124 @@
+---
+name: uncle-bob-craft
+description: Applies Uncle Bob's body of work for code review and writing. Use when reviewing code, refactoring, discussing architecture, evaluating SOLID principles, identifying code smells, or discussing Clean Architecture, Clean Code, The Clean Coder principles.
+tags: [clean-code, clean-architecture, solid, code-review, craftsmanship, refactoring, code-smells]
+triggers: [code review, clean code, SOLID, refactor, architecture review, code smell, dependency rule, uncle bob, clean architecture, single responsibility, open closed, liskov, interface segregation, dependency inversion]
+risk: safe
+source: sickn33/antigravity-awesome-skills
+date_added: "2026-03-15"
+---
+
+# Uncle Bob Craft
+
+Agrega os princípios dos livros do Uncle Bob para **revisão** e **escrita** de código: nomenclatura e funções (Clean Code), arquitetura e fronteiras (Clean Architecture), profissionalismo e estimativa (The Clean Coder), valores ágeis (Clean Agile), e uso vs abuso de design patterns.
+
+> **Não substitui** o linter, formatter ou testes automatizados do projeto — esses permanecem responsabilidade das ferramentas do projeto.
+
+---
+
+## Quando Usar
+
+- **Code review**: Aplique Dependency Rule, fronteiras, SOLID, e heurísticas de smell; sugira refactors concretos
+- **Refactoring**: Decida o que extrair, onde desenhar fronteiras, e se um design pattern é justificado
+- **Discussão de arquitetura**: Verifique camadas, direção de dependências, e separação de interesses
+- **Design patterns**: Avalie uso correto vs cargo-cult ou overuse antes de introduzir um pattern
+- **Estimativa e profissionalismo**: Aplique ideias do Clean Coder (dizer não, ritmo sustentável, estimativas de 3 pontos)
+
+---
+
+## Fontes por Livro
+
+| Fonte | Foco |
+|-------|------|
+| **Clean Code** | Nomes, funções, comentários, formatação, testes, classes, smells |
+| **Clean Architecture** | Dependency Rule, camadas, fronteiras, SOLID na arquitetura |
+| **The Clean Coder** | Profissionalismo, estimativa, dizer não, ritmo sustentável |
+| **Clean Agile** | Valores, Iron Cross, TDD, refactoring, pair programming |
+| **Design Patterns** | Quando usar, abuso, cargo cult |
+
+---
+
+## Dependency Rule (Clean Architecture)
+
+```
+Externas → Frameworks/Drivers
+           → Interface Adapters
+             → Application Business Rules
+               → Enterprise Business Rules (Entities)
+```
+
+- Dependências apontam **para dentro** (em direção às Entities)
+- Camadas internas **não conhecem** camadas externas
+- **Violação**: quando uma Entity importa algo de um Controller
+
+---
+
+## SOLID em Contexto
+
+| Princípio | Verificação Rápida |
+|-----------|-------------------|
+| **SRP** | Esta classe/função tem mais de um motivo para mudar? |
+| **OCP** | Posso adicionar comportamento sem modificar código existente? |
+| **LSP** | Posso substituir por uma subclasse sem quebrar o sistema? |
+| **ISP** | A interface tem métodos que os clientes não usam? |
+| **DIP** | Módulos de alto nível dependem de abstrações, não de implementações? |
+
+---
+
+## Design Patterns: Uso vs Abuso
+
+- **Use patterns** quando resolvem um problema de design real (variação de comportamento, ciclo de vida, cross-cutting)
+- **Evite cargo-cult**: não adicione Factory/Strategy/Repository só porque o codebase "deveria" tê-los
+- **Sinais de abuso**: nome do pattern em toda classe, camadas que só delegam sem lógica, patterns que tornam código simples mais difícil
+- **Regra de ouro**: introduza um pattern na terceira duplicação ou segunda razão para mudar
+
+---
+
+## Code Smells e Heurísticas
+
+| Smell | Significado |
+|-------|-------------|
+| **Rigidity** | Pequena mudança força muitas edições |
+| **Fragility** | Mudanças quebram áreas não relacionadas |
+| **Immobility** | Difícil de reusar em outro contexto |
+| **Viscosity** | Fácil de hackear, difícil de fazer a coisa certa |
+| **Needless Complexity** | Abstração especulativa ou não usada |
+| **Needless Repetition** | DRY violado; mesma ideia em múltiplos lugares |
+| **Opacity** | Código difícil de entender |
+
+---
+
+## Aplicação por Contexto
+
+| Contexto | Aplicar |
+|----------|---------|
+| **Code review** | Dependency Rule e fronteiras; SOLID em contexto; listar smells; sugerir 1-2 refactors concretos (ex: extrair função, inverter dependência); verificar testes |
+| **Escrevendo código** | Prefira funções pequenas e responsabilidade única; dependa para dentro (Clean Architecture); escreva testes primeiro quando fazendo TDD; evite patterns até duplicação ou variação justificar |
+| **Refactoring** | Identifique um smell por vez; refatore em pequenos passos com testes verdes; melhore nomes e estrutura antes de adicionar comportamento |
+
+---
+
+## Ao Fazer Code Review
+
+```
+1. Dependency Rule está sendo respeitada?
+2. SOLID violations óbvias?
+3. Code smells presentes?
+4. Nomes comunicam intenção?
+5. Funções fazem uma coisa?
+6. Testes presentes e significativos?
+7. Design patterns justificados (ou desnecessários)?
+```
+
+**Formato de sugestão:**
+```
+Smell: [nome]
+Local: [arquivo/função]
+Refactor: [sugestão concreta]
+Justificativa: [qual princípio ou heurística]
+```
+
+## Related Skills
+- `clean-code` — regras práticas de código limpo
+- `code-reviewer` — processo de code review
+- `software-architecture` — padrões de arquitetura limpa e DDD

package/.agent/workflows/analyze-project.md

@@ -0,0 +1,15 @@
+---
+description: Forensic root cause analyzer for Antigravity sessions. Analyzes brain/ artifacts to classify scope deltas, rework patterns, root causes, and hotspots.
+---
+
+# /analyze-project — Análise Forense de Sessões
+
+Ativa a análise forense das suas sessões no Antigravity.
+
+1. Leia o arquivo [SKILL.md](file:///Users/ruy/Code/mySkills/.agent/skills/analyze-project/SKILL.md).
+2. Acesse a pasta `~/.gemini/antigravity/brain/` e liste todas as conversas disponíveis.
+3. Para cada conversa, extraia artefatos: `task.md`, `implementation_plan.md`, `walkthrough.md`.
+4. Execute os passos 1 a 10 do workflow de análise forense descritos na SKILL.
+5. Gere o relatório `session_analysis_report.md` na pasta brain da conversa atual.
+
+**Resultado esperado:** Relatório diagnóstico com causas raiz, padrões de retrabalho, zonas de atrito e recomendações de melhoria para sessões futuras.

package/README.md

@@ -134,6 +134,29 @@ Integramos todos os fluxos de trabalho essenciais:
 
 ---
 
+## 🆕 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:
 
@@ -302,9 +325,18 @@ npx @ruyfranca/myskills add <nome-do-agent> --agent
 # 6. Instalar TODAS as 40+ skills individuais
 npx @ruyfranca/myskills add --all
 
+# 7. 🆕 Atualizar o kit (skills + agents + workflows) no projeto atual
+npx @ruyfranca/myskills update
+
+# ou com opções granulares:
+npx @ruyfranca/myskills update --skills     # só as skills
+npx @ruyfranca/myskills update --agents     # só os agents
+npx @ruyfranca/myskills update --workflows  # só os workflows
+
 # Exemplo prático:
 npx @ruyfranca/myskills init
 npx @ruyfranca/myskills add frontend-developer --agent
+npx @ruyfranca/myskills update  # mantém o projeto atualizado
 ```
 
 ---

package/index.js

@@ -167,4 +167,46 @@ program
     }
   });
 
+program
+  .command('update')
+  .description('Atualiza skills, agents e workflows do projeto atual com a versão mais recente do kit')
+  .option('-s, --skills', 'Atualiza apenas as skills')
+  .option('-a, --agents', 'Atualiza apenas os agents')
+  .option('-w, --workflows', 'Atualiza apenas os workflows')
+  .action(async (options) => {
+    const updateAll = !options.skills && !options.agents && !options.workflows;
+
+    console.log(chalk.cyan('\n🔄 Atualizando kit do Antigravity...\n'));
+
+    const tasks = [];
+
+    if (updateAll || options.skills) {
+      tasks.push({ label: 'skills', src: path.join(__dirname, '.agent', 'skills'), dest: path.join(process.cwd(), '.agent', 'skills') });
+    }
+    if (updateAll || options.agents) {
+      tasks.push({ label: 'agents', src: path.join(__dirname, '.agent', 'agents'), dest: path.join(process.cwd(), '.agent', 'agents') });
+    }
+    if (updateAll || options.workflows) {
+      tasks.push({ label: 'workflows', src: path.join(__dirname, '.agent', 'workflows'), dest: path.join(process.cwd(), '.agent', 'workflows') });
+    }
+
+    for (const task of tasks) {
+      if (!await fs.pathExists(task.src)) {
+        console.log(chalk.yellow(`  ⚠️ Fonte não encontrada: ${task.label} (${task.src})`));
+        continue;
+      }
+      try {
+        await fs.ensureDir(task.dest);
+        await fs.copy(task.src, task.dest, { overwrite: true });
+        console.log(chalk.green(`  ✅ ${task.label}: atualizado com sucesso`));
+      } catch (err) {
+        console.error(chalk.red(`  ❌ ${task.label}: erro — ${err.message}`));
+      }
+    }
+
+    console.log(chalk.cyan.bold('\n✨ Atualização concluída!\n'));
+    console.log(chalk.gray('💡 Dica: reinicie o Antigravity para carregar as novas skills/workflows.\n'));
+  });
+
 program.parse();
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ruyfranca/myskills",
-  "version": "1.0.22",
+  "version": "1.0.25",
   "description": "Biblioteca de skills customizadas para Antigravity / Claude Code",
   "main": "index.js",
   "bin": {
@@ -8,7 +8,8 @@
   },
   "type": "module",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "update": "node index.js update"
   },
   "keywords": [
     "claude",