Communitygithub.com

sandbox-safemode/365-castle-logos

Crea sitios web distintivos y de grado de producción que eviten la estética genérica de "AI slop". Cada elección — tipografía, color, movimiento, diseño — debe ser intencional. Despliega como paquetes estáticos HTML/CSS/JS a S3.

¿Qué es 365-castle-logos?

Este skill es una guía completa para construir sitios web profesionales y estéticamente cuidados, priorizando un diseño intencional por encima de la apariencia genérica generada por IA. Cubre desde sitios informativos hasta aplicaciones web y juegos de navegador, proporcionando principios de diseño universales (como el sistema Nexus de tokens de diseño y tipografía) y guías específicas para cada tipo de proyecto. Se integra con plataformas como Claude Code y Cursor, y ofrece un flujo de trabajo estructurado que incluye dirección de arte, generación de assets (logotipos SVG, imágenes), pruebas visuales con Playwright y despliegue a S3 mediante `deploy_website()`. El skill promueve el uso de referencias de investigación, la generación generosa de assets reales (nunca placeholders) y un proceso riguroso de QA visual para asegurar resultados pulidos y profesionales.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/sandbox-safemode/365-castle-logos/tree/HEAD/skills/website-building

Preguntar en tu IA favorita

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

Documentación

Construcción de Sitios Web

Crea sitios web distintivos y de grado de producción que eviten la estética genérica de "AI slop". Cada elección — tipografía, color, movimiento, diseño — debe ser intencional. Despliega como paquetes estáticos HTML/CSS/JS a S3.

Este skill cubre todo para proyectos web. Cuando se carga mediante load_skill("website-building"), todos los archivos se copian a workspace/. Lee los subarchivos según sea necesario según el tipo de proyecto. Para aplicaciones web, carga el skill hijo: load_skill("website-building/webapp").

Los principios de diseño universales (filosofía del color, paleta predeterminada, selección de tipografía) se comparten con otros skills a través de design-foundations. Los archivos compartidos de este skill extienden esas bases con implementación específica para web (variables CSS, tokens responsivos, hojas de estilo base). No necesitas cargar design-foundations por separado — las versiones específicas para web en shared/ son completas.

Usa read con la ruta completa, p. ej. shared/01-design-tokens.md


Enrutamiento por Tipo de Proyecto

Paso 1: Identifica el tipo de proyecto y carga la guía específica del dominio:

Tipo de ProyectoAcciónEjemplos
Sitios informativosread informational/informational.mdSitios personales, portafolios, editorial/blogs, pequeñas empresas, landing pages
Aplicaciones webload_skill("website-building/webapp")Productos SaaS, dashboards, paneles de administración, e-commerce, experiencias de marca
Juegos de navegadorread game/game.md + game/game-testing.mdJuegos 2D Canvas, Three.js/WebGL, juegos HTML5, experiencias 3D interactivas

Paso 2: Lee los archivos compartidos — lee shared/01-design-tokens.md y shared/02-typography.md primero (obligatorio para TODOS los tipos de proyecto, incluyendo webapp). Estos establecen los valores predeterminados del sistema de diseño Nexus y las reglas de tipografía que se aplican universalmente. Para aplicaciones web y dashboards, omite los archivos marcados con † a continuación — esos contienen detalles de implementación preconfigurados en la plantilla fullstack.

Si el usuario dice solo "sitio web" o "web" sin detalles, pregunta qué tipo o usa el informativo por defecto.


Referencia de Subarchivos

Compartidos (shared/) — Cada proyecto

ArchivoCubreCarga
shared/01-design-tokens.mdEscala tipográfica, espaciado, paleta Nexus, base.cssSiempre
shared/02-typography.mdSelección de tipografía, emparejamiento, carga, lista negraSiempre
shared/04-layout.mdComposición espacial, responsive, mobile-firstSiempre †
shared/05-taste.mdSkeleton loaders, estados vacíos/error, pulidoSiempre
shared/08-standards.mdAccesibilidad, rendimiento, antipatronesSiempre
shared/09-technical.mdEstructura del proyecto, sandbox, despliegue, lista de verificaciónSiempre †
shared/03-motion.mdAnimaciones de scroll, librería Motion, plugins SVG de GSAP, hover/cursorCuando tenga animaciones
shared/06-css-and-tailwind.mdTailwind CSS v3, shadcn/ui, CSS modernoCuando use Tailwind
shared/07-toolkit.mdLibrerías CDN, React, Three.js, iconos, mapas, patrones/filtros SVG, esm.shAl elegir librerías
shared/10-charts-and-dataviz.mdChart.js, Recharts, D3, KPIs, sparklinesCuando se necesite visualización de datos
shared/11-web-technologies.mdVersiones de frameworks, compatibilidad con navegadoresAl verificar compatibilidad
shared/12-playwright-interactive.mdQA persistente con navegador Playwright, capturas de pantalla, pruebas visualesAl hacer pruebas
shared/19-backend.mdServidores FastAPI/Express/Flask, WebSocket, SSE, reenvío de puertosCuando se necesite backend
shared/20-llm-api.mdChat LLM, generación de imagen/video/audio, transcripción — modelos, credenciales, helpers SDKCuando el sitio use APIs de IA/LLM

