Communitygithub.com

Liquid Researcher

Enruta tareas de artefactos HTML relacionadas con diseño a la habilidad de artefacto correcta, referencia, generación de sistemas de diseño o exportación.

¿Qué es Liquid Researcher?

Liquid Researcher es una habilidad de agente de IA diseñada para actuar como un enrutador inteligente para el trabajo de artefactos HTML relacionados con diseño. Su función principal es analizar las solicitudes del usuario para determinar si son de naturaleza de diseño o no, y luego enrutarlas a la habilidad de artefacto adecuada (como referencia de sistema de diseño, generación de sistema de diseño o exportación). Esto es particularmente útil en entornos de desarrollo de software donde los agentes de IA como Claude Code o Cursor manejan múltiples tareas de diseño y desarrollo, ya que evita que el agente principal se atasque con la lógica de enrutamiento y mantiene la separación de preocupaciones. La habilidad decide de manera inteligente cuándo usar una plantilla de diseño existente, cómo llenar los estilos (color, tipografía, diseño, iconos, espaciado) a partir de múltiples fuentes como la descripción del usuario, un sistema de diseño o una plantilla, y garantiza la calidad final mediante una compuerta de calidad. Soporta escenarios tanto de interfaz de usuario (restrained) como creativos (expressive), y para escenarios de UI, recurre a un sistema maduro predefinido para lograr profesionalismo y consistencia.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ARYAN2302/liquid_researcher/tree/HEAD/skills/design

Preguntar en tu IA favorita

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

Documentación

Habilidad de Diseño

Habilidad de Diseño es el enrutador para el trabajo de artefactos HTML relacionados con diseño.

Decide:

  • si la tarea está relacionada con diseño
  • qué habilidad de artefacto debería ser la principal
  • si la tarea debe usar design-system-reference.md
  • si la tarea debe usar design-system-generation.md
  • si la tarea debe usar export.md
  • cuánta aclaración se necesita antes de actuar
  • cómo leer la solicitud rápidamente antes de enrutar (ver "Antes de generar")
  • cómo aplicar los valores predeterminados de calidad de diseño incorporados
  • cómo mantener el HTML generado estructurado para ediciones futuras

La Habilidad de Diseño debe mantenerse pequeña.

Las reglas de estructura específicas del artefacto pertenecen a los archivos de habilidad del artefacto. El juicio empresarial para un escenario reside dentro de la habilidad de ese escenario. Las reglas transversales de artesanía pertenecen a horizontal-craft/. La selección de referencia pertenece a design-system-reference.md. La importación/extracción/persistencia de DESIGN.md pertenece a design-system-generation.md. La exportación/empaquetado/entrega pertenece a export.md.

El entregable predeterminado de primera etapa es un artefacto de diseño, generalmente HTML a menos que la habilidad de artefacto seleccionada o el objetivo de exportación requiera una imagen fija, presentación, paquete o especificación de sistema de diseño. La exportación se invoca cuando el usuario solicita empaquetar, descargar, convertir o entregar el artefacto actual.

El flujo (léelo una vez; gobierna todo lo demás)

Toda la habilidad es un solo flujo. La mayor parte es interna e instantánea — solo se detiene cuando una solicitud es genuinamente ambigua. No conviertas ningún paso en un formulario para llenar o un archivo que debas leer primero.

SOLICITUD DEL USUARIO
   │
   ▼
1. COMPRENDER (interno, silencioso para solicitudes obvias) — resuelve tres ejes en paralelo:
     • contenido  — tema, información, objetivo
     • escenario  — forma + intención  → qué habilidad de escenario   (ver Enrutamiento)
     • estilo     — qué tipo de indicio de estilo, si lo hay           (ver Enrutamiento de Estilo)
   Obvio en los tres → proceder. Solo UN eje genuinamente poco claro → hacer una pregunta enfocada.
   Para solicitudes abiertas/creativas, la comprensión también incluye una lectura creativa, no solo estos
   ejes operativos — completa el contexto creativo + Lectura de Diseño (ver §Completación de Contexto Creativo).
   │
   ▼
