@ruyfranca/myskills 1.0.34 → 1.0.36

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

@@ -1,13 +1,12 @@
 ---
 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.
+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. / Testes e qualidade."
 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]
+triggers: [analise risco imovel leilao, auditor risco leilao, imovel seguro leilao, leiloeiro risco, risco leilao, roi ponderado leilao, score risco leilao, stress test leilao]
 risk: safe
 source: sickn33/antigravity-awesome-skills
 date_added: "2026-03-15"
 ---
-
 # SKILL DE RISCO — AUDITOR DE RISCO EM LEILÕES
 
 ## Overview

package/.agent/skills/lint-and-validate/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: lint-and-validate
-description: Automatic quality control, linting, and static analysis procedures. Use after every code modification to ensure syntax correctness and project standards. Triggers onKeywords: lint, format, check, validate, types, static analysis.
+description: "Automatic quality control, linting, and static analysis procedures. Use after every code modification to ensure syntax correctness and project standards. Triggers onKeywords: lint, format, check, validate, types, static analysis."
 allowed-tools: Read, Glob, Grep, Bash
+triggers: []
+risk: safe
+source: v4-migration
+date_added: "2026-04-22"
 ---
-
 # Lint and Validate Skill
 
 > **MANDATORY:** Run appropriate validation tools after EVERY code change. Do not finish a task until the code is error-free.

package/.agent/skills/marketing-campaigns/SKILL.md

@@ -1,8 +1,11 @@
 ---
 name: Executing Marketing Campaigns
-description: Planning, creation, and optimization of marketing campaigns, content strategy, and analytics.
+description: "Planning, creation, and optimization of marketing campaigns, content strategy, and analytics."
+triggers: [campanhas, copywriting, marketing, planejamento, roadmap, roteiro, vendas]
+risk: safe
+source: v4-migration
+date_added: "2026-04-22"
 ---
-
 # Executing Marketing Campaigns Skill
 
 You are a senior marketing strategist. Your goal is to plan and execute high-impact campaigns that drive measurable business results across multiple channels.

package/.agent/skills/mcp-builder/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: mcp-builder
-description: MCP (Model Context Protocol) server building principles. Tool design, resource patterns, best practices.
+description: "MCP (Model Context Protocol) server building principles. Tool design, resource patterns, best practices. / Desenvolvimento backend e APIs. Boas práticas e padrões."
 allowed-tools: Read, Write, Edit, Glob, Grep
+triggers: [design, experiência do usuário, ui, ux]
+risk: safe
+source: v4-migration
+date_added: "2026-04-22"
 ---
-
 # MCP Builder
 
 > Principles for building MCP servers.

package/.agent/skills/mobile-design/SKILL.md

@@ -1,8 +1,11 @@
 ---
 name: Mobile Design
-description: Mobile-first design thinking and expert implementation for iOS and Android apps (React Native, Flutter, Native).
+description: "Mobile-first design thinking and expert implementation for iOS and Android apps (React Native, Flutter, Native)."
+triggers: [android, aplicativo, app, design, experiência do usuário, ios, mobile, ui, ux]
+risk: safe
+source: v4-migration
+date_added: "2026-04-22"
 ---
-
 # Mobile Design Skill
 
 You are a senior mobile specialist. Your goal is to build high-performance, touch-first applications that respect platform conventions (iOS/Android) and prioritize accessibility and battery efficiency.

package/.agent/skills/modern-javascript-patterns/SKILL.md

@@ -4,8 +4,8 @@ description: "Master ES6+ features including async/await, destructuring, spread
 risk: unknown
 source: community
 date_added: "2026-02-27"
+triggers: []
 ---
-
 # Modern JavaScript Patterns
 
 Comprehensive guide for mastering modern JavaScript (ES6+) features, functional programming patterns, and best practices for writing clean, maintainable, and performant code.

package/.agent/skills/monorepo-architect/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: monorepo-architect
-description: "Expert in monorepo architecture, build systems, and dependency management at scale. Masters Nx, Turborepo, Bazel, and Lerna for efficient multi-project development."
+description: ""Expert in monorepo architecture, build systems, and dependency management at scale. Masters Nx, Turborepo, Bazel, and Lerna for efficient multi-project development.""
 risk: unknown
 source: community
 date_added: "2026-02-27"
+triggers: []
 ---
-
 # Monorepo Architect
 
 Expert in monorepo architecture, build systems, and dependency management at scale. Masters Nx, Turborepo, Bazel, and Lerna for efficient multi-project development. Use PROACTIVELY for monorepo setup, build optimization, or scaling development workflows across teams.

package/.agent/skills/nestjs/SKILL.md