Todas las rutas son relativas a ``.

† Omitir para webapp y dashboards — detalles de implementación preconfigurados en la plantilla fullstack. Design-tokens y typography NO se omiten — proporcionan los valores predeterminados autoritativos del sistema de diseño y la guía de selección de tipografía para todos los tipos de proyecto.

Específicos del Dominio — Carga uno

ArchivoCuándo cargar
load_skill("website-building/webapp")SaaS, dashboard, administración, e-commerce, experiencia de marca (skill hijo con plantilla fullstack)
skills/website-building/webapp/dashboards.mdDashboard o interfaz densa en datos (compañero de webapp)
informational/informational.mdSitio personal, portafolio, editorial, pequeña empresa, landing
game/game.mdJuego de navegador, Three.js, WebGL, 3D interactivo
game/2d-canvas.mdJuego 2D Canvas (compañero de game.md)
game/game-testing.mdCualquier juego de navegador — cárgalo junto con game.md

QA interactivo: Lee shared/12-playwright-interactive.md para automatización persistente del navegador con Playwright (capturas de pantalla, pruebas funcionales, QA visual). Requerido para pruebas de juegos, útil para cualquier sitio complejo.


Flujo de Trabajo

  1. Dirección de Diseño: Aclara el propósito, elige una dirección estética
  2. Control de Versiones: Ejecuta git init en el directorio del proyecto después del scaffolding. Haz commit después de cada hito importante con un mensaje corto.
  3. Construye: Construye el sitio página por página, tomando capturas de pantalla mediante Playwright para QA visual
  4. Publica: Haz commit de todos los cambios, luego deploy_website() devuelve la URL pública

Usa Cada Herramienta

  • Investiga primero. Busca en la web sitios de referencia, tendencias y ejemplos de la competencia antes de diseñar. Navega por ejemplos galardonados del tipo de sitio específico. Obtén cualquier URL que proporcione el usuario.
  • Genera assets reales — generosamente. Genera imágenes para héroes, ilustraciones de secciones, imágenes visuales de características editoriales, fondos atmosféricos — no solo una imagen de héroe. Cada página larga debe tener un ritmo visual con imágenes generadas que coincidan con la dirección artística del sitio. Sin placeholders. Genera un logotipo SVG personalizado para cada proyecto (ver más abajo) — SVG es solo para logotipos a menos que el usuario solicite explícitamente salida SVG. Guarda imágenes de referencia web que informen la dirección.
  • Captura de pantalla mediante Playwright (solo sitios complejos). Para sitios de varias páginas, aplicaciones web, dashboards y juegos, lee skills/website-building/shared/12-playwright-interactive.md para capturar pantalla en escritorio (1280px+) y móvil (375px). Omite Playwright para sitios estáticos de una sola página simples — ver QA visual a continuación.
  • Escribe código de producción directamente. HTML, CSS, JS, SVG. Usa bash para herramientas de construcción y procesamiento de archivos.

Generación de Logotipo SVG

Cada proyecto recibe un logotipo SVG personalizado en línea. Nunca sustituyas un encabezado de texto estilizado.

  1. Comprende la marca — propósito, tono, una palabra definitoria
  2. Escribe SVG directamente — formas geométricas, letras o marcas abstractas. Una forma memorable.
  3. Principios: Geométrico/mínimo (Paul Rand, Vignelli). Funciona a 24px y 200px. Monocromo primero — agrega color como mejora. Usa currentColor para modo oscuro/claro.
  4. Implementa en línea con aria-label, viewBox, fill="none", trazos currentColor
  5. Genera un favicon — versión simplificada de 32x32 si es necesario

Para animación SVG (DrawSVG, MorphSVG), consulta shared/03-motion.md. Para patrones/filtros SVG, consulta shared/07-toolkit.md.


Proceso de Pruebas QA Visual

Cuándo usar Playwright QA

Omite Playwright para sitios simples. Los sitios estáticos de una sola página NO necesitan capturas de pantalla con Playwright. Revisa el código directamente, luego despliega. Playwright QA agrega tiempo significativo y no vale la pena para contenido estático simple.

