Communitygithub.com

lishu-portfolio-gen — Portfolio de Studio Chinois / Style Ateli…

Génère un site vitrine de studio chinois, élégant et sobre, au format HTML unique : lignes horizontales de texte + image qui apparaît au survol, typographie calligraphique « Alimama DaoLiTi » chargée via CDN, thème clair/sombre, pages de détail avec routage par hash.

Qu'est-ce que Style Ateli… ?

Cette compétence (skill) crée un site web portfolio complet, sobre et élégant, typique d'un atelier d'art chinois, sous la forme d'un seul fichier HTML. Elle est idéale pour les studios de design graphique, de reliure, de calligraphie, de céramique ou de thé. Le site utilise une mise en page horizontale : les titres des projets défilent en lignes, et le survol d'un titre révèle une vignette correspondante sur le côté droit. La typographie est mise en valeur par la police « Alimama DaoLiTi » (style lishu, une écriture chinoise ancienne) chargée via CDN, et l'interface bascule entre un thème clair et un thème sombre. Chaque projet dispose d'une page de détail complète accessible via un hashtag dans l'URL, avec galerie d'images, description détaillée, spécifications techniques et crédits. La compétence fonctionne de deux manières : soit dans Claude Code (écrit le fichier sur le bureau), soit dans des chats en ligne comme GLM (renvoie le code HTML inline). Elle est déclenchée par des phrases spécifiques en chinois comme « 做个中式工作室作品集 » (Créer un portfolio de studio chinois) ou « 做个隶书作品集 » (Créer un portfolio en style lishu). Elle prend en entrée une description naturelle du studio (nom, directeur, discipline, œuvres) et produit un fichier HTML fonctionnel en remplaçant 20 marqueurs SWAP dans un template prédéfini.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ansaribilal14/design-showcase/tree/HEAD/skills/design/design-templates/portfolio-detail

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

portfolio-detail — Studio chinois / Portfolio en style lishu (avec pages de détail secondaires)

En une phrase

Lignes de texte horizontales + survol révélant une grande image à droite + grands caractères artistiques « Alimama DaoLiTi » + couleurs noir et blanc + thème clair/sombre + pages de détail avec routage hash + double vue liste/album.

Différences avec les autres compétences de portfolio

