Communitygithub.com

ulasalyesil/personal-website-v2

Guía de mejores prácticas y ejemplos para construir vistas y componentes SwiftUI. Úsalo al crear o refactorizar UI SwiftUI, diseñar arquitectura de pestañas con TabView, componer pantallas o buscar patrones y ejemplos específicos de componentes.

¿Qué es personal-website-v2?

Este skill proporciona una guía práctica y basada en ejemplos para el desarrollo de interfaces de usuario con SwiftUI. Está diseñado para ayudar a desarrolladores a crear vistas y componentes siguiendo las mejores prácticas de la plataforma, como el uso de `@State`, `@Binding`, `@Observable` y `@Environment`, la composición de vistas pequeñas y enfocadas, y la gestión del flujo de datos con async/await. Es útil tanto para proyectos existentes como para nuevos proyectos, ofreciendo referencias detalladas sobre componentes específicos y patrones como TabView, NavigationStack y hojas modales (sheets). El skill fomenta el uso de `.sheet(item:)` sobre `.sheet(isPresented:)` y recomienda que las hojas manejen sus propias acciones y llamen a `dismiss()` internamente. Incluye un flujo de trabajo paso a paso para crear nuevas vistas SwiftUI, desde la definición del estado hasta la validación final, y guía en la creación de nuevas referencias de componentes dentro del repositorio.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agent/skills/swiftui-ui-patterns

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Patrones de UI SwiftUI

Inicio rápido

Elige un camino según tu objetivo:

Proyecto existente

  • Identifica la funcionalidad o pantalla y el modelo de interacción principal (lista, detalle, editor, configuración, con pestañas).
  • Busca un ejemplo cercano en el repositorio con rg "TabView\(" o similar, luego lee la vista SwiftUI más cercana.
  • Aplica las convenciones locales: prefiere estado nativo de SwiftUI, mantén el estado local cuando sea posible y utiliza inyección de entorno para dependencias compartidas.
  • Elige la referencia de componente relevante de references/components-index.md y sigue su guía.
  • Construye la vista con subvistas pequeñas y enfocadas y flujo de datos nativo de SwiftUI.

Andamiaje de nuevo proyecto

  • Comienza con references/app-scaffolding-wiring.md para cablear TabView + NavigationStack + hojas.
  • Agrega un AppTab y RouterPath mínimos basados en los esqueletos proporcionados.
  • Elige la siguiente referencia de componente según la UI que necesites primero (TabView, NavigationStack, hojas).
  • Expande los enums de ruta y hoja a medida que se agreguen nuevas pantallas.

Reglas generales a seguir

  • Usa estado moderno de SwiftUI (@State, @Binding, @Observable, @Environment) y evita modelos de vista innecesarios.
  • Prefiere la composición; mantén las vistas pequeñas y enfocadas.
  • Usa async/await con .task y estados explícitos de carga/error.
  • Mantén los patrones heredados existentes solo cuando edites archivos heredados.
  • Sigue el formateador y la guía de estilo del proyecto.
  • Hojas: Prefiere .sheet(item:) sobre .sheet(isPresented:) cuando el estado represente un modelo seleccionado. Evita if let dentro del cuerpo de una hoja. Las hojas deben ser dueñas de sus acciones y llamar a dismiss() internamente en lugar de reenviar closures onCancel/onConfirm.

Flujo de trabajo para una nueva vista SwiftUI

  1. Define el estado de la vista y su ubicación de propiedad.
  2. Identifica las dependencias a inyectar mediante @Environment.
  3. Esboza la jerarquía de la vista y extrae las partes repetidas en subvistas.
  4. Implementa la carga asíncrona con .task y un enum de estado explícito si es necesario.
  5. Agrega etiquetas o identificadores de accesibilidad cuando la UI sea interactiva.
  6. Valida con una compilación y actualiza los puntos de uso si es necesario.

Referencias de componentes

Usa references/components-index.md como punto de entrada. Cada referencia de componente debe incluir:

  • Intención y escenarios de mejor ajuste.
  • Patrón de uso mínimo con convenciones locales.
  • Errores comunes y notas de rendimiento.
  • Rutas a ejemplos existentes en el repositorio actual.

Patrones de hojas

Hoja basada en ítem (preferida)

@State private var selectedItem: Item?

.sheet(item: $selectedItem) { item in
    EditItemSheet(item: item)
}

La hoja es dueña de sus acciones

struct EditItemSheet: View {
    @Environment(\.dismiss) private var dismiss
    @Environment(Store.self) private var store

    let item: Item
    @State private var isSaving = false

    var body: some View {
        VStack {
            Button(isSaving ? "Guardando…" : "Guardar") {
                Task { await save() }
            }
        }
    }

    private func save() async {
        isSaving = true
        await store.save(item)
        dismiss()
    }
}

Agregar una nueva referencia de componente

  • Crea references/<componente>.md.
  • Mantenlo corto y accionable; enlaza a archivos concretos en el repositorio actual.
  • Actualiza references/components-index.md con la nueva entrada.

Individual skills in this repo

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

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

Skills relacionados