Communitygithub.com

ARYAN2302/liquid_researcher

Gera um site portfólio de estilo chinês atelier (lista horizontal com hover, tipografia artística 'Alimama DaoLiTi' via CDN, tema claro/escuro, páginas de detalhe com roteamento hash) em um único arquivo HTML. Aceita descrição em linguagem natural do estúdio e funciona tanto no Claude Code quanto em chatbots como GLM.

O que é liquid_researcher?

Esta skill é especializada em gerar um site portfólio de único arquivo HTML para estúdios de design, caligrafia, artesanato ou outros ateliês com estética chinesa minimalista e elegante. O resultado é uma página horizontal com linhas de texto que, ao passar o mouse, revela uma grande imagem à direita. Utiliza a fonte decorativa 'Alimama DaoLiTi' (阿里妈妈刀隶体) carregada via CDN, suporta temas claro e escuro, e oferece páginas de detalhe individuais para cada projeto, acessadas via hash routing. A skill aceita uma descrição em linguagem natural do estúdio (nome, diretor, cidade, disciplina, obras) e gera automaticamente todo o conteúdo textual (lead, prosa, specs, créditos) e visual (imagens placeholder do picsum se necessário). Funciona em dois modos: no Claude Code (com sistema de arquivos, salvando em ~/Desktop) e em chatbots como GLM (sem sistema de arquivos, retornando o HTML inline). É ativada por frases como '做个中式工作室作品集', '做个隶书作品集' ou 'lishu-portfolio-gen'. A skill inclui um template HTML com 20 pontos de troca (SWAP) e um arquivo de referência. O desenvolvedor deve ler ambos, extrair as informações do usuário e preencher os SWAPs, gerando JSON de dados das obras, galeria de imagens e textos descritivos com tom contido e artesanal, sem linguagem de marketing.

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

Perguntar na sua IA favorita

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

Documentação

portfolio-detail — Estúdio Chinês / Portfólio de Caligrafia (com Página de Detalhe Secundária)

Característica em Uma Frase

Linhas de texto horizontal + hover revela imagem grande à direita + fonte artística "Alimama DaoLiTi" em caracteres grandes + preto e branco puro + tema claro/escuro + página de detalhe com roteamento hash + visualização em lista/álbum dupla.

Diferenças de Outras Skills de Portfólio

skillModo PrincipalIdeal para
portfolio-genTela infinita de arrastar + tiles lado a ladoFotógrafos / Designers gráficos mostrarem amostras
portfolio-museum-genHero carrossel + cards grandes + waterfall flow + página de detalhe (sensação curatorial de imagem/vídeo)Artistas de vídeo/imagem/instalação
industrial-archive-genCapa de virada com moldura preta + barra lateral de arquivo + industrial nórdicoProdutos físicos / utensílios / hardware
lishu-portfolio-genLinhas de texto horizontal + hover mostra miniatura à direita + caracteres grandes em lishu + contido chinêsEncadernação / Tipografia / Exposição / Natureza-morta / Ervas chinesas / Chá / Cerâmica / Madeira / Papel / Incenso

Se o projeto do usuário for sobre "livro / tipografia / exposição / natureza-morta / ervas chinesas / chá / cerâmica / madeira / papel / incenso" e precisar de uma atmosfera contida e elegante — use esta skill.

Quando Ativar

Quando o usuário disser:

  • "Crie um portfólio de estilo chinês / oriental / clássico"
  • "Faça um site de estilo lishu / página inicial de estúdio"
  • "Crie um portfólio estilo casa branca" / "Faça um site de lista horizontal como o Gurgel D'Alfonso"
  • "lishu-portfolio-gen ..."

E fornecer:

  • Descrição do estúdio (obrigatório): nome, diretor, cidade, disciplina, títulos e histórias de algumas obras
  • Imagens das obras (opcional): URL / upload / caminho. Funciona mesmo sem (usa picsum como placeholder)

Se o usuário não der nenhum título de obra → deve perguntar pelo menos quais obras serão exibidas. Se o usuário der apenas títulos, sem detalhes → escreva você mesmo: para cada obra, gere 1 lead + 3 parágrafos de prosa + 6-8 linhas de specs + 3-6 imagens do picsum + alguns créditos. O tom deve combinar com o tipo de obra (livro → encadernação / letra → tipografia / objeto → natureza-morta / exposição → visual de exposição).

Dois Modos de Operação

