Communitygithub.com

ARYAN2302/liquid_researcher

Roteia tarefas de artefatos HTML relacionadas a design para a skill de artefato correta, referência, geração de sistema de design ou skill de exportação.

O que é liquid_researcher?

A Design Skill é um roteador inteligente para trabalhos com artefatos HTML relacionados a design. Ela decide se uma tarefa é de design, qual skill de artefato deve ser primária, se deve usar referências de sistema de design, geração de sistema de design ou exportação, e quanto esclarecimento é necessário antes de agir. O fluxo principal é composto por etapas internas e instantâneas: entender (resolver conteúdo, cenário e estilo), verificar templates, preencher estilo por prioridade (descrição do usuário, sistema de design, template, restrições paralelas), construir com o julgamento da skill de cenário e aplicar uma verificação de qualidade final. A skill prioriza ação, mas não projeta cegamente, usando perguntas seletivas apenas quando necessário e inferindo suposições razoáveis do contexto. Para cenas de interface (protótipos, dashboards, painéis de administração), ela adota um sistema maduro de design-systems/style-skills para garantir profissionalismo, enquanto para cenas criativas (landing pages, portfólios, campanhas) permite direção visual original. A skill também lida com completude de contexto criativo, leitura de design e compromissos visuais para cenas expressivas, garantindo que os artefatos sejam utilizáveis, editáveis e intencionais.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Design Skill

A Design Skill é o roteador para trabalhos com artefatos HTML relacionados a design.

Ela decide:

  • se a tarefa é relacionada a design
  • qual skill de artefato deve ser primária
  • se a tarefa deve usar design-system-reference.md
  • se a tarefa deve usar design-system-generation.md
  • se a tarefa deve usar export.md
  • quanto esclarecimento é necessário antes de agir
  • como ler a solicitação rapidamente antes de rotear (veja "Antes de gerar")
  • como aplicar padrões de qualidade de design embutidos
  • como manter o HTML gerado estruturado para edições futuras

A Design Skill deve permanecer pequena.

Regras de estrutura específicas de artefato pertencem aos arquivos de skill de artefato. Julgamento de negócio para um cenário reside dentro da skill desse cenário. Regras transversais de ofício pertencem a horizontal-craft/. A seleção de referência pertence a design-system-reference.md. A importação/extração/persistência de DESIGN.md pertence a design-system-generation.md. Exportação/empacotamento/repassagem pertence a export.md.

O entregável padrão de primeira etapa é um artefato de design, geralmente HTML, a menos que a skill de artefato selecionada ou o destino de exportação exija uma imagem fixa, deck, pacote ou especificação de sistema de design. A exportação é invocada quando o usuário pede para empacotar, baixar, converter ou repassar o artefato atual.

O fluxo (leia isto uma vez; rege tudo abaixo)

A skill inteira é um fluxo. A maior parte é interna e instantânea — ela pausa apenas quando uma solicitação é genuinamente ambígua. Não transforme nenhuma etapa em um formulário a preencher ou um arquivo que você deve ler primeiro.

SOLICITAÇÃO DO USUÁRIO
   │
   ▼
1. ENTENDER (interno, silencioso para solicitações óbvias) — resolver três eixos em paralelo:
     • conteúdo  — assunto, informação, objetivo
     • cenário    — forma + intenção  → qual skill de cenário   (veja Roteamento)
     • estilo    — que tipo de dica de estilo, se houver           (veja Roteamento de Estilo)
   Óbvio em todos os três → prossiga. Apenas UM eixo genuinamente pouco claro → faça uma pergunta focada.
   Para solicitações abertas/criativas, a compreensão também inclui uma leitura criativa, não apenas esses
   eixos operacionais — complete o contexto criativo + Leitura de Design (veja §Finalização do Contexto Criativo).
   │
   ▼
1.5 VERIFICAR MODELOS (faça isso por padrão, não apenas quando solicitado)
   Escaneie `design-templates/INDEX.md` por portador + cenário para uma correspondência com a solicitação.
     • Correspondência clara  → adote-a como ponto de partida; leia o SKILL.md desse modelo. Usar um
                      modelo correspondente geralmente aumenta a qualidade — prefira-o a projetar do zero.
     • Sem boa correspondência → prossiga diretamente com a skill de cenário. Nunca force um modelo que não se encaixa.
   Um modelo é uma estrutura/esqueleto inicial, não uma página para clonar — mantenha o conteúdo real do usuário,
   aplique a skill de cenário + ofício transversal, não copie a impressão digital do layout da referência.
   │
   ▼
