Communitygithub.com

Monich — Gerador de Portfólio Chinês (Atelier / Lishu)

Gera um arquivo HTML único de portfólio de estúdio chinês (ateliê), com lista horizontal, hover para revelar thumbnail, tipografia artística Lishu via CDN, tema claro/escuro e páginas de detalhe com roteamento por hash.

O que é Lishu)?

Este skill cria um site de portfólio de único arquivo HTML para estúdios ou ateliês de estilo chinês, especialmente indicado para projetos de livros, tipografia, cerâmica, chá, madeira, papel, incenso e outras artes que exigem uma estética contida e elegante. O layout central é uma lista horizontal com nomes de obras que, ao passar o mouse, revelam uma miniatura no lado direito. Ao clicar, uma página de detalhes é carregada via roteamento por hash, com galeria, especificações técnicas e créditos. O design usa a fonte artística 'Alimama DaoLiTi' (estilo Lishu) carregada via CDN, suporta temas claro e escuro, e funciona em dois modos: no Claude Code (gera o arquivo na área de trabalho) ou em chats online como GLM (exibe o HTML inline). A partir de uma descrição em linguagem natural do estúdio (nome, diretor, especialidade, obras), o skill extrai informações e preenche um template com 20 pontos de substituição, gerando um site completo e visualmente impactante.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/WyvernCW/Monich/tree/HEAD/templates/web-template/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 em Lishu (com Páginas de Detalhe Secundárias)

Característica em uma frase

Linhas de texto horizontais + imagem grande que aparece ao passar o mouse no lado direito + letras artísticas grandes em Alimama DaoLiTi + preto e branco puro + light/dark + páginas de detalhe com roteamento hash + vista dupla de lista/álbum.

Diferenças entre os skills de portfólio

skillModo principalPara quem é
portfolio-genTela infinita de arrastar + blocos lado a ladoFotógrafos / Designers gráficos pendurando amostras
portfolio-museum-genCarrossel hero + cards grandes + fluxo em cascata + páginas de detalhe (curadoria de vídeo/imagem)Artistas de vídeo / instalação
industrial-archive-genCapa de virada com moldura preta + barra lateral de arquivo + nórdico industrialProdutos físicos / objetos / hardware
lishu-portfolio-genLinhas de texto horizontais + hover exibe miniatura à direita + letras grandes em Lishu + contido chinêsEncadernação / Tipografia / Artesanato / Estúdios chineses

Se o projeto do usuário for 'livro / fonte / exposição / natureza-morta / ervas chinesas / chá / cerâmica / madeira / papel / incenso' — algo que precise de uma elegância contida — use este skill.

Quando acionar

O usuário diz:

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

E fornece:

  • 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 → pergunte pelo menos quais obras serão exibidas. Se o usuário deu apenas títulos sem detalhes → crie você mesmo: para cada obra, gere 1 lead + 3 parágrafos em prosa + 6-8 linhas de especificações + 3-6 imagens picsum + alguns créditos. O tom deve combinar com o tipo da obra (livro → encadernação / fonte → tipografia / objeto → natureza-morta / exposição → visual da exposição).

