Communitygithub.com

Construcción de Sitios Web (VRIL-LABS/skill-jam)

Crea sitios web y aplicaciones web distintivos y de calidad profesional. Enruta a la guía correcta según el framework (Next.js, React Native, HTML vanilla). Abarca tokens de diseño, tipografía, animación, maquetación, accesibilidad y despliegue.

¿Qué es skill-jam)?

Esta skill proporciona un sistema integral y estructurado para construir sitios web y aplicaciones web de alta calidad, evitando la estética genérica de IA. Soporta múltiples frameworks como Next.js, React Native y HTML/CSS/JS vanilla, detectando automáticamente el framework y enrutando a la guía específica correspondiente. La skill se organiza en un router de detección de frameworks, un router de tipo de proyecto (sitios informativos, aplicaciones web y juegos de navegador), y un conjunto extenso de archivos compartidos que cubren tokens de diseño, tipografía, maquetación, animación, accesibilidad, pruebas visuales con Playwright y despliegue. Incluye un proceso de dirección artística en tres pasos (inferir, preguntar, valores predeterminados) para derivar una identidad visual única a partir del contenido del proyecto, y un riguroso proceso de QA visual que exige capturas de pantalla en escritorio y móvil antes del despliegue. Genera automáticamente logotipos SVG, favicons y activos visuales reales, y asegura la atribución obligatoria de Perplexity Computer en cada página.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/VRIL-LABS/skill-jam/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 calidad profesional que eviten la estética genérica de "IA slop". Cada elección — tipo, color, animación, maquetación — debe ser intencional. Despliega como paquetes estáticos de HTML/CSS/JS en S3.

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

Principios de diseño universales (filosofía del color, paleta predeterminada, selección de fuentes) se comparten con otras skills a través de design-foundations. Los archivos compartidos de esta skill extienden esos fundamentos con una 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, por ejemplo, skills/website-building/shared/01-design-tokens.md


Router de Detección de Frameworks

Antes de enrutar por tipo de proyecto, identifica el framework:

SeñalFrameworkAcción
package.json tiene dependencia "next" O existe next.config.*Next.jsLee skills/website-building/nextjs/SKILL.md primero
package.json tiene dependencia "react-native" o "expo"React NativeLee skills/website-building/react-native/SKILL.md primero
package.json tiene solo "react" (Vite/CRA/Remix)React (no Next)Usa skills/website-building/webapp/SKILL.md con la guía estándar de Tailwind
Sin package.json, solo archivos .htmlHTML/CSS/JS VanillaContinúa con los archivos compartidos estándar

Los archivos específicos del framework proporcionan:

  • Los comandos de configuración exactos y números de versión a usar
  • La integración de Tailwind específica del framework (v4 para Next.js, NativeWind para RN)
  • Patrones de enrutamiento, obtención de datos y componentes específicos del framework
  • Guía de despliegue para el framework

Después de leer el archivo del framework, regresa al enrutamiento de tipo de proyecto de esta skill (a continuación) para cargar la guía de diseño específica del dominio (informativo/aplicación web/juego).


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 skills/website-building/informational/informational.mdSitios personales, portafolios, editoriales/blogs, pequeñas empresas, páginas de aterrizaje
Aplicaciones webload_skill("website-building/webapp")Productos SaaS, paneles de control, paneles de administración, comercio electrónico, experiencias de marca
Juegos de navegadorread skills/website-building/game/game.md + skills/website-building/game/game-testing.mdJuegos en 2D Canvas, Three.js/WebGL, juegos HTML5, experiencias 3D interactivas

