Investigación de sitios web
La receta para llenar el vacío de "sin referencias" antes de una lluvia de ideas. Obtiene 5 referencias de la prensa de diseño para el sector vertical, analiza cada una a través de los mismos cuatro lentes que /analyze, identifica patrones transversales, establece un puente con la biblioteca de presets, y guarda toda la sesión como una nota de markdown que los proyectos futuros pueden aprovechar.
La justificación del diseño se encuentra en docs/plans/2026-04-29-website-research-design.md; esta skill es la receta operativa.
Cuándo usarla
- Integrada en el paso 1 de
/new-mockupcuando el usuario no tiene puntos de referencia (o pide ayuda para encontrarlos). - De forma independiente mediante
/research <entrada de texto libre>para sesiones de inspiración ad-hoc. - Cuando el usuario pregunta "¿qué está funcionando en [sector vertical]?" o "dame ejemplos de buenos sitios [tipo]" — incluso si no dice
/research, la skill aplica.
No usar para: clonar un sitio específico (extraemos patrones, no activos), investigar éxito comercial (señal incorrecta; consulta docs/plans/2026-04-29-website-research-design.md para entender por qué), o analizar una sola referencia que el usuario ya proporcionó (usa /analyze para eso).
Requisitos previos
Antes de ejecutar, verifica tres cosas:
docs/research/existe. Debería — la Tarea 1 de este plan lo crea. Si el directorio falta, créalo sobre la marcha conmkdir -p docs/research/y continúa. (No te detengas — la recuperación automática está bien aquí).- La entrada tiene suficiente señal. Una sola palabra genérica como "SaaS" o "e-commerce" es demasiado amplia; consulta el Caso límite n.º 1 a continuación; pide que la acoten antes de ejecutar.
- Acceso a herramientas.
WebSearchyWebFetchdeben estar disponibles. Si están deshabilitadas, detente con: "Las herramientas web están deshabilitadas./researchnecesita tanto WebSearch como WebFetch para descubrir y verificar candidatos. Actívalas o recurre a la recopilación manual de referencias."
El flujo de cinco pasos
1. Analizar la entrada
La entrada es de texto libre. Léela y extrae:
- Sector vertical — qué tipo de negocio o producto (bufete de abogados / impresor / página de aterrizaje SaaS / merchandising / portafolio de agencia / publicación editorial / etc.).
- Restricciones — adjetivos que acotan el conjunto de candidatos (moderno / tradicional / oscuro / claro / premium / divertido / minimalista / denso / etc.).
- Exclusiones estrictas — cualquier cosa que el usuario explícitamente no quiera (p. ej., "pero no corporativo", "sin plantillas de e-commerce").
Si la extracción es ambigua (p. ej., la entrada es genuinamente solo "SaaS"), aplica el Caso límite n.º 1 y haz una pregunta de aclaración antes de ejecutar.
Búsqueda de investigaciones previas: antes del descubrimiento, lista docs/research/*.md y verifica los nombres de archivo + temas de la primera línea en busca de coincidencias con el sector vertical analizado. Si una nota reciente cubre el mismo sector vertical (generalmente < 3 meses para categorías que cambian rápido como páginas de aterrizaje SaaS o herramientas de IA, < 6 meses para las más lentas como bufetes de abogados — fíjate en si el canon de la prensa de diseño para el sector vertical ha cambiado visiblemente, no en el calendario), menciónala: "Se encontró <nombre-de-archivo> de sobre el mismo sector vertical. ¿Reutilizar, ejecutar de nuevo o aumentar con nuevas selecciones?" Reutilizar omite el descubrimiento; ejecutar de nuevo empieza desde cero; aumentar usa los candidatos de la nota anterior como semilla y encuentra sitios adicionales.
2. Descubrimiento (híbrido)
Dos pasadas alimentan una lista unificada de candidatos.
Pasada A — Conocimiento general del LLM. Propón de 5 a 10 sitios de tus datos de entrenamiento. Filtra con esta estructura de prompt:
"Lista sitios en [sector vertical] que sean ampliamente reconocidos como ejemplos de la prensa de diseño (Awwwards, FWA, Land-book, Site Inspire, Brutalist Websites) o referenciados por profesionales. Filtra por [restricciones]. Salida como
nombre | url | una línea del por qué es reconocido."
Criterios para "hacerlo realmente bien":
- Principal: reconocimiento de la prensa de diseño (premios, colocaciones destacadas) + oficio estético (se ve excelente, tipografía cuidada, diseño original, movimiento preciso).
- Secundario: reputación profesional (referenciado en el discurso del diseño).
- Omitido: indicadores de éxito comercial (las marcas bien financiadas pueden tener sitios mediocres — señal incorrecta).
Umbral de reconocimiento de la prensa de diseño. Un solo Awwwards SOTD por sí solo no es suficiente: demasiados sitios lo obtienen. Exige al menos uno de: (a) SOTM/SOTY en Awwwards/FWA/CSS Design Awards, (b) selección del editor en Land-book / Site Inspire / Brutalist Websites / Page Collective, O (c) referencia profesional en el discurso del diseño (citado en boletines de diseño como Sidebar.io, Hover States, Frontend Focus; o referenciado en estudios de caso de agencias / hilos de diseñadores en Twitter/Bluesky). La financiación y el éxito comercial no te dicen nada sobre la calidad del diseño, incluso cuando se correlacionan.
Pasada B — Complemento de WebSearch. Compón de 1 a 2 consultas basadas en la entrada, p. ej., "mejores sitios web de bufetes de abogados 2025 awwwards", "inspiración de sitios web de impresores premium". Evalúa los resultados: conserva las publicaciones de diseño (Awwwards, FWA, Site Inspire, Land-book, Brutalist Websites, Sidebar.io, Typewolf, Page Collective), las páginas de estudios de caso de agencias y las publicaciones de profesionales. Descarta las listas impulsadas por SEO ("los 10 mejores sitios web X en 2025"), las galerías de mercados de plantillas (páginas de exhibición de plantillas de Wix/Squarespace/Webflow, no sitios reales) y las granjas de contenido de resúmenes de IA.
(Si una fuente nombrada devuelve 404 o claramente ha cerrado, descártala silenciosamente y confía en las demás — no informes de fuentes muertas como parte del resultado del descubrimiento).
Obtén de 3 a 5 candidatos adicionales.
Deduplicar + verificar. Combina ambas listas. Elimina duplicados. Para cada candidato restante, ejecuta WebFetch (un solo GET, toque ligero) para confirmar que la URL está activa. Descarta las URL muertas. Limita la lista verificada a 5 sitios por defecto; el usuario puede anularlo mediante el prompt de la skill (--count 8 o lenguaje natural "encuéntrame 8 sitios").
3. Análisis por sitio
Para cada sitio verificado, ejecuta el flujo de trabajo existente de /analyze en línea (no invoques el comando de barra — aplica el patrón de cuatro lentes directamente):
- Tipografía: características de la familia, contraste de peso, proporción de escala, tracking.
- Color: modo, la lógica (no los hexes), dónde el acento se gana su lugar.
- Diseño: patrón del héroe, asimetría, densidad, ritmo vertical.
- Movimiento: personalidades de easing, dónde vive el movimiento, densidad.
De 3 a 4 viñetas por categoría, breves y concretas. Luego, un párrafo de "Por qué funciona" que sintetice las fortalezas del diseño.
Frases prohibidas en "Por qué funciona": "moderno y limpio", "tipografía audaz", "diseño elegante", "equilibrio perfecto", "visuales impresionantes" — no tienen contenido. El párrafo debe nombrar una compensación específica o una elección no obvia (p. ej., "La tipografía condensada hace el trabajo ruidoso para que el cuerpo pueda permanecer tranquilo, permitiendo usar un solo peso en el cuerpo sin perder jerarquía").
Recordatorio ético: patrones sí, activos no. La salida nunca propone copiar un sitio al pie de la letra — extraemos lenguaje de diseño, no diseños o imágenes específicos.
4. Agregar patrones transversales
Después de analizar todos los sitios, resume lo que es común en el conjunto:
- Tipografía: "4 de 5 usan un sistema de una sola familia, jerarquía liderada por el peso."
- Color: "Los 5 tienen modo oscuro por defecto; 3 usan monocromo con un acento."
- Diseño: "Los héroes asimétricos dominan; 4 de 5 evitan divisiones 6/6."
- Movimiento: "El easing de salida exponencial domina; 3 de 5 usan revelaciones impulsadas por el desplazamiento."
Puente con la biblioteca de presets: lee presets.ts, identifica los presets existentes más cercanos para cada categoría de preset presente en el archivo, y señala explícitamente las brechas — patrones que ningún preset actual cubre. Si presets.ts ha agregado una nueva categoría de preset desde que se escribió esta skill (p. ej., primitivas de interacción, presets de visualización de datos), inclúyela en el puente — no la omitas solo porque los cuatro lentes no la anticiparon. Es mejor señalar la brecha que forzar una mala adaptación.
Si los patrones son débiles ("3 de 5 usan sans-serif" — cierto para el 95% de la web, inútil), dilo explícitamente. No adornes hallazgos genéricos.
5. Guardar la nota de investigación
Escribe en docs/research/<slug>-<AAAA-MM-DD>.md donde slug es una palabra clave en kebab-case. Si la ruta ya existe (mismo sector vertical, mismo día), añade -v2, -v3, etc., hasta que la ruta esté libre. Usa esta estructura textualmente:
# Investigación: <tema / sector vertical>
**Fecha:** AAAA-MM-DD · **Brief:** <entrada textual del usuario>
## Candidatos analizados
1. <Nombre del sitio> — <url> · <una línea del por qué es reconocido>
2. ...
(+ lista de los candidatos descartados, con el motivo)
## Análisis por sitio
### 1. <Nombre del sitio>
[análisis de cuatro lentes: 3–4 viñetas por categoría]
**Por qué funciona:** <1–2 frases que sintetizan las fortalezas del diseño>
### 2. <Nombre del sitio>
...
## Patrones transversales
- **Tipografía:** ...
- **Color:** ...
- **Diseño:** ...
- **Movimiento:** ...
## Puente con la biblioteca de presets
- **Presets existentes más cercanos:** ...
- **Brechas:** ... (o "ninguna — los presets actuales cubren los patrones")
## Dirección de ADN recomendada
<2–3 frases sobre qué dirección de diseño tiene sentido dados los patrones y las brechas — formuladas como un punto de partida para una futura propuesta de ADN, no como una elección final. No reutilices la palabra "brief" aquí, ya que las ejecuciones independientes de /research pueden no tener uno.>
Después de escribir, publica un breve resumen en el chat (no la nota completa — eso está guardado). Si se invocó desde /new-mockup, pasa el testigo al paso de lluvia de ideas con los patrones + brechas como contexto. Si es independiente, termina aquí.
Casos límite
- Sector vertical demasiado amplio. Si la entrada consta de uno o dos sustantivos genéricos ("e-commerce", "SaaS"), detente antes del descubrimiento y pide que lo acoten: "E-commerce es amplio — ¿cuál es la posición de la marca (premium / divertida / utilitaria)? ¿Y la categoría de producto? Eso afinará la lista." Reanuda después de que el usuario responda.
- Todas las URL propuestas por el LLM están muertas. El corte de entrenamiento significa que ~10–20% de las URL propuestas por el LLM pueden haberse movido o estar muertas. Si la verificación reduce la lista a menos de 3 sitios, recurre a una pasada solo con WebSearch. Si aún así quedan menos de 3 sitios, admite la brecha: "No se pudieron encontrar de forma fiable 5 referencias de la prensa de diseño para este brief. Se obtuvieron candidatos analizados; ¿quieres continuar con estos, o tienes algún punto de partida tú mismo?"
- Sitios renderizados con JavaScript.
WebFetchdevuelve HTML sin renderizar; las SPA modernas pueden mostrar marcado vacío (etiquetas script + un<div id="root">vacío). Detecta (sin contenido significativo extraído), marca el sitio como "no se pudo analizar sin una vista renderizada — URL registrada para revisión manual", continúa con el resto. No intentes analizar el DOM vacío como si tuviera contenido. - Patrones demasiado genéricos. Cuando los patrones extraídos son débiles, dilo explícitamente en lugar de adornar los hallazgos: "Los patrones en estos 5 sitios son en su mayoría genéricos — el sector vertical puede ser demasiado amplio, o el canon de la prensa de diseño para este nicho es escaso. Se recomienda obtener referencias adicionales manualmente o afinar el brief."
- Modo de aumento. Si el usuario tiene de 1 a 2 referencias y quiere que la investigación encuentre más ("Tengo el sitio X, encuéntrame algunos más como este"), acepta las URL existentes como entrada semilla. Deduplica contra la lista de candidatos. Ejecuta el análisis sobre la unión. Las referencias existentes no se ignoran.
Fuera del alcance
Esta skill no maneja:
- Análisis multimodal basado en capturas de pantalla.
WebFetchfunciona solo con HTML; las SPA renderizadas con JS pueden necesitar una vista renderizada que esta skill no captura. - Investigación almacenada en caché entre sesiones. Cada ejecución de
/researches nueva. - Etiquetado automático / búsqueda en archivos. El nombre de archivo + grep es la historia de búsqueda.
- Recolección directa de galerías (Awwwards, Land-book). Sin API públicas; sensible a los Términos de servicio.
- Métricas de éxito comercial o datos de tráfico. Señal incorrecta — investigamos lenguaje de diseño, no estrategia empresarial.
Cómo se ve el éxito
Después de una sesión de /research, el usuario tiene una nota de markdown guardada con 5 sitios de referencia verificados y de calidad de prensa de diseño, analizados a través de los mismos lentes que todo lo demás en la herramienta, con patrones extraídos y brechas en la biblioteca de presets señaladas. Los proyectos futuros en el mismo sector vertical encontrarán la nota mediante la búsqueda de investigaciones previas, por lo que ningún esfuerzo de investigación se desperdicia.