2. PREENCHER ESTILO POR PRIORIDADE (por dimensão: cor · tipo · layout · ícones · tokens de espaçamento)
   Para cada dimensão, obtenha-a da fonte de maior prioridade que a cobre:
     1) descrição imediata do usuário   ← mais alta; dimensões que ela toca são bloqueadas
     2) sistema de design (DESIGN.md)      ← preenche dimensões que o usuário não mencionou
     3) modelo / semente                ← preenche o que resta (especialmente andaime de layout)
     4) restrições paralelas           ← fallback para qualquer dimensão ainda vazia
        (carregue apenas as que você precisa: tipo / ícones / cor / a11y …)
   As fontes se combinam — por exemplo, tokens do sistema de design + layout de um modelo é normal.
   Dica de estilo é uma palavra de humor vaga, não um sistema nomeado ("清新/简约/高级/科技感/复古/温暖/极简/
   赛博" etc.): NÃO apenas associe livremente uma aparência — corresponda-a à biblioteca. Leia
   o índice de `design-systems/style-skills` (e o `index.json` da marca) e escolha a entrada cujas tags de `mood` /
   `formality` / `scheme` melhor se encaixam nas palavras, então use-a como base. As tags de estilo são a
   ponte do adjetivo de um usuário para um sistema concreto (por exemplo, 清新简约 → 极简/克制 → `minimal`/`clean`;
   高级 → 奢华/克制 → `luxury`/`refined`; 科技感 → 技术感/未来 → `futuristic`/`hud`). Apenas projete
   do zero se nada na biblioteca se encaixar no clima.
   Nenhuma dica de estilo + cena é contida / não orientada por criatividade (ferramenta, dashboard, admin,
   formulário, relatório, aviso, página SaaS/corporativa genérica): NÃO projete um estilo do zero —
   ativamente escolha uma linha de base madura de `design-systems/` (veja Fallback para Sistema Maduro) para que o
   resultado seja profissional e consistente. (Cenas expressivas que querem uma aparência distinta ignoram isso
   e vão ousadas conforme §Contexto Criativo.)
   Conflito: se a descrição do usuário contradiz o sistema de design em uma dimensão,
   o usuário vence nessa dimensão — E diga isso em uma linha
   ("Construí <X> como você pediu; note que isso difere do sistema de design anexado —
    me diga se você prefere manter a direção do sistema.")
   │
   ▼
3. CONSTRUIR usando o julgamento da skill de cenário + o estilo preenchido.
   │
   ▼
4. PORTÃO DE QUALIDADE — execute `quality-gate.md` como uma lista de verificação final enxuta antes de entregar.

Por que o preenchimento por prioridade importa: ele carrega restrições apenas quando uma dimensão está realmente vazia — você lê a restrição de ícone apenas se nada forneceu ícones, a restrição de cor apenas se nada forneceu cor. Isso mantém a skill leve em vez de despejar todas as regras todas as vezes.

Fallback para Sistema Maduro

Para interface / cenas contidas (protótipos de produto, dashboards, painéis de administração, ferramentas web, configurações/formulários/onboarding/checkout, interfaces densas em dados, páginas corporativas/aviso genéricas), apoie-se em um sistema maduro em vez de gosto livre — quer o usuário tenha dado ou não uma palavra de vibe. Resolva a cena (e qualquer palavra de vibe) para uma entrada de design-systems/style-skills através de suas tags de mood e adote-a como base de UI. Maturidade de interface é o objetivo; um sistema real fornece estrutura, disciplina de componentes, ritmo de espaçamento, comportamento de estado e convenções de interação.

NÃO aplique isso a cenas criativas / expressivas:

  • social-card.md
  • content-page.md
  • páginas editoriais / literárias
  • portfolio.md
  • landing-page.md e páginas expressivas de marca/história/estilo de vida

Para essas, projete a partir do julgamento visual próprio da skill de artefato + ofício transversal + Contexto Criativo. Elas podem referenciar o caráter de um sistema (e uma marca nomeada sempre carrega brand-inspiration), mas não são empurradas para um kit de UI. Isso não deve fazer cada artefato parecer um kit de UI genérico.


Fontes de contexto que podem alimentar a etapa 2 (preencher estilo): conteúdo do usuário, capturas de tela, um modelo/semente selecionado, um DESIGN.md carregado, o artefato atual, ativos de marca, páginas existentes, sistemas de design / kits de UI, ou referências do Figma/base de código. Use o que estiver presente; leia um arquivo de restrição paralela apenas para uma dimensão que nada mais cobre.

1. Entender primeiro

Esta seção decide "o que pensar antes de fazer". Na maioria dos casos, é internalizada e instantânea; apenas pergunte se realmente ambíguo.

Papel

Este agente é orientado a design.

Ele não é um gerador de UI genérico. Deve trazer julgamento de design para cada artefato.

Um agente orientado a design deve:

  • entender para que serve o artefato
  • decidir o que o usuário deve notar primeiro
  • remover elementos que não merecem seu lugar
  • usar referências antes de confiar em gosto genérico
  • preservar estrutura para edições posteriores
  • criar artefatos que são utilizáveis, editáveis e intencionais

O objetivo não é gerar mais interface. O objetivo é criar um artefato de design que ajude o usuário a comunicar, testar, publicar, apresentar ou repassar algo útil.


Idioma do Conteúdo

O idioma do conteúdo HTML gerado deve corresponder ao idioma da conversa do usuário, a menos que o usuário solicite explicitamente o contrário.

Regras:

  • Se o usuário escreve em chinês, todo o texto visível no artefato (títulos, corpo do texto, rótulos, CTAs, microcópia, navegação, espaços reservados, texto alternativo) deve estar em chinês.
  • Se o usuário escreve em inglês, gere conteúdo em inglês.
  • Se o usuário escreve em um idioma misto, siga o idioma dominante da solicitação para o conteúdo principal e preserve o padrão misto onde natural (por exemplo, nomes de produtos, termos técnicos).
  • Esta regra se aplica a todos os cenários: landing pages, portfólios, decks, páginas de conteúdo, protótipos, ferramentas web e qualquer cenário futuro.
  • <html lang> deve corresponder ao idioma do conteúdo (zh-CN, en, ja, etc.).
  • Ao adaptar um modelo predefinido, substitua o texto do espaço reservado do modelo pelo conteúdo no idioma correto. Não preserve os espaços reservados em inglês originais do modelo se o idioma do conteúdo não for inglês.
  • Quando conteúdo chinês / CJK é detectado (por esta regra ou por solicitação do usuário), também carregue horizontal-craft/chinese-typography.md como uma referência compartilhada. Regra de ferro para fontes (aplica-se mesmo antes de ler esse arquivo): qualquer fonte não sistêmica nomeada em font-family deve ser realmente carregada (<link> ou @font-face), e uma página contendo chinês deve ter um nome de fonte CJK em sua font-family — nunca deixe uma fonte latina cair direto para system-ui, ou o chinês será renderizado em um fallback não controlado. Detalhe de seleção/carregamento de fonte: horizontal-craft/fonts.md.

Não pergunte ao usuário para confirmar o idioma do conteúdo, a menos que a conversa seja genuinamente ambígua (por exemplo, o usuário envia um briefing bilíngue sem um idioma dominante claro).


Princípio Central

Padrão para ação, mas não projete cegamente.

Use perguntas seletivamente. Não faça um longo questionário por padrão, mas faça perguntas esclarecedoras concisas quando elas melhorarem materialmente o resultado. Caso contrário, infira suposições razoáveis de:

  • a solicitação do usuário
  • o contexto existente do espaço de trabalho
  • o conteúdo fornecido
  • as referências fornecidas
  • o modelo de HTML predefinido selecionado, se houver
  • o estado existente do artefato
  • o DESIGN.md carregado, se houver
  • padrões comuns para o cenário alvo

Faça perguntas esclarecedoras quando informações faltantes tornariam o resultado:

  • inutilizável
  • impossível de gerar
  • arriscado legalmente ou para a marca
  • claramente desalinhado com a intenção do usuário

Quando informações suficientes existem, gere uma primeira versão razoável e deixe o usuário refiná-la através de comentários de região selecionada, edições de parâmetros locais, solicitações de acompanhamento ou exportação.


Finalização do Contexto Criativo

Para geração aberta, antes de construir, complete silenciosamente um breve contexto criativo (uma frase cada; use o do usuário se fornecido, caso contrário, infira do cenário/público/conteúdo/referências; não mostre a menos que útil):

Contexto Criativo
1. posicionamento_criativo:  o que isso realmente é, além da solicitação literal
2. primeira_impressão:      o que o espectador deve sentir nos primeiros 3 segundos
3. anti_padrão:          qual padrão genérico evitar

O artefato deve refletir visivelmente isso.

Declare uma Leitura de Design de uma linha antes de gerar

Em seguida, comprometa-se com uma linha explícita nomeando como você leu a solicitação:

Forma: "Lendo como: <tipo de página> para <público>, <caráter/vibe>, inclinando <direção de design / sistema / referência>."

  • "Lendo como: um SaaS landing para compradores técnicos, calmo e preciso, inclinando um sistema Linear-like contido."
  • "Lendo como: uma campanha de chá de marca 国潮 para jovens consumidores, ousada e festiva, inclinando tipo grande + cor forte, expressivo."
  • "Lendo como: um painel de administração interno, contido e legível, inclinando uma linha de base de sistema de design maduro."

Pode ser mostrado ao usuário. Se um eixo for genuinamente ambíguo, faça a única pergunta focada aqui em vez de adivinhar.

A Leitura de Design deve terminar com uma cláusula de fonte de estilo — obrigatório, escolha uma, nunca em branco:

  • Cena de interface (protótipo, info-interativo, ferramenta web, dashboard/admin): nomeie um sistema — "inclinando <style-skill> (correspondido das tags de mood)", ou "inclinando <marca> de brand-inspiration" se uma marca foi nomeada. Padrão para um sistema maduro; não invente UI do zero.
  • Cena criativa (landing, portfólio, campanha, card, conteúdo): ou "referenciando <sistema>'s <caráter>, layout original" ou "direção original: <uma linha>". Ambos válidos — "original" é uma fonte legítima; o ponto é que você considerou a biblioteca.
  • Qualquer cena + marca nomeada → "inclinando <marca> de brand-inspiration".

Em seguida, classifique a cena; para cenas expressivas, comprometa-se com um plano visual concreto

  • Expressiva (site de marca, campanha/promo, portfólio, hero de landing page de produto, recurso editorial/cultural, capa social): impacto visual é parte do trabalho; uma página centralizada correta-mas-segura é uma falha.
  • Contida (dashboard, admin, ferramenta interna, formulário, aviso governamental, relatório, tabela de dados, especificação): clareza e calma são o trabalho; mantenha movimento mínimo, layout regular e pule o compromisso visual abaixo.

Para cenas expressivas, comprometa-se silenciosamente antes de codificar — cada item é um elemento + ação específica, nunca um adjetivo ("ousado/premium/surpreendente/dinâmico" são proibidos, eles não restringem nada):

Compromisso visual (apenas cenas expressivas)
1. assunto_hero:   o ÚNICO elemento feito grande/dominante  (ex. nome do produto '桂花酪酪' em 1/3 da viewport, ouro+cinábrio)
2. entrada:       quais elementos animam, como       (ex. caracteres do título entram escalonados + pétalas caem do topo)
3. quebrar_simetria: onde o layout quebra centro/grelha      (ex. etiqueta de preço angulada no canto inferior direito; selo sangra na borda)
4. contraste_focal: o que faz o olho pousar primeiro         (salto de tamanho / bloco de cor / espaço em branco ao redor do hero)

Uma página totalmente centralizada, simétrica e estática, sem elemento dominante, é o padrão-平庸 — para cenas expressivas, significa que o compromisso não foi honrado. Execute cada item comprometido. Especificidades de movimento → horizontal-craft/animation-discipline.md.

Exemplo (em linha)

"Fazer um site de introdução do modelo GLM-5.1" → posicionamento: infraestrutura de raciocínio/execução, não uma página de IA genérica; primeira_impressão: calmo, preciso, técnico; anti_padrão: evitar o modelo genérico de hero + feature-card de IA-SaaS. Cena: expressiva → assunto_hero: "GLM-5.1" grande com um único acento; entrada: título + tagline fade-up escalonado; quebrar_simetria: números de especificação deslocados para um lado; contraste_focal: tipo grande contra espaço negativo profundo.

Suposições do Produto de Primeira Etapa

Assuma que a maioria dos usuários não fornece contexto de design avançado — não um arquivo Figma/MCP, sistema de design maduro, tokens, biblioteca de componentes, diretriz de marca

…

[truncado para tradução]

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.

Habilidades Relacionadas