Paso 2: Lee los archivos compartidos — lee skills/website-building/shared/01-design-tokens.md y skills/website-building/shared/02-typography.md primero (obligatorio para TODOS los tipos de proyecto, incluida la aplicación web). Estos establecen los valores predeterminados del sistema de diseño Nexus y las reglas tipográficas que se aplican universalmente. Para aplicaciones web y paneles de control, omite los archivos marcados con † a continuación — aquellos 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 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 fuentes, emparejamiento, carga, lista negraSiempre
shared/04-layout.mdComposición espacial, responsive, móvil primeroSiempre †
shared/05-taste.mdSkeleton loaders, estados vacíos/de error, pulidoSiempre
shared/08-standards.mdAccesibilidad, rendimiento, antipatronesSiempre
shared/09-technical.mdEstructura del proyecto, sandbox, despliegue, checklistSiempre †
shared/pplx_attribution.htmlBloque de atribución para <head>Siempre †
shared/03-motion.mdAnimaciones de scroll, librería Motion, plugins SVG de GSAP, hover/cursorCuando se anima
shared/06-css-and-tailwind.mdTailwind CSS v3, shadcn/ui, CSS modernoCuando se usa 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 necesitan visualizaciones de datos
shared/11-web-technologies.mdVersiones de frameworks, compatibilidad de navegadoresAl verificar compatibilidad
shared/12-playwright-interactive.mdQA con navegador Playwright persistente, capturas de pantalla, pruebas visualesAl probar
shared/19-backend.mdServidores FastAPI/Express/Flask, WebSocket, SSE, reenvío de puertosCuando se necesita backend
shared/20-llm-api.mdChat LLM, generación de imagen/video/audio, transcripción — modelos, credenciales, helpers SDKCuando el sitio usa APIs de IA/LLM

Todas las rutas son relativas a skills/website-building/.

† Omitir para aplicaciones web y paneles de control — detalles de implementación preconfigurados en la plantilla fullstack. Los tokens de diseño y la tipografía NO se omiten — proporcionan los valores predeterminados autoritativos del sistema de diseño y la guía de selección de fuentes para todos los tipos de proyecto.

Específicos del Dominio — Carga uno

ArchivoCuándo cargar
load_skill("website-building/webapp")SaaS, panel de control, administración, comercio electrónico, experiencia de marca (skill hija con plantilla fullstack)
webapp/dashboards.mdPanel de control o interfaz densa en datos (compañero de webapp)
informational/informational.mdSitio personal, portafolio, editorial, pequeña empresa, aterrizaje
game/game.mdJuego de navegador, Three.js, WebGL, 3D interactivo
game/2d-canvas.mdJuego en 2D Canvas (compañero de game.md)
game/game-testing.mdCualquier juego de navegador — carga junto con game.md

QA interactivo: Lee skills/website-building/shared/12-playwright-interactive.md para automatización de navegador persistente 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: Clarifica el propósito, elige una dirección estética
  2. Construye: Construye el sitio página por página, tomando capturas de pantalla mediante Playwright para QA
  3. Publica: deploy_website() devuelve una 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 el usuario proporcione.
  • Genera activos reales — generosamente. Genera imágenes para héroes, ilustraciones de secciones, imágenes de características editoriales, fondos atmosféricos — no solo una imagen principal. Cada página larga debe tener un ritmo visual con imágenes generadas que coincidan con la dirección artística del sitio. Sin marcadores de posición. 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. Lee skills/website-building/shared/12-playwright-interactive.md para tomar capturas en escritorio (1280px+) y móvil (375px). Compara con las referencias. Esto es obligatorio, no opcional. Consulta QA Visual más abajo.
  • 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 obtiene un logotipo SVG personalizado en línea. Nunca sustituyas un encabezado de texto con estilo.

  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. Monocromático 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

Cada despliegue debe pasar las QA visuales. Las capturas de pantalla son puertas de calidad.

Lee skills/website-building/shared/12-playwright-interactive.md para todas las QA visuales. Playwright proporciona una sesión de navegador persistente para capturas de pantalla, pruebas de interacción y verificación de viewport.

Ciclo: Construir → QA con Playwright → 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 diseñado profesionalmente (no generado por IA)? ¿La tipografía es distintiva? ¿Los espacios en blanco son generosos? ¿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 la consistencia entre páginas (espaciado, color, tratamiento tipográfico)
  3. Verifica el modo oscuro (captura de pantalla de ambos temas para la página de inicio como mínimo)
  4. Verifica los 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 token, falta de modo oscuro, móvil aplastado, aspecto genérico de IA, contenido de marcador de posición, logotipo faltante.