Modo A · Claude Code / Local (com sistema de arquivos)

  • Use Bash para listar pastas, sips para obter largura/altura de cada imagem
  • Saída em: ~/Desktop/{slug}-portfolio.html (arquivo único, todas as imagens por URL)
  • Se o usuário forneceu imagens locais: copie para ~/Desktop/{slug}-portfolio-images/ e altere src para caminho relativo

Modo B · GLM / Chat Online (sem sistema de arquivos)

  • Após descompactar o zip enviado pelo usuário, você verá 4 arquivos
  • Retorne apenas uma string HTML completa, dentro de um bloco de código ```html
  • Se o usuário enviar imagens mas sem URL → use https://picsum.photos/id/{id}/{w}/{h} como placeholder (com IDs existentes)
  • Não tente acessar arquivos locais, não sugira comandos de terminal

Regra: se você não conseguir Ler imagens locais → assume Modo B.

Divisão de Arquivos

ArquivoFunçãoComo Usar
reference.htmlExemplo completo finalizado — BAIWU com 6 obrasVeja: redação dos itens da lista, tom da prosa, vocabulário das specs, densidade dos campos JSON
template.htmlEstrutura vazia — Mesmo sistema CSS/JS/routing, 2 exemplos + 20 marcas SWAPModifique-o para gerar o HTML final
README.mdInstruções de uso para o usuárioO modelo não precisa ler
SKILL.mdFluxo de trabalho para o modelo (este arquivo)Leitura obrigatória

Regra central: todas as alterações baseiam-se no template.html; aprenda como escrever do reference.html (tom, número de palavras, uso de tags), mas não copie o conteúdo específico.

Etapas de Trabalho

1. Leia os Dois HTMLs

  • Primeiro, leia reference.html para entender "como fica depois de pronto" (especialmente a densidade dos campos JSON em works-data e o tom da prosa)
  • Depois, leia template.html para encontrar os 20 pontos SWAP

Não altere JS / Não altere CSS / Não altere o sistema de roteamento da página de detalhe / Não altere a importação da fonte. Os SWAPs estão todos no texto HTML e nos dados JSON.

2. Analise a Entrada do Usuário e Extraia Informações

Extraia:

  • ATELIER_NAME_ZH — Nome do estúdio em chinês (2-4 caracteres ideal, e.g. "白屋", "素园", "墨记", "青庐", "拙轩")
  • PINYIN — Romanização (5-6 letras maiúsculas: BAIWU / SUYUAN / MOJI)
  • CHAR — Caractere único para o logotipo (geralmente o primeiro caractere do nome: 白 / 素 / 墨 / 青 / 拙)
  • CITY — Cidade
  • DIRECTOR_ZH / DIRECTOR_EN — Nome do diretor + romanização
  • DISCIPLINE — 3 palavras de disciplina ("Encadernação · Tipografia · Natureza-morta")
  • TAGLINE — Frase de posicionamento em uma linha (20-40 caracteres, tom de letra cursiva)
  • YEAR_FOUNDED — Ano de fundação (pode usar ciclo sexagenário: 乙未冬 / 甲辰春)

Para cada obra, extraia:

  • slug — ID da URL, em minúsculas com hífen (kong-shan-ji / wu-ming-shu)
  • title_zh — Título em chinês (2-5 caracteres ideal, quanto mais conciso, mais elegante)
  • title_en — Subtítulo em inglês (estilo de título de livro: An Anthology of Empty Mountains)
  • year — Ano ou ano do ciclo ("甲辰 / 2024" / "2025" / "乙巳 / 2025")
  • tag — Categoria no topo, entre colchetes, ex: [ 诗集 · 装帧设计 ] / [ 字体设计 · 中草药图谱 ]
  • cover — URL da imagem grande da página de detalhe
  • localização da linha na lista — "Cidade, Ano · Técnica/Especificação" (aparece ao passar o mouse)
  • meta — 4 pares chave-valor (resumo em 4 colunas na página de detalhe)
  • lead — Texto grande de abertura com 30-70 caracteres, pode usar <em>palavra-chave</em> para enfatizar um ponto
  • prose — 3-4 parágrafos de prosa, cada um com 80-150 caracteres
  • specs — 6-10 linhas de tabela de especificações (formato/papel/encadernação/tipografia/tiragem/impressão/técnica/preço etc.)
  • gallery — 3-6 imagens, layout com três opções: g-wide / g-half / g-third
  • credits — 4-7 pares de cargo/nome

Se o usuário der apenas uma frase / nenhuma história → invente: com base no título e tipo da obra, escreva lead e prosa que combinem com o tom da obra. Consulte o tom do reference.html — sem linguagem de marketing, com sensação de "texto de parede de museu + caderno de ateliê" (contido, concreto, lento, com marcas de artesanato).

3. Liste as Obras e Obtenha Dimensões (Apenas Modo A)

ls -la "{works_path}"
sips -g pixelWidth -g pixelHeight "{works_path}/{file}" 2>/dev/null

Obtenha (filename, w, h, aspect) de cada imagem. Priorize imagens verticais como miniaturas da lista (container 4:3, verticais ficam melhores).

4. Substitua os 20 SWAPs

SWAPLocalConteúdo
1<title>{ATELIER_NAME} {PINYIN} — Portfólio de {DIRECTOR} / Studio
2meta descriptionUma frase de descrição do site
3Caractere único da cortinaPrimeiro caractere do nome do estúdio (ex.: "白")
4Caractere único dentro do logotipo SVGMesmo que SWAP-3
5Romanização dentro do logotipo SVG{PINYIN} maiúsculo
6li do menu principalGeralmente 3 itens: Obras / Sobre / Contato
7Nome chinês do bloco de marca{ATELIER_NAME} com espaços entre caracteres (ex.: 白&nbsp;&nbsp;屋)
8Inglês do bloco de marca{PINYIN} Studio · {CITY}
9taglineFrase de posicionamento em letra cursiva, 20-40 caracteres, pode usar <br> para quebrar linha
10N itens da listaCada <a class="item" href="#work/{slug}"> contendo num/project-name/en-name/location/photo-thumb
11N itens da galeriaAs mesmas N obras, grade mais compacta — slug deve ser idêntico ao da lista
12Título "Sobre"关&nbsp;于&nbsp;{name}<span class="en">About</span>
13Parágrafos "Sobre"1-3 parágrafos em letra cursiva (história de fundação / diretor / filosofia de design), cada um com 60-120 caracteres
14Tabela de fatos "Sobre"4-6 itens li (Fundado/Local/Disciplina/Diretor/Horário)
15Título "Contato"来&nbsp;信<span class="en">Get in Touch</span>
16Parágrafos "Contato"1-2 parágrafos convidando a escrever + promessa de prazo de resposta
17Tabela de fatos "Contato"4-6 itens (E-mail/Telefone/Endereço/Instagram/WeChat Official Account)
18crédito rotativoSite by {WHO} (geralmente o nome do estúdio)
19Três blocos do rodapé© / ICP / Links sociais
20JSON works-dataDados completos de detalhes das N obras (crucial!)

5. Escreva o JSON works-data (Passo Mais Crucial)

Cada obra deve ter uma entrada no array JSON, o slug deve ser exatamente igual ao href #work/SLUG nos cards da lista/galeria.

Campos JSON:

{
  "slug": "kong-shan-ji",
  "title_zh": "空山集",
  "title_en": "An Anthology of Empty Mountains",
  "year": "甲辰 / 2024",
  "tag": "[ 诗集 · 装帧设计 ]",
  "cover": "https://picsum.photos/id/143/1800/1100",
  "meta": [
    {"label": "Type / 类型", "value": "诗集装帧"},
    {"label": "Year / 年份", "value": "2024"},
    {"label": "Edition / 印量", "value": "首印 320 本"},
    {"label": "Format / 开本", "value": "130 × 195 毫米"}
  ],
  "lead": "三十六首关于山的诗。我们想做一本——读者翻开后,先听见<em>风声</em>,再读见字的书。",
  "prose": [
    "Parágrafo 1: Origem dos poemas / contexto do design. 80—150 caracteres.",
    "Parágrafo 2: Decisões-chave durante a produção — tipografia, papel, escolha de encadernação.",
    "Parágrafo 3: Resultado final / sensação deixada ao leitor."
  ],
  "specs": [
    ["开本 / Format", "130 × 195 毫米"],
    ["页数 / Pages", "144 页"],
    ["纸张 / Paper", "本色棉纸 90gsm"],
    ["装订 / Binding", "线装四目"],
    ["字体 / Typeface", "老宋(标题)· 楷体(正文)"],
    ["印刷 / Printing", "单色凸印"],
    ["印量 / Edition", "首印 320 本"],
    ["定价 / Price", "¥ 388"]
  ],
  "gallery": [
    {"src": "...", "layout": "g-wide", "caption": "封面"},
    {"src": "...", "layout": "g-half"},
    {"src": "...", "layout": "g-half"},
    {"src": "...", "layout": "g-third"},
    {"src": "...", "layout": "g-third"},
    {"src": "...", "layout": "g-third"}
  ],
  "credits": [
    ["设计 / Design", "周墨白"],
    ["手工装订 / Binding", "陈漱石(杭州·订书坊)"]
  ]
}

Erros comuns em JSON ⚠️:

  • Na prosa em chinês, use aspas → deve usar 「...」 ou \"...\" (U+201C / U+201D) não use ASCII " (quebra o JSON)
  • Não coloque quebras de linha literais dentro das strings JSON; para mudar de parágrafo, adicione mais um item no array prose
  • <em>palavra</em> no lead é HTML literal — será renderizado como innerHTML
  • O layout da galeria deve ser um dos três: g-wide (ocupar toda a largura) / g-half (metade) / g-third (1/3)

6. Escolha da Fonte de Imagens

  • Placeholder picsum: use o formato id/X em vez de seed/X (mais estável). IDs bons conhecidos: 0, 20, 40, 51, 64, 76, 88, 91, 96, 119, 121, 130, 143, 145, 158, 164, 165, 175, 177, 180, 187, 195, 200
  • Para cover/galeria da mesma obra, use IDs próximos — isso cria um tom de cor consistente
  • Não use o parâmetro ?grayscale (o usuário espera imagens coloridas)

7. Inspiração para Nomes de Estúdio Chinês (se o usuário não der)

Se o usuário disser "invente um" → escolha 2 caracteres com estilo antigo:

  • Nomes de objetos: 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
  • Nomes de letras/linhas: 素白 / 子衿 / 砚池 / 半山 / 寻常 / 浮云
  • Evite palavras funcionais como "工作室 / design / Studio", deixe o próprio nome ser um poema

8. Suporte a Vídeo

Se o cover da obra for .mp4 / .webm / .mov, a página de detalhe usará automaticamente <video autoplay muted loop> em vez de <img>. O modelo só precisa fornecer o caminho do vídeo na URL do cover.

9. Relatório

Modo A: relatório de uma frase.

Gerado ~/Desktop/baiwu-portfolio.html — 6 obras, passe o mouse nas linhas para ver miniaturas, clique para entrar na página de detalhe. Light/Dark no canto inferior esquerdo, lista/álbum no topo centralizado.

Modo B: Dê diretamente o bloco de código HTML completo + uma linha de instrução.

Salve o conteúdo acima como index.html e clique duas vezes para abrir. Passe o mouse sobre qualquer nome de obra para ver a miniatura que aparece à direita, clique para ir à página de detalhe. Para trocar as imagens, substitua as URLs do picsum pelos endereços das suas imagens.

Itens Obrigatórios (Não Alterar)

  • Importação da fonte: @font-face carregando a URL woff2 do "Alimama DaoLiTi" (não mude a fonte)
  • Sistema de variáveis CSS: tema claro/escuro
  • Todo o JS: alternador de tema, alternador de modo de visualização, interação hover-row, crédito rotativo, roteamento hash da página de detalhe applyRoute(), renderDetail()
  • O nó <script id="works-data"> deve permanecer
  • O nó <main id="detail-root"> deve permanecer (ponto de montagem da página de detalhe)
  • Sistema de estado body[data-view="home/detail"] e body[data-mode="list/gallery"]
  • Cinco elementos de posicionamento fixo: #logo / #main-menu / .theme-toggle / #project-view / #svp-credit

Verificação Rápida de Erros Comuns

  • Slug incompatível: item da lista #work/kong-shan-ji ↔ item da galeria #work/kong-shan-ji ↔ JSON "slug": "kong-shan-ji" — três lugares devem ser exatamente iguais
  • Aspas no JSON: aspas no conteúdo chinês devem ser 「」 ou "...", não ASCII "
  • Galeria excessiva: no máximo 6 imagens por obra, mais que isso quebra o layout
  • Prosa muito longa: cada parágrafo com 80-150 caracteres, acima de 200 reduz a experiência de leitura
  • Lista/galeria dessincronizadas: devem conter o mesmo conjunto de obras (correspondência um a um)
  • Seed do picsum: use id/X não seed/X, para evitar que IDs aleatórios caiam em imagens removidas
  • Menos de 3 obras: pode, mínimo de 2 funciona
  • Mais de 8 obras: sugira dividir em dois lotes, muitas linhas na lista deixam a página longa
  • Primeira letra capitular: o .detail__prose p:first-of-type::first-letter na página de detalhe usa a fonte lishu — o primeiro parágrafo deve começar com chinês (não com <em> ou inglês)
  • Removeu cor do picsum: as imagens devem permanecer coloridas; não adicione filter: grayscale() no CSS

Individual skills in this repo

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

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

Route design-related HTML artifact tasks to the right artifact skill, reference, design system generation, or export skill.

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