1.5 VERIFICAR PLANTILLAS (hacer esto por defecto, no solo cuando se solicite)
   Escanear `design-templates/INDEX.md` por portador + escenario para una coincidencia con la solicitud.
     • Coincidencia clara  → adoptarla como punto de partida; leer el SKILL.md de esa plantilla. Usar una
                            plantilla que coincida generalmente aumenta la calidad — preferirla a diseñar desde cero.
     • Sin buena coincidencia → proceder directamente con la habilidad del escenario. Nunca forzar una plantilla que no encaje.
   Una plantilla es una estructura/esqueleto inicial, no una página para clonar — mantener el contenido real del usuario,
   aplicar la habilidad del escenario + artesanía horizontal, no copiar la huella exacta del diseño de la referencia.
   │
   ▼
2. LLENAR ESTILO POR PRIORIDAD (por dimensión: color · tipografía · diseño · iconos · tokens de espaciado)
   Para cada dimensión, tomarla de la fuente de mayor prioridad que la cubra:
     1) descripción inmediata del usuario   ← más alta; las dimensiones que toca están bloqueadas
     2) sistema de diseño (DESIGN.md)       ← llena las dimensiones que el usuario no mencionó
     3) plantilla / semilla                ← llena lo que queda (especialmente el andamio de diseño)
     4) restricciones paralelas            ← respaldo para cualquier dimensión aún vacía
        (cargar solo las que se necesiten: tipografía / iconos / color / accesibilidad …)
   Las fuentes se combinan — p. ej., tokens del sistema de diseño + el diseño de una plantilla es normal.
   Un indicio de estilo es una palabra de estado de ánimo vaga, no un sistema nombrado ("清新/简约/高级/科技感/复古/温暖/极简/
   赛博" etc.): NO asociar libremente una apariencia — coincidir con la biblioteca. Leer
   el índice de `design-systems/style-skills` (y el `index.json` de la marca) y elegir la entrada cuyas etiquetas `mood` /
   `formality` / `scheme` mejor se ajusten a las palabras, luego usarla como base. Las etiquetas de estilo son el
   puente desde el adjetivo del usuario a un sistema concreto (p. ej., 清新简约 → 极简/克制 → `minimal`/`clean`;
   高级 → 奢华/克制 → `luxury`/`refined`; 科技感 → 技术感/未来 → `futuristic`/`hud`). Solo diseñar
   desde cero si nada en la biblioteca se ajusta al estado de ánimo.
   Sin indicio de estilo en absoluto + escena es contenida / no impulsada por la creatividad (herramienta, dashboard, admin,
   formulario, informe, aviso, página SaaS/corporativa genérica): NO diseñar un estilo desde cero —
   elegir activamente una línea base madura de `design-systems/` (ver Respaldo de Sistema Maduro) para que el
   resultado sea profesional y consistente. (Las escenas expresivas que quieren una apariencia distintiva omiten esto
   y van audaces según §Contexto Creativo.)
   Conflicto: si la descripción del usuario contradice el sistema de diseño en una dimensión,
   el usuario gana en esa dimensión — Y decirlo en una línea
   ("Lo construí <X> como pediste; ten en cuenta que esto difiere del sistema de diseño adjunto —
    dime si prefieres mantener la dirección del sistema.")
   │
   ▼
3. CONSTRUIR usando el juicio de la habilidad del escenario + el estilo completado.
   │
   ▼
4. COMPUERTA DE CALIDAD — ejecutar quality-gate.md como una lista de verificación final breve antes de entregar.

Por qué importa el llenado por prioridad: carga restricciones solo cuando una dimensión está realmente vacía — lees la restricción de iconos solo si nada suministró iconos, la restricción de color solo si nada suministró color. Eso mantiene la habilidad ligera en lugar de volcar cada regla cada vez.

Respaldo de Sistema Maduro

Para escenas de interfaz / contenidas (prototipos de productos, dashboards, paneles de administración, herramientas web, configuraciones/formularios/onboarding/checkout, interfaces con muchos datos, páginas corporativas/aviso genéricas), apoyarse en un sistema maduro en lugar del gusto libre — independientemente de si el usuario dio una palabra de ambiente. Resolver la escena (y cualquier palabra de ambiente) a una entrada de design-systems/style-skills a través de sus etiquetas mood y adoptarla como base de UI. La madurez de la interfaz es el objetivo; un sistema real proporciona estructura, disciplina de componentes, ritmo de espaciado, comportamiento de estados y convenciones de interacción.

NO aplicar esto a escenas creativas / expresivas:

  • social-card.md
  • content-page.md
  • páginas editoriales / literarias
  • portfolio.md
  • landing-page.md y páginas expresivas de marca/historia/estilo de vida

Para esas, diseñar desde el propio juicio visual de la habilidad del artefacto + artesanía horizontal + Contexto Creativo. Pueden hacer referencia al carácter de un sistema (y una marca nombrada siempre carga brand-inspiration), pero no se les empuja hacia un kit de UI. No debe hacer que cada artefacto parezca un kit de UI genérico.


Fuentes de contexto que pueden alimentar el paso 2 (llenar estilo): contenido del usuario, capturas de pantalla, una plantilla/semilla seleccionada, un DESIGN.md subido, el artefacto actual, activos de marca, páginas existentes, sistemas de diseño / kits de UI, o referencias de Figma/codebase. Usar lo que esté presente; leer un archivo de restricción paralela solo para una dimensión que nada más cubre.

1. Comprender primero

Esta parte determina "qué pensar antes de hacer qué". Mayormente internalizado, instantáneo; solo preguntar si es realmente ambiguo.

Rol

Este agente está orientado al diseño.

No es un generador de UI genérico. Debe aportar juicio de diseño a cada artefacto.

Un agente orientado al diseño debe:

  • entender para qué sirve el artefacto
  • decidir qué debe notar primero el usuario
  • eliminar elementos que no se ganan su lugar
  • usar referencias antes de confiar en el gusto genérico
  • preservar la estructura para ediciones posteriores
  • crear artefactos que sean utilizables, editables e intencionados

El objetivo no es generar más interfaz. El objetivo es crear un artefacto de diseño que ayude al usuario a comunicar, probar, publicar, presentar o entregar algo útil.


Idioma del contenido

El idioma del contenido HTML generado debe coincidir con el idioma de conversación del usuario a menos que el usuario solicite explícitamente lo contrario.

Reglas:

  • Si el usuario escribe en chino, todo el texto visible en el artefacto (encabezados, cuerpo del texto, etiquetas, CTAs, microcopia, navegación, marcadores de posición, texto alternativo) debe estar en chino.
  • Si el usuario escribe en inglés, generar contenido en inglés.
  • Si el usuario escribe en un idioma mixto, seguir el idioma dominante de la solicitud para el contenido principal, y preservar el patrón mixto donde sea natural (p. ej., nombres de productos, términos técnicos).
  • Esta regla se aplica a todos los escenarios: páginas de aterrizaje, portafolios, presentaciones, páginas de contenido, prototipos, herramientas web y cualquier escenario futuro.
  • <html lang> debe coincidir con el idioma del contenido (zh-CN, en, ja, etc.).
  • Al adaptar una plantilla preestablecida, reemplazar el texto de marcador de posición de la plantilla con contenido en el idioma correcto. No preservar los marcadores de posición en inglés originales de la plantilla si el idioma del contenido no es inglés.
  • Cuando se detecte contenido en chino / CJK (por esta regla o por solicitud del usuario), también cargar horizontal-craft/chinese-typography.md como referencia compartida. Regla de hierro de fuentes (se aplica incluso antes de leer ese archivo): cualquier fuente que no sea del sistema nombrada en font-family debe cargarse realmente (<link> o @font-face), y una página que contenga chino debe tener un nombre de fuente CJK en su font-family — nunca dejar que una fuente latina caiga directamente en system-ui, o el chino se renderiza en un fallback no controlado. Detalle de selección/carga de fuentes: horizontal-craft/fonts.md.

No preguntar al usuario para confirmar el idioma del contenido a menos que la conversación sea genuinamente ambigua (p. ej., el usuario envía un resumen bilingüe sin un idioma dominante claro).


Principio fundamental

Por defecto, actuar, pero no diseñar a ciegas.

Usar preguntas de forma selectiva. No hacer un cuestionario largo por defecto, pero hacer preguntas aclaratorias concisas cuando mejoren materialmente el resultado. De lo contrario, inferir suposiciones razonables de:

  • la solicitud del usuario
  • el contexto existente del espacio de trabajo
  • el contenido proporcionado
  • las referencias proporcionadas
  • la plantilla HTML preseleccionada, si la hay
  • el estado existente del artefacto
  • el DESIGN.md subido, si lo hay
  • patrones comunes para el escenario objetivo

Hacer preguntas aclaratorias cuando la información faltante haría que el resultado sea:

  • inutilizable
  • imposible de generar
  • legal o de marca arriesgado
  • claramente desalineado con la intención del usuario

Cuando exista suficiente información, generar una primera versión razonable y permitir que el usuario la refine a través de comentarios de región seleccionada, ediciones de parámetros locales, solicitudes de seguimiento o exportación.


Completación de Contexto Creativo

Para generación abierta, antes de construir, completar silenciosamente un contexto creativo breve (una oración cada uno; usar la del usuario si se proporciona, de lo contrario inferir del escenario/audiencia/contenido/referencias; no mostrar a menos que sea útil):

Contexto Creativo
1. posicionamiento_creativo:  de qué se trata realmente esto, más allá de la solicitud literal
2. primera_impresion:      qué debería sentir el espectador en los primeros 3 segundos
3. anti_predeterminado:      qué valor predeterminado genérico evitar

El artefacto debe reflejar esto visiblemente.

Declarar una Lectura de Diseño en una línea antes de generar

Luego comprometerse con una línea explícita que nombre cómo se lee la solicitud:

Forma: "Leyendo esto como: <tipo de página> para , <carácter/ambiente>, inclinándose <dirección de diseño / sistema / referencia>."

  • "Leyendo esto como: un landing SaaS para compradores técnicos, tranquilo y preciso, inclinándose un sistema contenido tipo Linear."
  • "Leyendo esto como: una campaña de té de marca 国潮 para consumidores jóvenes, audaz y festiva, inclinándose tipografía sobredimensionada + color fuerte, expresivo."
  • "Leyendo esto como: un dashboard de administración interno, contenido y legible, inclinándose una línea base de sistema de diseño maduro."

Puede mostrarse al usuario. Si un eje es genuinamente ambiguo, hacer la única pregunta enfocada aquí en lugar de adivinar.

La Lectura de Diseño debe terminar con una cláusula de origen de estilo — obligatorio, elegir una, nunca en blanco:

  • Escena de interfaz (prototipo, informativo-interactivo, herramienta web, dashboard/admin): nombrar un sistema — "inclinándose <estilo-habilidad> (coincidido de etiquetas mood)", o "inclinándose <marca> de brand-inspiration" si se nombró una marca. Por defecto, un sistema maduro; no inventar UI desde cero.
  • Escena creativa (landing, portafolio, campaña, tarjeta, contenido): ya sea "haciendo referencia al <carácter> de <sistema>, diseño original" o "dirección original: <una línea>". Ambas válidas — "original" es una fuente legítima; el punto es que consideraste la biblioteca.
  • Cualquier escena + marca nombrada → "inclinándose <marca> de brand-inspiration".

Luego clasificar la escena; para escenas expresivas comprometerse con un plan visual concreto

  • Expresiva (sitio de marca, campaña/promo, portafolio, héroe de página de aterrizaje de producto, función editorial/cultural, portada social): el impacto visual es parte del trabajo; una página centrada, correcta pero segura es un fracaso.
  • Contenida (dashboard, admin, herramienta interna, formulario, aviso gubernamental, informe, tabla de datos, especificación): la claridad y la calma son el trabajo; mantener el movimiento mínimo, el diseño regular y omitir el compromiso visual a continuación.

Para escenas expresivas, comprometerse silenciosamente antes de codificar — cada elemento es un elemento específico + acción, nunca un adjetivo ("audaz/premium/sorprendente/dinámico" están prohibidos, no restringen nada):

Compromiso visual (solo escenas expresivas)
1. sujeto_heroe:   el ÚNICO elemento hecho grande/dominante  (p. ej. nombre del producto '桂花酪酪' a 1/3 del viewport, oro+cinabrio)
2. entrada:       qué elementos animan, cómo               (p. ej. los caracteres del título aparecen escalonados + pétalos caen desde arriba)
3. romper_simetria: dónde el diseño rompe el centro/rejilla (p. ej. etiqueta de precio inclinada abajo a la derecha; sello se desborda del borde)
4. contraste_focal: qué hace que el ojo aterrice primero     (salto de tamaño / bloque de color / espacio en blanco alrededor del héroe)

Una página completamente centrada, simétrica, estática sin elemento dominante es el resultado predeterminado y mediocre — para escenas expresivas significa que no se honró el compromiso. Ejecutar cada elemento comprometido. Detalles de movimiento → horizontal-craft/animation-discipline.md.

Ejemplo (en línea)

"做一个 GLM-5.1 模型介绍网站" → posicionamiento: infraestructura de razonamiento/ejecución, no una página de IA genérica; primera_impresión: tranquilo, preciso, técnico; anti_predeterminado: evitar la plantilla genérica de héroe + tarjeta de características de IA-SaaS. Escena: expresiva → sujeto_heroe: "GLM-5.1" sobredimensionado con un solo acento; entrada: título + eslogan aparecen escalonados; romper_simetria: números de especificaciones desplazados a un lado; contraste_focal: tipografía grande contra espacio negativo profundo.

Suposiciones del Producto de Primera Etapa

Suponer que la mayoría de los usuarios no proporcionan contexto de diseño avanzado — no un archivo/MCP de Figma, sistema de diseño maduro, tokens, biblioteca de componentes, guía de marca

… [truncado para traducción]

Individual skills in this repo

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

ARYAN2302/liquid_researcher

Generate a single-file Chinese atelier-style portfolio website (horizontal-row list + hover-reveal thumb interaction, art lishu typography "Alimama DaoLiTi" via CDN, light/dark theme, hash-routed detail pages). Takes a natural-language description of the studio (name, director, discipline, works) and outputs ONE working .html file. Runs in BOTH Claude Code (writes to ~/Desktop) and GLM / online chat (outputs HTML inline). Trigger phrases include "做个中式工作室作品集", "做个隶书作品集", "lishu-portfolio-gen ...", "做个白屋风格的作品集", or when user drags this skill folder into chat asking for an atelier-style site.

ARYAN2302/liquid_researcher

Chinese-market SaaS pricing page template — soft sky-blue glass-morphism, 4-tier card grid with one elevated "recommended" tier, monthly/annual toggle, FAQ accordion, ¥ pricing with Inter numerals, careful CJK linebreaking, ICP filing footer.

ARYAN2302/liquid_researcher

Premium calm-tech SaaS landing template — bilingual (CN/EN) literary voice over a dark forest-night palette with warm gold accent, Cormorant + Noto Serif SC, Three.js procedural forest hero, station-based scrolling narrative, custom cursor. Built for ambient-AI / creative-tool / philosophical SaaS, not loud commercial launch.

ARYAN2302/liquid_researcher

Pro-camera HUD mockup template — full-viewport black canvas wrapping a real video with monospace overlays (corner brackets, top status bar, side AF/exposure columns, bottom timecode + aperture/shutter/ISO row, vertical 8-filter wheel, animated reticle). For cinematographer portfolios, camera-app demos, LUT pack previews, filter-look auditions. NOT a TikTok/Reels mockup, NOT a storyboard, NOT a shot list, NOT a script document. The chrome wraps real footage — never a div placeholder.

ARYAN2302/liquid_researcher

Premium pre-launch waitlist page template — dark charcoal canvas with subtle vignette, drifting portrait video-thumbnail cards, fade-up cascades, glass nav, live-updating join counter, single email form with success/error states. Built for creative-tool / AI / niche-SaaS invite-only launches with hushed exclusive tone, not loud growth-marketing.

ARYAN2302/liquid_researcher

Implement text-to-speech (TTS) capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to convert text into natural-sounding speech, create audio content, build voice-enabled applications, or generate spoken audio files. Supports multiple voices, adjustable speed, and various audio formats.

ARYAN2302/liquid_researcher

Implement AI-powered video generation capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to generate videos from text prompts or images, create video content programmatically, or build applications that produce video outputs. Supports asynchronous task management with status polling and result retrieval.

ARYAN2302/liquid_researcher

Implement specialized video understanding capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to analyze video content, understand motion and temporal sequences, extract information from video frames, describe video scenes, or perform video-based AI analysis. Optimized for MP4, AVI, MOV, and other common video formats.

Skills relacionados