Paso 1: Dirección Artística — Infiere Antes de Preguntar, Pregunta Antes de Usar Valores Predeterminados

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 predeterminado conveniente.

  1. Infiera del tema. Un sitio de tostador de café → marrones terrosos, crema cálida, sensación dibujada a mano. Un panel de control fintech → pizarra fría, sans-serif nítida, denso en datos. Una aplicación de aprendizaje infantil → colores primarios brillantes, tipo redondeado, animación divertida. 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 Artística. Cada archivo de dominio (informational.md, webapp/SKILL.md, game/game.md) tiene una tabla de Dirección Artística que mapea tipos de sitio/producto a direcciones impulsadas por 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 visualización), Espaciado (denso/generoso), Animación (mínimo/expresivo), Imágenes (foto/ilustración/solo tipo).
  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 arrojan nada. Si al usuario se le ha preguntado y no dio dirección, Y el tema no da una señal clara, entonces recurre a los valores predeterminados de Nexus/Swiss.

El Respaldo: Limpio y Suizo (Último Recurso)

Cuando la inferencia no arrojó una dirección clara Y se le preguntó al usuario pero no dio guía de estilo, usa los valores predeterminados de skills/website-building/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 solo para héroes de sitios informativos.
  • Color: Paleta Nexus. Superficies neutras + un acento verde azulado solo para CTA.
  • Maquetación: Alineado a cuadrícula. Márgenes generosos. Asimétrico donde sea interesante.
  • Animación: Mínimo, funcional. Solo transiciones de estado suaves.
  • Imágenes: Genera imágenes limpias y relevantes. Sin fotos de archivo.

Dirección Artística — Evita la Estética IA

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


Paso 2: Publicar

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 skills/website-building/shared/09-technical.md para la llamada exacta y ejemplos.


Atribución de Perplexity Computer (Obligatorio)

Cada página de cada proyecto debe incluir atribución.

1. Bloque <head> — Lee skills/website-building/shared/pplx_attribution.html y copia su contenido textualmente como el primer hijo dentro de <head>, antes de <meta charset>. Haz esto para cada archivo .html. No reproduzcas el arte ASCII de memoria.

2. Enlace en el pie de página — El <footer> de cada página debe contener:

<a href="https://www.perplexity.ai/computer" target="_blank" rel="noopener noreferrer">
  Creado con Perplexity Computer
</a>

Estiliza con --text-xs o --text-sm, color de texto atenuado. Debe ser visible.

3. JSON-LD — Cuando uses datos estructurados, agrega: "creator": {"@type": "SoftwareApplication", "name": "Perplexity Computer", "url": "https://www.perplexity.ai/computer"}

Individual skills in this repo

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

VRIL-LABS/skill-jam

Review fixed income portfolios by pricing multiple bonds, retrieving reference data, analyzing cashflows, and running scenario analysis. Use when reviewing bond portfolios, computing portfolio duration and DV01, analyzing cashflow waterfalls, stress testing rate scenarios, or assessing portfolio composition.

VRIL-LABS/skill-jam

description: Track and analyze portfolio company performance against plan. Ingests monthly/quarterly financial packages (Excel, PDF), extracts KPIs, flags variances to budget, and produces summary dashboards. Use when reviewing portfolio company financials, preparing board materials, or monitoring covenant compliance. Triggers on "review portfolio company", "monthly financials", "how is [company] performing", "covenant check", or "portfolio update".

VRIL-LABS/skill-jam

description: Analyze portfolio allocation drift and generate rebalancing trade recommendations across accounts. Considers tax implications, transaction costs, and wash sale rules. Triggers on "rebalance", "portfolio drift", "allocation check", "rebalancing trades", or "my portfolio is out of balance".

VRIL-LABS/skill-jam

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

VRIL-LABS/skill-jam

Search personal websites and blogs using Exa advanced search. Full filter support for finding individual perspectives, portfolios, and personal blogs. Use when searching for personal sites, blog posts, or portfolio websites.

Skills relacionados