Communitygithub.com

WyvernCW/Monich — Générateur de Portfolio Atelier Chinois

Génère un fichier HTML unique pour un portfolio d'atelier chinois (liste horizontale + interaction hover, typographie lishu via CDN, thème clair/sombre, pages détaillées avec routage par hash). Accepte une description en langage naturel du studio et produit un seul fichier .html fonctionnel.

Qu'est-ce que Monich — Générateur de Portfolio Atelier Chinois ?

Ce skill permet de générer un portfolio web complet pour un atelier (studio) chinois, en un seul fichier HTML. Il est idéal pour les designers, typographes, artisans, ou artistes souhaitant une présentation élégante et sobre. Le résultat affiche une liste horizontale de noms de projets ; au survol (hover) d'un nom, une vignette apparaît sur la droite. Chaque projet dispose d'une page détaillée accessible via un lien hash (#work/slug), avec galerie d'images, description, spécifications techniques, et crédits. Le skill intègre la police Alimama DaoLiTi (lishu) via CDN pour les titres, et gère les thèmes clair/sombre. Fonctionne en deux modes : A (Claude Code avec système de fichiers — écrit le fichier sur le bureau) et B (chat en ligne — produit directement le code HTML dans la conversation). Le skill inclut un template structuré (template.html) avec 20 points de substitution (SWAP) à remplir, et un exemple complet de référence (reference.html) pour guider le style rédactionnel. Les images manquantes sont automatiquement remplacées par des placeholders picsum.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/WyvernCW/Monich/tree/HEAD/templates/web-template/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 — Atelier chinois / Portfolio Lishu (avec page de détail secondaire)

En une phrase

Lignes de texte horizontales + survol faisant apparaître une grande image à droite + caractères artistiques Alimama DaoLiTi + couleurs noir et blanc purs + thème clair/sombre + pages de détail par hash + double vue liste/album.

Différences avec les autres skills de portfolio

skillMode principalPour qui
portfolio-genToile à glisser-déposer infinie + tuilesPhotographes / Graphistes montrant des échantillons
portfolio-museum-genCarrousel héroïque + grandes cartes + flux en cascade + pages détaillées (sens cinématographique)Artistes vidéo / image / installation
industrial-archive-genCouverture à pages noires + archive latérale + design nordique/industrielProduits physiques / objets / hardware
lishu-portfolio-genLignes de texte horizontales + survol affichant une vignette à droite + caractères lishu + sobriété chinoiseReliure / Typographie / Artisanat / Atelier chinois

Si le projet de l'utilisateur concerne « livres / typographie / expositions / natures mortes / herbes médicinales / thé / poterie / bois / papier / encens » — utilisez celui-ci.

Quand déclencher

L'utilisateur dit :

  • « Fais-moi un portfolio de style chinois / oriental / classique »
  • « Fais-moi un site de style lishu / page d'accueil de studio »
  • « Fais-moi un portfolio style maison blanche » / « Fais-moi 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 ne donne aucun titre d'œuvre → demander au moins quelles œuvres doivent être présentées. Si l'utilisateur donne seulement les titres sans détails → les écrire soi-même : pour chaque œuvre, générer 1 phrase d'accroche (lead) + 3 paragraphes en prose + 6-8 lignes de spécifications + 3-6 images picsum + quelques 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 via URL)
  • Si l'utilisateur donne des images locales : copiez-les dans ~/Desktop/{slug}-portfolio-images/ et modifiez src en chemin relatif

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

  • L'utilisateur télécharge un zip ; après décompression, vous voyez 4 fichiers
  • Sortie uniquement la chaîne HTML complète, dans un bloc de code ```html
  • Si l'utilisateur télécharge des images sans donner d'URL → utilisez https://picsum.photos/id/{id}/{w}/{h} comme placeholder (avec des IDs existants connus)
  • N'essayez pas d'accéder aux fichiers locaux, ne suggérez pas d'opérations en ligne de commande

Règle : si vous ne pouvez pas lire les images locales → par défaut, mode B.

Répartition des fichiers

FichierRôleComment l'utiliser
reference.htmlExemple complet terminé — BAIWU 6 œuvresVoir : formulation des items de liste, ton de la prose, vocabulaire des specs, densité des champs JSON
template.htmlSquelette vide — même système CSS/JS/routage, 2 exemples + 20 marqueurs SWAPModifiez-le, sortie du HTML final
README.mdInstructions pour l'utilisateurLe modèle n'a pas besoin de le voir
SKILL.mdWorkflow pour le modèle (ce fichier)À lire

Règle principale : toutes les modifications se basent sur template.html ; apprenez de reference.html comment écrire (ton, nombre de mots, choix de tags), mais ne copiez pas le contenu spécifique.

Étapes de travail

1. Lire les deux fichiers HTML

  • Lisez d'abord reference.html pour comprendre « à quoi ça ressemble quand c'est fini » (en particulier la densité des champs 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'import de la police. Les SWAP se trouvent dans le texte HTML et les données JSON.

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

Extrayez :

  • ATELIER_NAME_ZH — Nom chinois du studio (2-4 caractères idéalement, ex. « 白屋 », « 素园 », « 墨记 », « 青庐 », « 拙轩 »)
  • 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 : 白 / 素 / 墨 / 青 / 拙)
  • CITY — Ville
  • DIRECTOR_ZH / DIRECTOR_EN — Nom du directeur + pinyin
  • DISCIPLINE — 3 mots de discipline (« 装帧 · 字体 · 静物 »)
  • TAGLINE — Phrase de positionnement (20-40 caractères, style calligraphique kaiti)
  • YEAR_FOUNDED — Année de fondation (peut être en tige terrestre/ branche céleste : 乙未冬 / 甲辰春)

Pour chaque œuvre, extrayez :

  • slug — ID d'URL, en minuscules avec traits d'union (ex. kong-shan-ji, wu-ming-shu)
  • title_zh — Titre chinois (2-5 caractères idéalement, plus c'est concis, plus c'est stylé)
  • title_en — Sous-titre anglais (style titre de livre : An Anthology of Empty Mountains)
  • year — Année ou année cyclique (甲辰 / 2024 / 2025 / 乙巳 / 2025)
  • tag — Catégorie en haut, entre crochets, ex. [ 诗集 · 装帧设计 ] / [ 字体设计 · 中草药图谱 ]
  • cover — URL de la grande image de la page de détail
  • list row location — 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 d'accroche, peut utiliser <em>mot-clé</em> pour mettre en valeur
  • prose — 3-4 paragraphes en prose, 80-150 caractères chacun
  • specs — 6-10 lignes de tableau de spécifications (format/papier/reliure/police/tirage/impression/technique/prix, etc.)
  • gallery — 3-6 images, layout au choix parmi : g-wide / g-half / g-third
  • credits — 4-7 paires de rôle/nom

Si l'utilisateur donne seulement une phrase / pas d'histoire → inventez : en fonction du titre et du type de l'œuvre, écrivez un lead et une prose en cohérence avec le ton de l'œuvre. Inspirez-vous de reference.html — pas de langage marketing, mais un style « texte de musée + carnet d'atelier » (sobre, concret, lent, avec une touche artisanale).

3. Lister les œuvres et vérifier les dimensions (mode A uniquement)

```bash 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 verticales pour les vignettes de liste (conteneur 4:3, les verticales sont plus flatteuses).

4. Remplacer les 20 SWAP

SWAPEmplacementContenu
1<title>{ATELIER_NAME} {PINYIN} — Portfolio de {DIRECTOR} / Studio
2meta descriptionUne phrase de description du site
3Curtain (rideau) caractère uniquePremier caractère du nom du studio (ex. « 白 »)
4Logo SVG caractère uniqueIdentique au SWAP-3
5Logo SVG pinyin{PINYIN} en majuscules
6Navigation principale liGénéralement 3 éléments : Œuvres / À propos / Contact
7brand-block nom chinois{ATELIER_NAME} avec espacement (ex. 白&nbsp;&nbsp;屋)
8brand-block anglais{PINYIN} Studio · {CITY}
9taglineUne phrase de positionnement en style calligraphique, 20-40 caractères, peut utiliser <br> pour sauter une ligne
10N éléments de listeChaque <a class="item" href="#work/{slug}"> contenant num/project-name/en-name/location/photo-thumb
11N éléments de galerieLes 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 création / directeur / vision du design), 60-120 caractères chacun
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 + promesse de délai de réponse
17Tableau de faits Contact4-6 éléments (E-mail/Phone/Address/Instagram/公众号)
18Crédit tournantSite 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 (étape la plus critique)