CompétenceMode principalPour qui
portfolio-genToile à défilement infini + tuilesPhotographes / graphistes exposant des échantillons
portfolio-museum-genCarrousel héroïque + grandes cartes + défilement en cascade + pages de détail (ambiance curatrice d'images)Artistes vidéo / image / installation
industrial-archive-genCouverture à retournement en cadre noir + archive latérale + industriel nordiqueProduits physiques / objets / matériel
lishu-portfolio-genLignes de texte horizontales + vignette au survol + grands caractères lishu + retenue chinoiseReliure / Typographie / Artisanat / Studio chinois

Si le projet de l'utilisateur concerne « le livre / la typographie / l'exposition / la nature morte / la médecine chinoise / le thé / la poterie / le bois / le papier / l'encens » — utilisez cette compétence.

Quand déclencher

L'utilisateur dit :

  • « Crée un portfolio de style chinois / oriental / classique »
  • « Crée un site web de studio / page d'accueil en style lishu »
  • « Crée un portfolio de style maison blanche » / « Crée un site à liste horizontale comme Gurgel D'Alfonso »
  • « lishu-portfolio-gen ... »

Et fournit :

  • Description du studio (obligatoire) : nom, directeur, ville, discipline, titres et histoires des œuvres
  • Images des œuvres (optionnel) : URL / téléchargement / chemin. Fonctionne même sans (utilise picsum comme placeholder)

Si l'utilisateur n'a donné aucun titre d'œuvre → demandez au moins quelles sont les œuvres à exposer. Si l'utilisateur a donné seulement les titres sans détails → écrivez vous-même : pour chaque œuvre, générez 1 phrase d'accroche + 3 paragraphes en prose + 6-8 lignes de spécifications + 3-6 images picsum + plusieurs crédits. Le ton doit correspondre au type d'œuvre (livre → reliure, caractère → typographie, objet → nature morte, exposition → visuel d'exposition).

Deux modes de fonctionnement

Mode A · Claude Code / Local (avec système de fichiers)

  • Utilisez Bash pour lister les dossiers, sips pour obtenir les dimensions de chaque image
  • Emplacement de sortie : ~/Desktop/{slug}-portfolio.html (fichier unique, toutes les images sont en URL)
  • Si l'utilisateur donne des images locales : copiez-les dans ~/Desktop/{slug}-portfolio-images/ et modifiez les src en chemins relatifs

Mode B · GLM / Chat en ligne (sans système de fichiers)

  • L'utilisateur télécharge un zip ; après décompression, 4 fichiers sont visibles
  • Sortie uniquement une chaîne HTML complète, encapsulée dans un bloc ```html
  • Si l'utilisateur télécharge une image sans URL → utilisez https://picsum.photos/id/{id}/{w}/{h} comme placeholder (utilisez des ID connus)
  • N'essayez pas d'accéder aux fichiers locaux, ne suggérez pas de commandes en ligne de commande

Jugement : si vous ne pouvez pas Read pour voir les images locales → utilisez le mode B par défaut.

Répartition des fichiers

FichierRôleComment l'utiliser
reference.htmlRéférence complète du produit fini — BAIWU 6 œuvresÉtudiez : le ton des éléments de liste, le style de la prose, le vocabulaire des spécifications, la densité des champs JSON
template.htmlStructure vide — Mêmes CSS/JS/système de routage, 2 exemples + 20 marqueurs SWAPModifiez-le pour produire le HTML final
README.mdInstructions d'utilisation pour l'utilisateurLe modèle n'a pas besoin de le lire
SKILL.mdFlux de travail pour le modèle (ce fichier)À lire impérativement

Règle fondamentale : toutes les modifications sont basées sur template.html ; apprenez comment écrire à partir de reference.html (ton, longueur des mots, utilisation des balises), mais ne copiez pas le contenu spécifique.

Étapes de travail

1. Lire les deux HTML

  • Lisez d'abord reference.html pour comprendre « à quoi cela ressemble une fois terminé » (en particulier la densité des champs du JSON works-data et le ton de la prose)
  • Lisez ensuite template.html pour trouver les 20 positions SWAP

Ne modifiez pas le JS / ne modifiez pas le CSS / ne modifiez pas le système de routage des pages de détail / ne modifiez pas l'importation de la police. Les SWAP se trouvent uniquement dans le texte HTML et les données JSON.

2. Analyser l'entrée utilisateur pour extraire les informations

Extrayez :

  • ATELIER_NAME_ZH — Nom chinois du studio (2-4 caractères idéalement, par exemple « 白屋 », « 素园 », « 墨记 », « 青庐 », « 拙轩 »)
  • PINYIN — Pinyin (5-6 lettres anglaises, tout en majuscules : BAIWU / SUYUAN / MOJI)
  • CHAR — Caractère unique pour le logo (généralement le premier caractère du nom du studio : 白 / 素 / 墨 / 青 / 拙)
  • CITY — Ville
  • DIRECTOR_ZH / DIRECTOR_EN — Nom du directeur + pinyin
  • DISCIPLINE — 3 mots de discipline (« 装帧 · 字体 · 静物 »)
  • TAGLINE — Une phrase de positionnement (20-40 caractères, style calligraphique)
  • YEAR_FOUNDED — Année de fondation (peut utiliser les tiges célestes : 乙未冬 / 甲辰春)

Pour chaque œuvre, extrayez :

  • slug — ID d'URL, en minuscules avec traits d'union (kong-shan-ji / wu-ming-shu)
  • title_zh — Titre chinois (2-5 caractères idéalement, plus concis, plus de style)
  • title_en — Sous-titre anglais (style guillemets : An Anthology of Empty Mountains)
  • year — Année ou année des tiges célestes (甲辰 / 2024 / 2025 / 乙巳 / 2025)
  • tag — Catégorie en haut, entre crochets, par exemple [ 诗集 · 装帧设计 ] / [ 字体设计 · 中草药图谱 ]
  • cover — URL de la grande image de la page de détail
  • location de la ligne de liste — Ville, année · Technique/Spécifications (apparaît au survol)
  • meta — 4 paires clé-valeur (résumé en 4 colonnes de la page de détail)
  • lead — 30-70 caractères, phrase d'accroche en grands caractères ; peut utiliser <em>mot-clé</em> pour mettre en valeur un point
  • prose — 3-4 paragraphes en prose, chaque paragraphe 80-150 mots
  • specs — 6-10 lignes de tableau de spécifications (format/papier/reliure/typographie/tirage/impression/technique/prix, etc.)
  • gallery — 3-6 images, layout au choix parmi trois : g-wide / g-half / g-third
  • credits — 4-7 paires rôle/nom

Si l'utilisateur ne donne qu'une phrase/pas d'histoire → inventez : en fonction du titre et du type de l'œuvre, écrivez un lead et une prose qui correspondent au ton. Le ton doit être celui de reference.html — pas de langage marketing, mais une sensation de « texte mural de musée + carnet d'atelier » (retenu, concret, lent, avec des traces de travail manuel).

3. Lister les œuvres + obtenir les dimensions (Mode A uniquement)

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

Obtenez pour chaque image (filename, w, h, aspect). Privilégiez les images portrait comme vignettes de liste (conteneur 4:3, le portrait rend mieux).

4. Remplacer les 20 SWAP

SWAPEmplacementContenu
1<title>{ATELIER_NAME} {PINYIN} — {DIRECTOR}作品集 / Studio
2meta descriptionUne phrase de description du site
3Caractère du rideauPremier caractère du nom du studio (ex. « 白 »)
4Caractère dans le logo SVGIdentique à SWAP-3
5Pinyin dans le logo SVG{PINYIN} en majuscules
6Navigation principale liGénéralement 3 éléments : Œuvres / À propos / Contact
7Nom chinois du brand-block{ATELIER_NAME} avec espaces entre les caractères (ex. 白&nbsp;&nbsp;屋)
8Anglais du brand-block{PINYIN} Studio · {CITY}
9TaglineUne phrase de positionnement en style calligraphique, 20-40 caractères, peut utiliser <br> pour les sauts de ligne
10Éléments de liste NChaque <a class="item" href="#work/{slug}"> contient num/project-name/en-name/location/photo-thumb
11Éléments de galerie NLes mêmes N œuvres, grille plus compacte — le slug doit correspondre à celui de la liste
12Titre À propos关&nbsp;于&nbsp;{name}<span class="en">About</span>
13Paragraphes À propos1-3 paragraphes en style calligraphique (contexte de fondation / directeur / philosophie de design), chaque paragraphe 60-120 mots
14Tableau de faits À propos4-6 éléments li (Founded/Location/Discipline/Director/Hours)
15Titre Contact来&nbsp;信<span class="en">Get in Touch</span>
16Paragraphes Contact1-2 paragraphes invitant à écrire + délai de réponse
17Tableau de faits Contact4-6 éléments (E-mail/Phone/Address/Instagram/公众号)
18Crédit rotatifSite by {WHO} (généralement le nom du studio)
19Footer trois blocs© / ICP / Liens sociaux
20JSON works-dataDonnées complètes des N œuvres (essentiel !)

5. Écrire le JSON works-data (l'étape la plus cruciale)

Chaque œuvre doit avoir une entrée dans le tableau JSON, le slug doit correspondre exactement à celui de l'attribut href dans les cartes liste/galerie (#work/SLUG).

Champs 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": [
    "段落一:诗稿来源 / 设计语境。80—150 字。",
    "段落二:制作中的关键决定 — 字体、纸张、装订选择。",
    "段落三:最后呈现 / 留给读者的感受。"
  ],
  "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", "陈漱石(杭州·订书坊)"]
  ]
}

Erreurs courantes JSON ⚠️ :

  • Dans la prose chinoise, utilisez les guillemets pleine largeur 「...」 ou "..." (U+201C / U+201D), pas les guillemets ASCII " (cela briserait le JSON)
  • N'écrivez pas de vraies nouvelles lignes dans les chaînes JSON ; pour les paragraphes, ajoutez simplement un élément supplémentaire dans le tableau prose
  • Les balises <em>mot</em> dans le lead s'écrivent directement en HTML — le rendu se fait via innerHTML
  • Le layout de la galerie doit être choisi parmi trois : g-wide (pleine largeur) / g-half (moitié) / g-third (1/3)

6. Sélection de la source des images

  • Placeholder picsum : utilisez la forme id/X plutôt que seed/X (plus stable). ID connus et fiables : 0, 20, 40, 51, 64, 76, 88, 91, 96, 119, 121, 130, 143, 145, 158, 164, 165, 175, 177, 180, 187, 195, 200
  • Pour le cover / la galerie d'une même œuvre, utilisez des ID adjacents pour créer une palette de couleurs cohérente
  • N'utilisez pas le paramètre ?grayscale (les utilisateurs souhaitent des images en couleur)

7. Inspirations pour les noms de studios chinois (si l'utilisateur n'en donne pas)

Si l'utilisateur vous dit « inventez-en un » → choisissez 2 caractères, style ancien :

  • Types d'objets : 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
  • Types de lignes : 素白 / 子衿 / 砚池 / 半山 / 寻常 / 浮云
  • Évitez les mots fonctionnels comme « 工作室 / 设计 / Studio », que le nom soit lui-même un poème

8. Prise en charge des vidéos

Si le cover d'une œuvre est en .mp4 / .webm / .mov, la page de détail utilisera automatiquement <video autoplay muted loop> au lieu de <img>. Le modèle n'a qu'à fournir le chemin vidéo dans l'URL du cover.

9. Rapport

Mode A : Rapport en une phrase.

Fichier généré : ~/Desktop/baiwu-portfolio.html — 6 œuvres, survol des lignes pour voir les vignettes, clic pour accéder aux pages de détail. Light/Dark en bas à gauche, liste/album en haut centré.

Mode B : Donnez directement le bloc de code HTML complet + une ligne d'explication.

Enregistrez le code ci-dessus sous index.html et double-cliquez pour l'ouvrir. Survolez n'importe quel nom d'œuvre pour voir la vignette apparaître à droite, cliquez pour accéder à la page de détail. Pour changer les images, remplacez les URL picsum par vos adresses.

Éléments obligatoires (ne pas modifier)

  • Importation de la police : chargement du woff2 de Alimama DaoLiTi via @font-face (ne changez pas la source de la police)
  • Système de variables CSS : double thème clair/sombre
  • Tout le JS : bascule de thème, bascule de mode d'affichage, interaction hover-row, crédit rotatif, routage hash de la page de détail applyRoute(), renderDetail()
  • Le nœud <script id="works-data"> doit être conservé
  • <main id="detail-root"> doit être conservé (point de montage de la page de détail)
  • Système d'état body[data-view="home/detail"] et body[data-mode="list/gallery"]
  • Les cinq éléments à positionnement fixe : #logo / #main-menu / .theme-toggle / #project-view / #svp-credit

Vérification rapide des erreurs courantes

  • Slug non correspondant : élément de liste #work/kong-shan-ji ↔ élément de galerie #work/kong-shan-ji ↔ JSON "slug": "kong-shan-ji" — les trois doivent être identiques
  • Guillemets JSON : les guillemets dans le contenu chinois doivent être en pleine largeur « » ou "...", pas ASCII "
  • Trop de galerie : maximum 6 images par œuvre, au-delà la mise en page se dégrade
  • Prose trop longue : chaque paragraphe 80-150 mots, au-delà de 200 mots l'expérience de lecture se dégrade
  • Liste / Galerie désynchronisées : elles doivent contenir le même ensemble d'œuvres (correspondance une à une)
  • Seed picsum : utilisez id/X pas seed/X pour éviter qu'un ID aléatoire ne tombe sur une image supprimée
  • Œuvres < 3 : possible, minimum 2 œuvres pour que cela fonctionne
  • Œuvres > 8 : recommandez de les diviser en deux lots, trop de lignes de liste allongent la page
  • Premier caractère en retrait : le .detail__prose p:first-of-type::first-letter de la page de détail utilise la police DaoLiTi — le premier paragraphe doit commencer par du chinois (pas par <em> ni par de l'anglais)
  • Suppression de la couleur des picsum : les images doivent rester en couleur, n'ajoutez pas filter: grayscale() en CSS

Individual skills in this repo

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

Skills associés