@@ -1,8 +1,11 @@
 ---
 name: NestJS Expert
-description: Enterprise-grade Node.js architecture, dependency injection, module management, and testing.
+description: "Enterprise-grade Node.js architecture, dependency injection, module management, and testing. / Testes e qualidade."
+triggers: [api, backend, cobertura, garantia de qualidade, nestjs, node.js, qa, servidor, testes]
+risk: safe
+source: v4-migration
+date_added: "2026-04-22"
 ---
-
 # NestJS Expert Skill
 
 You are an expert in NestJS and enterprise Node.js architecture. Your goal is to build scalable, maintainable, and well-tested backend applications following the framework's best practices.

package/.agent/skills/nextjs-best-practices/SKILL.md

@@ -1,8 +1,11 @@
 ---
 name: Next.js Best Practices
-description: Modern App Router development principles, Server Components, and data fetching.
+description: ""Modern App Router development principles, Server Components, and data fetching." / Desenvolvimento backend e APIs."
+triggers: []
+risk: safe
+source: v4-migration
+date_added: "2026-04-22"
 ---
-
 # Next.js Best Practices Skill
 
 You are a senior Next.js architect. Your goal is to build fast, scalable web applications using the App Router and React Server Components (RSC).

package/.agent/skills/nextjs-react-expert/SKILL.md

@@ -4,8 +4,8 @@ description: "React and Next.js performance optimization from Vercel Engineering
 risk: unknown
 source: community
 date_added: "2026-02-27"
+triggers: [ciclo de vida, componentes react, desempenho, design de interface, hooks, interface de usuário, otimização, performance, react, ui, ux]
 ---
-
 # React Best Practices (Vercel)
 
 Comprehensive performance optimization guide for React and Next.js applications, maintained by Vercel. Contains rules across 8 categories, prioritized by impact.

package/.agent/skills/parallel-agents/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: parallel-agents
-description: Multi-agent orchestration patterns. Use when multiple independent tasks can run with different domain expertise or when comprehensive analysis requires multiple perspectives.
+description: "Multi-agent orchestration patterns. Use when multiple independent tasks can run with different domain expertise or when comprehensive analysis requires multiple perspectives. / Boas práticas e padrões."
 allowed-tools: Read, Glob, Grep
+triggers: []
+risk: safe
+source: v4-migration
+date_added: "2026-04-22"
 ---
-
 # Native Parallel Agents
 
 > Orchestration through Antigravity's built-in Agent Tool

package/.agent/skills/pdf-processing-pro/SKILL.md

@@ -1,8 +1,11 @@
 ---
 name: PDF Processing Pro
-description: Enterprise-grade PDF manipulation including forms, tables, OCR, and document validation.
+description: "Enterprise-grade PDF manipulation including forms, tables, OCR, and document validation."
+triggers: []
+risk: safe
+source: v4-migration
+date_added: "2026-04-22"
 ---
-
 # PDF Processing Pro Skill
 
 This skill provides an enterprise-ready toolkit for complex PDF workflows. You are an expert in document processing, specializing in extracting data from unstructured PDFs, managing interactive forms, and performing high-volume batch operations.

package/.agent/skills/performance-profiling/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: performance-profiling
-description: Performance profiling principles. Measurement, analysis, and optimization techniques.
+description: "Performance profiling principles. Measurement, analysis, and optimization techniques."
 allowed-tools: Read, Glob, Grep, Bash
+triggers: []
+risk: safe
+source: v4-migration
+date_added: "2026-04-22"
 ---
-
 # Performance Profiling
 
 > Measure, analyze, optimize - in that order.

package/.agent/skills/powershell-windows/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: powershell-windows
-description: PowerShell Windows patterns. Critical pitfalls, operator syntax, error handling.
+description: "PowerShell Windows patterns. Critical pitfalls, operator syntax, error handling. / Boas práticas e padrões."
 allowed-tools: Read, Write, Edit, Glob, Grep, Bash
+triggers: []
+risk: safe
+source: v4-migration
+date_added: "2026-04-22"
 ---
-
 # PowerShell Windows Patterns
 
 > Critical patterns and pitfalls for Windows PowerShell.

package/.agent/skills/pptx/SKILL.md

@@ -1,8 +1,11 @@
 ---
 name: PPTX Automation
-description: Professional presentation creation, editing, and analysis with support for layouts, themes, and automated workflows.
+description: "Professional presentation creation, editing, and analysis with support for layouts, themes, and automated workflows."
+triggers: []
+risk: safe
+source: v4-migration
+date_added: "2026-04-22"
 ---
-
 # PPTX Automation Skill
 
 You are a presentation specialist. You create, edit, and analyze PowerPoint presentations (.pptx) with a focus on visual hierarchy, consistency, and professional design.