Chaque œuvre doit avoir une entrée dans le tableau JSON, le slug doit correspondre exactement au #work/SLUG dans les href des cartes liste/galerie.

Champs JSON : ```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": "三十六首关于山的诗。我们想做一本——读者翻开后,先听见风声,再读见字的书。", "prose": [ "Paragraphe un : source des poèmes / contexte du design. 80—150 caractères.", "Paragraphe deux : décisions clés pendant la fabrication — police, papier, choix de reliure.", "Paragraphe trois : résultat final / sentiment laissé au lecteur." ], "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 JSON fréquentes ⚠️ :

  • Dans la prose chinoise, utilisez des guillemets → doivent être des guillemets pleine largeur 「...」 ou "..." (U+201C / U+201D), pas de guillemets ASCII " (cela casserait le JSON)
  • N'écrivez pas de retours à la ligne réels dans les chaînes JSON ; pour changer de paragraphe, ajoutez un élément supplémentaire dans le tableau prose
  • <em>mot</em> dans le lead écrit directement la balise HTML — lors du rendu, il est traité en innerHTML
  • Le layout de gallery doit être choisi parmi les trois : g-wide (pleine largeur) / g-half (demi-largeur) / g-third (tiers)

6. Choix des sources d'images

  • Placeholder picsum : utilisez la forme id/X plutôt que seed/X (plus stable). IDs 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/gallery d'une même œuvre, utilisez des IDs adjacents pour créer une tonalité de couleur cohérente
  • N'utilisez pas le paramètre ?grayscale (l'utilisateur souhaite des images en couleur)

7. Inspirations pour nommer un studio chinois (si l'utilisateur n'en donne pas)

Si l'utilisateur vous demande de "trouver un nom" → choisissez 2 caractères + style ancien :

  • Catégorie objets : 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
  • Catégorie mots : 素白 / 子衿 / 砚池 / 半山 / 寻常 / 浮云
  • Évitez les mots fonctionnels comme « 工作室 / 设计 / Studio », le nom doit déjà être un poème.

8. Support vidéo

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

9. Rapport

Mode A : Rapport en une phrase.

Généré ~/Desktop/baiwu-portfolio.html — 6 œuvres, survolez les lignes pour voir les vignettes, cliquez pour accéder à la page de détail. Light/Dark en bas à gauche, liste/album en haut au centre.

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

Enregistrez ce qui précède sous index.html et double-cliquez pour l'ouvrir. Déplacez la souris sur le nom d'une œuvre pour voir la vignette apparaître à droite, cliquez pour accéder à la page de détail. Pour changer les images, remplacez les URLs picsum par vos propres adresses.

À conserver impérativement (ne pas modifier)

  • Import de la police : @font-face chargeant le woff2 d'Alimama DaoLiTi (ne pas changer la source)
  • Système de variables CSS : double thème clair/sombre
  • Tout le JS : theme toggle, view mode toggle, interaction hover-row, crédit tournant, routage par hash pour les pages de détail applyRoute(), renderDetail()
  • La balise <script id="works-data"> doit être conservée
  • La balise <main id="detail-root"> doit être conservée (point de montage de la page de détail)
  • Le système d'état body[data-view="home/detail"] et body[data-mode="list/gallery"]
  • Les cinq éléments positionnés fixement : #logo / #main-menu / .theme-toggle / #project-view / #svp-credit

Vérification rapide des erreurs

  • 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 exactement identiques
  • Guillemets JSON : dans le contenu chinois, utilisez toujours les guillemets pleine largeur « » ou "...", pas les guillemets ASCII "
  • Trop de galeries : maximum 6 images par œuvre, au-delà la mise en page sera désordonnée
  • Prose trop longue : 80-150 caractères par paragraphe, au-delà de 200 caractères l'expérience de lecture se dégrade
  • Liste/galerie désynchronisées : doivent contenir exactement le même ensemble d'œuvres (correspondance un-à-un)
  • Picsum seed : utilisez id/X pas seed/X, pour éviter un ID aléatoire pointant vers une image supprimée
  • Moins de 3 œuvres : possible, minimum 2 pour que ça fonctionne
  • Plus de 8 œuvres : suggérez de diviser en deux lots, trop de lignes de liste allongent la page
  • Lettre initiale tombante : .detail__prose p:first-of-type::first-letter utilise la police DaoLiTi — le premier paragraphe doit commencer par du chinois (pas par <em> ou par de l'anglais)
  • Couleur supprimée de picsum : les images doivent rester en couleur, n'ajoutez pas de filter: grayscale() dans le CSS

Individual skills in this repo

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

Skills associés