Communitygithub.com

ComeOnOliver/skillshub

Escreva, revise ou melhore código SwiftUI seguindo as melhores práticas para gerenciamento de estado, composição de views, desempenho, APIs específicas do macOS e adoção do Liquid Glass do iOS 26+. Use ao criar novos recursos SwiftUI, refatorar views existentes, revisar qualidade de código ou adotar padrões modernos do SwiftUI.

O que é skillshub?

Esta habilidade transforma o agente em um especialista em SwiftUI, fornecendo diretrizes detalhadas para escrever, revisar e otimizar código SwiftUI. Ela cobre desde gerenciamento de estado com `@State`, `@Binding`, `@StateObject` e `@Observable` até composição de views, animações, desempenho, e integração com recursos modernos como Liquid Glass (iOS 26+). A habilidade opera em múltiplas plataformas, incluindo iOS, macOS, visionOS e watchOS, e inclui um roteador de tópicos que direciona o agente para arquivos de referência especializados (como `references/state-management.md` ou `references/performance-patterns.md`) de acordo com a tarefa. O agente também segue uma checklist de correção rígida para evitar bugs comuns, como o uso incorreto de `@State` ou `ForEach` com identidade instável. A principal utilidade é garantir que o código produzido ou revisado esteja alinhado com as mais recentes melhores práticas da Apple, evitando APIs obsoletas e promovendo views eficientes, acessíveis e de fácil manutenção.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/AvdLee/SwiftUI-Agent-Skill/swiftui-expert-skill

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Habilidade de Especialista em SwiftUI

Regras Operacionais

  • Consulte references/latest-apis.md no início de cada tarefa para evitar APIs obsoletas
  • Prefira APIs nativas do SwiftUI em vez de bridge com UIKit/AppKit, a menos que seja necessário
  • Foco em correção e desempenho; não imponha arquiteturas específicas (MVVM, VIPER, etc.)
  • Incentive a separação da lógica de negócios das views para testabilidade, sem exigir como fazer
  • Siga as Diretrizes de Interface Humana e os padrões de design de API da Apple
  • Adote o Liquid Glass apenas quando solicitado explicitamente pelo usuário (veja references/liquid-glass.md)
  • Apresente otimizações de desempenho como sugestões, não como requisitos
  • Use proteção #available com fallbacks sensatos para APIs específicas de versão

Fluxo de Tarefas

Revisar código SwiftUI existente

  • Leia o código sob revisão e identifique quais tópicos se aplicam
  • Sinalize APIs obsoletas (compare com references/latest-apis.md)
  • Execute o Roteador de Tópicos abaixo para cada tópico relevante
  • Valide a proteção #available e os caminhos de fallback para recursos do iOS 26+

Melhorar código SwiftUI existente

  • Audite a implementação atual em relação aos tópicos do Roteador de Tópicos
  • Substitua APIs obsoletas por equivalentes modernos de references/latest-apis.md
  • Refatore caminhos críticos para reduzir atualizações de estado desnecessárias
  • Extraia corpos de view complexos em subviews separadas
  • Sugira downsampling de imagem quando UIImage(data:) for encontrado (otimização opcional, veja references/image-optimization.md)

Implementar novo recurso SwiftUI

  • Projete o fluxo de dados primeiro: identifique estado próprio vs. estado injetado
  • Estruture views para diffing otimizado (extraia subviews cedo)
  • Aplique padrões de animação corretos (implícita vs. explícita, transições)
  • Use Button para todos os elementos tocáveis; adicione agrupamento e rótulos de acessibilidade
  • Proteja APIs específicas de versão com #available e forneça fallbacks

Roteador de Tópicos

Consulte o arquivo de referência para cada tópico relevante à tarefa atual:

TópicoReferência
Gerenciamento de estadoreferences/state-management.md
Composição de viewsreferences/view-structure.md
Desempenhoreferences/performance-patterns.md
Listas e ForEachreferences/list-patterns.md
Layoutreferences/layout-best-practices.md
Sheets e navegaçãoreferences/sheet-navigation-patterns.md
ScrollViewreferences/scroll-patterns.md
Animações (básico)references/animation-basics.md
Animações (transições)references/animation-transitions.md
Animações (avançado)references/animation-advanced.md
Acessibilidadereferences/accessibility-patterns.md
Swift Chartsreferences/charts.md
Acessibilidade de gráficosreferences/charts-accessibility.md
Otimização de imagensreferences/image-optimization.md
Liquid Glass (iOS 26+)references/liquid-glass.md
Cenas macOSreferences/macos-scenes.md
Estilização de janelas macOSreferences/macos-window-styling.md
Views macOSreferences/macos-views.md
Consulta de APIs obsoletasreferences/latest-apis.md

Checklist de Correção

Estas são regras rígidas — violações são sempre bugs:

  • Propriedades @State são private
  • @Binding apenas onde um filho modifica o estado do pai
  • Valores passados nunca são declarados como @State ou @StateObject (eles ignoram atualizações)
  • @StateObject para objetos próprios da view; @ObservedObject para objetos injetados
  • iOS 17+: @State com @Observable; @Bindable para observáveis injetados que precisam de bindings
  • ForEach usa identidade estável (nunca .indices para conteúdo dinâmico)
  • Número constante de views por elemento ForEach
  • .animation(_:value:) sempre inclui o parâmetro value
  • APIs do iOS 26+ protegidas com #available e fallback fornecido
  • import Charts presente em arquivos que usam tipos de gráfico

Referências

  • references/latest-apis.md — Leia primeiro para cada tarefa. Transições de API obsoleta para moderna (iOS 15+ a iOS 26+)
  • references/state-management.md — Property wrappers, fluxo de dados, migração para @Observable
  • references/view-structure.md — Extração de views, padrões de container, @ViewBuilder
  • references/performance-patterns.md — Otimização de caminhos críticos, controle de atualizações, _logChanges()
  • references/list-patterns.md — Identidade em ForEach, Table (iOS 16+), armadilhas de filtragem inline
  • references/layout-best-practices.md — Padrões de layout, alternativas ao GeometryReader
  • references/accessibility-patterns.md — VoiceOver, Dynamic Type, agrupamento, traits
  • references/animation-basics.md — Animações implícitas/explícitas, temporização, desempenho
  • references/animation-transitions.md — Transições de view, matchedGeometryEffect, Animatable
  • references/animation-advanced.md — Animações de fase/keyframe (iOS 17+), macro @Animatable (iOS 26+)
  • references/charts.md — Marcas Swift Charts, eixos, seleção, estilização, Chart3D (iOS 26+)
  • references/charts-accessibility.md — VoiceOver em gráficos, Audio Graph, estratégias de fallback
  • references/sheet-navigation-patterns.md — Sheets, NavigationSplitView, Inspector
  • references/scroll-patterns.md — ScrollViewReader, rolagem programática
  • references/image-optimization.md — AsyncImage, downsampling, cache
  • references/liquid-glass.md — Efeitos Liquid Glass do iOS 26+ e padrões de fallback
  • references/macos-scenes.md — Settings, MenuBarExtra, WindowGroup, múltiplas janelas
  • references/macos-window-styling.md — Estilos de toolbar, redimensionamento de janelas, Commands
  • references/macos-views.md — HSplitView, Table, PasteButton, interoperabilidade com AppKit

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Habilidades Relacionadas