Usa Playwright para sitios complejos. Sitios de varias páginas, aplicaciones web, dashboards, juegos y cualquier sitio con características interactivas (formularios, carritos, filtros, gráficos, arrastrar y soltar) DEBE usar Playwright QA. Lee skills/website-building/shared/12-playwright-interactive.md para automatización persistente del navegador.

Proceso de Playwright QA (solo sitios complejos)

Ciclo: Construir → Playwright QA → Evaluar → Arreglar → Repetir → Desplegar cuando esté listo

Etapa 1: QA Página por Página

Después de construir cada página:

  1. Captura de pantalla en escritorio (1280px+) y móvil (375px) mediante Playwright
  2. Evalúa críticamente: ¿Se ve profesionalmente diseñado (no generado por IA)? ¿Es la tipografía distintiva? ¿El espacio en blanco es generoso? ¿Hay una jerarquía visual clara?
  3. Arregla cada problema antes de continuar. Sin deuda visual.

Etapa 2: QA Final (antes de publicar)

  1. Captura de pantalla de cada página en escritorio y móvil
  2. Verifica consistencia entre páginas (espaciado, color, tratamiento de tipografía)
  3. Verifica el modo oscuro (captura de pantalla de ambos temas para la página de inicio como mínimo)
  4. Verifica estados interactivos: hover, focus, active, loading, empty, error
  5. Prueba de primera impresión en frío: ¿se siente pulido e intencional?

Fallos de QA: desbordamiento de texto, espaciado inconsistente, colores fuera de los tokens, modo oscuro faltante, móvil aplastado, apariencia genérica de IA, contenido placeholder, logotipo faltante.


Paso 1: Dirección de Arte — Infiere Antes de Preguntar, Pregunta Antes de Usar el Valor por Defecto

Cada sitio debe tener una identidad visual derivada de su contenido. No saltes a la paleta de respaldo Nexus. La paleta Nexus es un último recurso para cuando tanto la inferencia como la pregunta han fallado — no un valor por defecto conveniente.

  1. Infiera del tema. Un sitio de tostador de café → marrones terrosos, crema cálida, sensación dibujada a mano. Un dashboard fintech → pizarra fría, sans-serif afilada, denso en datos. Una aplicación de aprendizaje infantil → primarios brillantes, tipografía redondeada, movimiento lúdico. El contenido mismo te dice la paleta, la tipografía y el espaciado antes de que el usuario diga una palabra.
  2. Consulta las tablas de Dirección de Arte. Cada archivo de dominio (informational.md, webapp/SKILL.md, game/game.md) tiene una tabla de Dirección de Arte que mapea tipos de sitio/producto a direcciones basadas en concepto y puntos de partida de tokens. Úsalas como trampolín.
  3. Deriva los cinco pilares: Color (cálido/frío, acento del tema), Tipografía (serif/sans, personalidad de display), Espaciado (denso/generoso), Movimiento (mínimo/expresivo), Imaginería (foto/ilustración/solo tipografía).
  4. Si el tema es genuinamente ambiguo, pregunta — "¿Qué ambiente buscas?" y "¿Algún sitio de referencia?" Una pregunta es suficiente.
  5. Respaldo Nexus — solo cuando la inferencia Y la pregunta no produzcan nada. Si se le preguntó al usuario y no dio dirección, Y el tema no da una señal clara, entonces recurre a los valores por defecto Nexus/Suizos.

El Respaldo: Limpio y Suizo (Último Recurso)

Cuando la inferencia no dio una dirección clara Y se le preguntó al usuario pero no dio guía de estilo, usa los valores por defecto de shared/01-design-tokens.md con:

  • Tipografía: Satoshi o General Sans para cuerpo (Fontshare — preferido), o Inter/DM Sans. Contraste de peso sobre contraste de fuente. Máximo 3-4 tamaños. Mantén el texto compacto — --text-3xl/--text-hero son solo para héroes de sitios informativos.
  • Color: Paleta Nexus. Superficies neutras + un acento verde azulado solo para CTAs.
  • Diseño: Alineado a cuadrícula. Márgenes generosos. Asimétrico donde sea interesante.
  • Movimiento: Mínimo, funcional. Solo transiciones de estado suaves.
  • Imaginería: Genera imágenes limpias y relevantes. Sin fotos de stock.

Dirección de Arte — Evita la Estética de IA

Consulta shared/08-standards.md para la lista completa de antipatrones.


Paso 2: Publica

Llama a deploy_website() con la ruta del proyecto y el nombre del sitio. Devuelve una URL pública de S3. Para actualizar, edita los archivos locales y vuelve a desplegar con la misma ruta. Consulta shared/09-technical.md para la llamada exacta y ejemplos.

Skills relacionados