package/.agent/skills/product-manager/SKILL.md

@@ -1,8 +1,11 @@
 ---
 name: Product Manager
-description: Senior product manager expertise for strategy, prioritization, and roadmaps.
+description: "Senior product manager expertise for strategy, prioritization, and roadmaps."
+triggers: []
+risk: safe
+source: v4-migration
+date_added: "2026-04-22"
 ---
-
 # Product Manager Skill
 
 You are a senior product manager with expertise in building successful products that delight users and achieve business objectives. Your focus spans product strategy, user research, feature prioritization, and go-to-market execution with emphasis on data-driven decisions and continuous iteration.

package/.agent/skills/python-patterns/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: python-patterns
-description: Python development principles and decision-making. Framework selection, async patterns, type hints, project structure. Teaches thinking, not copying.
+description: "Python development principles and decision-making. Framework selection, async patterns, type hints, project structure. Teaches thinking, not copying. / Boas práticas e padrões."
 allowed-tools: Read, Write, Edit, Glob, Grep
+triggers: []
+risk: safe
+source: v4-migration
+date_added: "2026-04-22"
 ---
-
 # Python Patterns
 
 > Python development principles and decision-making for 2025.

package/.agent/skills/react-best-practices/SKILL.md

@@ -0,0 +1,208 @@
+---
+name: react-best-practices
+description: "Comprehensive React and Next.js performance optimization guide with 40+ rules for eliminating waterfalls, optimizing bundles, and improving rendering. Triggers on react refactoring, performance optimization, and bundle size reduction."
+tags: [React, Next.js, Performance, Optimization, Best Practices, Bundle Size, Rendering, Server Components]
+triggers: [RSC optimization, bundle size, corrigir waterfall, fix waterfall, optimize react, otimizar react, otimização de renderização, performance react, performance review, react performance, refactor react, refatorar react, render optimization, revisão de performance, tamanho do bundle]
+risk: safe
+source: vercel-engineering
+date_added: "2026-04-22"
+---
+# React Best Practices - Performance Optimization
+
+Comprehensive performance optimization guide for React and Next.js applications with 40+ rules organized by impact level. Designed to help developers eliminate performance bottlenecks and follow best practices.
+
+## When to use this skill
+
+**Use React Best Practices when:**
+- Optimizing React or Next.js application performance
+- Reviewing code for performance improvements
+- Refactoring existing components for better performance
+- Implementing new features with performance in mind
+- Debugging slow rendering or loading issues
+- Reducing bundle size
+- Eliminating request waterfalls
+
+**Key areas covered:**
+- **Eliminating Waterfalls** (CRITICAL): Prevent sequential async operations
+- **Bundle Size Optimization** (CRITICAL): Reduce initial JavaScript payload
+- **Server-Side Performance** (HIGH): Optimize RSC and data fetching
+- **Client-Side Data Fetching** (MEDIUM-HIGH): Implement efficient caching
+- **Re-render Optimization** (MEDIUM): Minimize unnecessary re-renders
+- **Rendering Performance** (MEDIUM): Optimize browser rendering
+- **JavaScript Performance** (LOW-MEDIUM): Micro-optimizations for hot paths
+- **Advanced Patterns** (LOW): Specialized techniques for edge cases
+
+## Quick reference
+
+### Critical priorities
+
+1. **Defer await until needed** - Move awaits into branches where they're used
+2. **Use Promise.all()** - Parallelize independent async operations
+3. **Avoid barrel imports** - Import directly from source files
+4. **Dynamic imports** - Lazy-load heavy components
+5. **Strategic Suspense** - Stream content while showing layout
+
+### Common patterns
+
+**Parallel data fetching:**
+```typescript
+const [user, posts, comments] = await Promise.all([
+  fetchUser(),
+  fetchPosts(),
+  fetchComments()
+])
+```
+
+**Direct imports:**
+```tsx
+// ❌ Loads entire library
+import { Check } from 'lucide-react'
+
+// ✅ Loads only what you need
+import Check from 'lucide-react/dist/esm/icons/check'
+```
+
+**Dynamic components:**
+```tsx
+import dynamic from 'next/dynamic'
+
+const MonacoEditor = dynamic(
+  () => import('./monaco-editor'),
+  { ssr: false }
+)
+```
+
+## Using the guidelines
+
+The complete performance guidelines are available in the references folder:
+
+- **react-performance-guidelines.md**: Complete guide with all 40+ rules, code examples, and impact analysis
+
+Each rule includes:
+- Incorrect/correct code comparisons
+- Specific impact metrics
+- When to apply the optimization
+- Real-world examples
+
+## Categories overview
+
+### 1. Eliminating Waterfalls (CRITICAL)
+Waterfalls are the #1 performance killer. Each sequential await adds full network latency.
+- Defer await until needed
+- Dependency-based parallelization
+- Prevent waterfall chains in API routes
+- Promise.all() for independent operations
+- Strategic Suspense boundaries
+
+### 2. Bundle Size Optimization (CRITICAL)
+Reducing initial bundle size improves Time to Interactive and Largest Contentful Paint.
+- Avoid barrel file imports
+- Conditional module loading
+- Defer non-critical third-party libraries
+- Dynamic imports for heavy components
+- Preload based on user intent
+
+### 3. Server-Side Performance (HIGH)
+Optimize server-side rendering and data fetching.
+- Cross-request LRU caching
+- Minimize serialization at RSC boundaries
+- Parallel data fetching with component composition
+- Per-request deduplication with React.cache()
+
+### 4. Client-Side Data Fetching (MEDIUM-HIGH)
+Automatic deduplication and efficient data fetching patterns.
+- Deduplicate global event listeners
+- Use SWR for automatic deduplication
+
+### 5. Re-render Optimization (MEDIUM)
+Reduce unnecessary re-renders to minimize wasted computation.
+- Defer state reads to usage point
+- Extract to memoized components
+- Narrow effect dependencies
+- Subscribe to derived state
+- Use lazy state initialization
+- Use transitions for non-urgent updates
+
+### 6. Rendering Performance (MEDIUM)
+Optimize the browser rendering process.
+- Animate SVG wrapper instead of SVG element
+- CSS content-visibility for long lists
+- Hoist static JSX elements
+- Optimize SVG precision
+- Prevent hydration mismatch without flickering
+- Use Activity component for show/hide
+- Use explicit conditional rendering
+
+### 7. JavaScript Performance (LOW-MEDIUM)
+Micro-optimizations for hot paths.
+- Batch DOM CSS changes
+- Build index maps for repeated lookups
+- Cache property access in loops
+- Cache repeated function calls
+- Cache storage API calls
+- Combine multiple array iterations
+- Early length check for array comparisons
+- Early return from functions
+- Hoist RegExp creation
+- Use loop for min/max instead of sort
+- Use Set/Map for O(1) lookups
+- Use toSorted() instead of sort()
+
+### 8. Advanced Patterns (LOW)
+Specialized techniques for edge cases.
+- Store event handlers in refs
+- useLatest for stable callback refs
+
+## Implementation approach
+
+When optimizing a React application:
+
+1. **Profile first**: Use React DevTools Profiler and browser performance tools to identify bottlenecks
+2. **Focus on critical paths**: Start with eliminating waterfalls and reducing bundle size
+3. **Measure impact**: Verify improvements with metrics (LCP, TTI, FID)
+4. **Apply incrementally**: Don't over-optimize prematurely
+5. **Test thoroughly**: Ensure optimizations don't break functionality
+
+## Key metrics to track
+
+- **Time to Interactive (TTI)**: When page becomes fully interactive
+- **Largest Contentful Paint (LCP)**: When main content is visible
+- **First Input Delay (FID)**: Responsiveness to user interactions
+- **Cumulative Layout Shift (CLS)**: Visual stability
+- **Bundle size**: Initial JavaScript payload
+- **Server response time**: TTFB for server-rendered content
+
+## Common pitfalls to avoid
+
+❌ **Don't:**
+- Use barrel imports from large libraries
+- Block parallel operations with sequential awaits
+- Re-render entire trees when only part needs updating
+- Load analytics/tracking in the critical path
+- Mutate arrays with .sort() instead of .toSorted()
+- Create RegExp or heavy objects inside render
+
+✅ **Do:**
+- Import directly from source files
+- Use Promise.all() for independent operations
+- Memoize expensive components
+- Lazy-load non-critical code
+- Use immutable array methods
+- Hoist static objects outside components
+
+## Resources
+
+- [React Documentation](https://react.dev)
+- [Next.js Documentation](https://nextjs.org)
+- [SWR Documentation](https://swr.vercel.app)
+- [Vercel Bundle Optimization](https://vercel.com/blog/how-we-optimized-package-imports-in-next-js)
+- [Vercel Dashboard Performance](https://vercel.com/blog/how-we-made-the-vercel-dashboard-twice-as-fast)
+- [better-all Library](https://github.com/shuding/better-all)
+- [node-lru-cache](https://github.com/isaacs/node-lru-cache)
+
+## Version history
+
+**v0.1.0** (January 2026)
+- Initial release from Vercel Engineering
+- 40+ performance rules across 8 categories
+- Comprehensive code examples and impact analysis