Dois modos de execução

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

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

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

  • Quando o usuário arrasta um zip, ao descompactar você vê 4 arquivos
  • Gere apenas uma string HTML completa, dentro de um bloco de código ```html
  • Se o usuário enviou imagens mas não deu URLs → use todas https://picsum.photos/id/{id}/{w}/{h} como placeholder (use IDs que existem)
  • Não tente acessar arquivos locais, não sugira comandos de terminal

Critério: se você não consegue ler imagens locais → siga o Modo B.

Divisão dos arquivos

ArquivoFunçãoComo usar
reference.htmlExemplo completo final — Casa Branca BAIWU com 6 obrasVeja: tom dos itens da lista, tom da prosa, vocabulário das especificações, densidade dos campos JSON
template.htmlEsqueleto vazio — mesmo sistema CSS/JS/rotas, com 2 exemplos + 20 marcadores SWAPModifique a partir dele, gere o HTML final
README.mdInstruções para o usuárioO modelo não precisa ler
SKILL.mdFluxo de trabalho para o modelo (este arquivo)Leitura obrigatória

Regra principal: todas as alterações baseadas no template.html; aprenda como escrever com o reference.html (tom, número de palavras, vocabulário das tags), mas não copie o conteúdo específico.

Passos do trabalho

1. Leia os dois HTMLs

  • Primeiro leia reference.html para entender 'como fica completo' (especialmente a densidade dos campos do JSON 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 das páginas de detalhe / não altere a importação da fonte. Os SWAP 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 chinês do estúdio (ideal 2-4 caracteres, como '白屋', '素园', '墨记', '青庐', '拙轩')
  • PINYIN — Pinyin (5-6 letras maiúsculas: BAIWU / SUYUAN / MOJI)
  • CHAR — Caractere único para o logo (geralmente o primeiro caractere do nome do estúdio: 白 / 素 / 墨 / 青 / 拙)
  • CITY — Cidade
  • DIRECTOR_ZH / DIRECTOR_EN — Nome do diretor + pinyin
  • DISCIPLINE — 3 palavras da área ('Encadernação · Tipografia · Natureza-morta')
  • TAGLINE — Uma frase de posicionamento (20-40 caracteres, tom de escrita cursiva)
  • YEAR_FOUNDED — Ano de fundação (pode usar o ciclo sexagesimal: 乙未冬 / 甲辰春)

Para cada obra:

  • slug — ID da URL, letras minúsculas em inglês com hífen (kong-shan-ji / wu-ming-shu)
  • title_zh — Título em chinês (ideal 2-5 caracteres, 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 no ciclo sexagesimal (甲辰 / 2024 / 2025 / 乙巳 / 2025)
  • tag — Categoria no topo, entre colchetes, ex: [ 诗集 · 装帧设计 ] / [ 字体设计 · 中草药图谱 ]
  • cover — URL da imagem grande da página de detalhe
  • location da linha da lista — Cidade, ano · Processo/Especificações (aparece ao passar o mouse)
  • meta — 4 pares chave-valor (resumo em 4 colunas na página de detalhe)
  • lead — 30-70 caracteres de abertura em letras grandes, pode usar <em>palavra-chave</em> para destacar um ponto
  • prose — 3-4 parágrafos em prosa, cada um com 80-150 caracteres
  • specs — 6-10 linhas de tabela de especificações (formato/papel/encadernação/fonte/tiragem/impressão/processo/preço, etc.)
  • gallery — 3-6 imagens, layout de três opções: g-wide / g-half / g-third
  • credits — 4-7 pares de cargo/nome

Se o usuário deu apenas uma frase / não deu histórias → invente você mesmo: de acordo com o título e tipo da obra, escreva um lead e prosa que combinem com o tom. Consulte o reference.html para o tom — nada de linguagem de marketing, algo como 'texto de parede de museu + caderno de estúdio' (contido, específico, lento, com vestígios de artesanato).

3. Liste as obras e verifique tamanhos (apenas Modo A)

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

Obtenha (filename, w, h, aspect) para cada imagem. Priorize imagens verticais como thumbnail da lista (contêiner 4:3, imagens verticais ficam melhores).

4. Substitua os 20 SWAP

SWAPLocalizaçãoConteúdo
1<title>{ATELIER_NAME} {PINYIN} — Portfolio {DIRECTOR} / Studio
2meta descriptionUma frase de descrição do site
3caractere da cortinaPrimeiro caractere do nome do estúdio (ex: '白')
4caractere dentro do SVG do logoMesmo SWAP-3
5pinyin dentro do SVG do logo{PINYIN} maiúsculo
6item de navegação principal liGeralmente 3 itens: Obras / Sobre / Contato
7brand-block nome chinês{ATELIER_NAME} com espaços entre caracteres (ex: 白&nbsp;&nbsp;屋)
8brand-block inglês{PINYIN} Studio · {CITY}
9taglineUma frase de posicionamento em estilo cursivo, 20-40 caracteres, pode usar <br> para quebra de linha
10Itens da lista NCada um <a class="item" href="#work/{slug}"> contendo num/project-name/en-name/location/photo-thumb
11Itens da galeria NMesmas N obras, grade mais compacta — slug deve ser igual ao da lista
12Título Sobre关&nbsp;于&nbsp;{name}<span class="en">About</span>
13Parágrafos Sobre1-3 parágrafos em estilo cursivo (contexto de fundação / diretor / visão de design), cada um com 60-120 caracteres
14Tabela de fatos Sobre4-6 itens li (Fundada/Localização/Disciplina/Diretor/Horário)
15Título Contato来&nbsp;信<span class="en">Get in Touch</span>
16Parágrafos Contato1-2 parágrafos convidando a escrever + compromisso de prazo de resposta
17Tabela de fatos Contato4-6 itens (E-mail/Telefone/Endereço/Instagram/WeChat)
18rotating creditSite by {QUEM} (geralmente o nome do estúdio)
19Rodapé três blocos© / ICP / Links sociais
20JSON works-dataDados completos de N obras (crucial!)

5. Escreva o JSON works-data (passo mais importante)

Cada obra deve ter uma entrada no array JSON, o slug deve ser exatamente igual ao href #work/SLUG dos 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": "Tipo / 类型", "value": "Encadernação de Poesia"},
    {"label": "Ano / 年份", "value": "2024"},
    {"label": "Tiragem / 印量", "value": "Primeira tiragem 320 exemplares"},
    {"label": "Formato / 开本", "value": "130 × 195 mm"}
  ],
  "lead": "Trinta e seis poemas sobre montanhas. Queríamos fazer um livro que, ao ser aberto, o leitor ouvisse primeiro o <em>som do vento</em>, e depois lesse as palavras.",
  "prose": [
    "Parágrafo um: origem dos poemas / contexto do design. 80—150 caracteres.",
    "Parágrafo dois: decisões-chave na produção — escolha da fonte, papel, encadernação.",
    "Parágrafo três: apresentação final / sensação deixada para o leitor."
  ],
  "specs": [
    ["Formato / Format", "130 × 195 mm"],
    ["Páginas / Pages", "144 páginas"],
    ["Papel / Paper", "Papel de algodão natural 90gsm"],
    ["Encadernação / Binding", "Costura quatro furos"],
    ["Fonte / Typeface", "Song Antiga (título) · Cursiva (corpo)"],
    ["Impressão / Printing", "Relevo monocromático"],
    ["Tiragem / Edition", "Primeira tiragem 320 exemplares"],
    ["Preço / Price", "¥ 388"]
  ],
  "gallery": [
    {"src": "...", "layout": "g-wide", "caption": "Capa"},
    {"src": "...", "layout": "g-half"},
    {"src": "...", "layout": "g-half"},
    {"src": "...", "layout": "g-third"},
    {"src": "...", "layout": "g-third"},
    {"src": "...", "layout": "g-third"}
  ],
  "credits": [
    ["Design / Design", "Zhou Moba"],
    ["Encadernação Manual / Binding", "Chen Shushi (Hangzhou · Oficina de Livros)"]
  ]
}

Erros comuns no JSON ⚠️ :

  • No texto chinês da prosa, use aspas → use sempre aspas cheias 「...」 ou "..." (U+201C / U+201D), não use ASCII " (quebra o JSON)
  • Não coloque quebras de linha literais em strings JSON; para separar parágrafos, adicione mais um item no array prose
  • Tags <em>palavra</em> no lead escreva diretamente como HTML — na renderização, será interpretado como innerHTML
  • O layout da galeria deve ser um dos três: g-wide (ocupa todo o espaço) / g-half (ocupa metade) / g-third (ocupa 1/3)

6. Escolha da fonte de imagens

  • Placeholder picsum: use a forma 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
  • Use IDs próximos para cover / galeria da mesma obra, criando um tom de cor consistente
  • Não use o parâmetro ?grayscale (o usuário quer imagens coloridas)

7. Inspiração para nomes de estúdios chineses (se o usuário não der)

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

  • Nomes de objetos: 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
  • Nomes de caracteres de caligrafia: 素白 / 子衿 / 砚池 / 半山 / 寻常 / 浮云
  • Evite palavras funcionais como "工作室 / 设计 / Studio", deixe o nome ser um poema em si

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> no lugar de <img>. O modelo só precisa colocar o caminho do vídeo na URL do cover.

9. Relatório

Modo A: Uma frase de relatório.

Gerado ~/Desktop/baiwu-portfolio.html — 6 obras, passe o mouse sobre as 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 código acima como index.html e clique duas vezes para abrir. Passe o mouse sobre qualquer nome de obra para ver a miniatura aparecer à direita, clique para ir à página de detalhe. Para trocar imagens, substitua a URL picsum pela URL da sua imagem.

Obrigatório manter (não alterar)

  • Importação da fonte: @font-face carregando a URL woff2 da Alimama DaoLiTi (não mude a origem da fonte)
  • Sistema de variáveis CSS: temas light/dark duplos
  • Todo o JS: alternância de tema, alternância de modo de visualização, interação de hover nas linhas, rotating credit, roteamento hash da página de detalhe applyRoute(), renderDetail()
  • O nó <script id="works-data"> deve permanecer
  • <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 posição fixa: #logo / #main-menu / .theme-toggle / #project-view / #svp-credit

Verificação rápida de erros

  • Slug não corresponde: 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: as aspas no texto chinês devem ser sempre cheias 「」 ou "...", nunca ASCII "
  • Galeria grande demais: no máximo 6 imagens por obra, acima disso a formatação quebra
  • Prosa longa demais: cada parágrafo 80-150 caracteres, acima de 200 caracteres a experiência de leitura piora
  • Lista / galeria fora de sincronia: devem conter exatamente as mesmas obras (correspondência um a um)
  • Picsum seed: use id/X, não seed/X, para evitar que IDs aleatórios acessem imagens já removidas
  • Menos de 3 obras: tudo bem, funciona com no mínimo 2
  • Mais de 8 obras: sugira dividir em duas levas, muitas linhas de lista deixam a página muito longa
  • Primeira letra grande: na página de detalhe, .detail__prose p:first-of-type::first-letter usa a fonte DaoLiTi — o primeiro parágrafo deve começar com caracteres chineses (não comece com <em> ou inglês)
  • Removeu o colorido das picsum: as imagens devem permanecer coloridas, não adicione filter: grayscale() no CSS

Individual skills in this repo

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

Habilidades Relacionadas