Communitygithub.com

Cetc2211/AcTR-app — Générateur de Portfolio Studio Chinois

Génère un site web portfolio élégant de style atelier chinois (liste horizontale + vignettes au survol, typographie artistique LiShu via CDN, thème clair/sombre, pages détail avec routage par hash). Prend une description en langage naturel et produit un seul fichier HTML fonctionnel.

Qu'est-ce que AcTR-app — Générateur de Portfolio Studio Chinois ?

Ce skill, nommé « lishu-portfolio-gen », permet de générer un portfolio de studio chinois complet et élégant à partir d'une simple description textuelle. Il produit un unique fichier HTML autonome, intégrant une mise en page horizontale minimaliste avec révélations d'images au survol, une typographie artistique LiShu (阿里妈妈刀隶体) chargée depuis un CDN, un thème clair/sombre, et des pages de détail complètes pour chaque œuvre via un routage par hash. Le skill fonctionne en deux modes : Mode A pour Claude Code (génération d'un fichier local sur le bureau) et Mode B pour les agents en ligne comme GLM (affichage du HTML directement dans le chat). Il est déclenché par des phrases en chinois comme « 做个中式工作室作品集 » ou « 做个隶书作品集 », ou lorsque l'utilisateur glisse le dossier du skill dans le chat en demandant un site de style atelier. Sa force réside dans sa capacité à inférer des descriptions d'œuvres crédibles, à générer un contenu textuel riche (prose, spécifications, crédits) et à produire un rendu visuel haut de gamme, rappelant l'esthétique des studios d'artisanat chinois.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Cetc2211/AcTR-app/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 LiShu (avec page de détail secondaire)

En une phrase

Lignes de texte horizontales + grande image apparaissant au survol à droite + grands caractères artistiques Alimama DaoLiTi + noir et blanc pur + thème light/dark + pages de détail par hash + double vue liste/album.

Différences avec les autres skills de portfolio

skillMode principalPour qui
portfolio-genToile à glisser infinie + tuilesPhotographes / graphistes présentant des échantillons
portfolio-museum-genCarrousel héro + grandes cartes + cascade + pages de détail (sens de la curation vidéo)Artistes vidéo / image / installation
industrial-archive-genPages de couverture à retourner en cadre noir + archive latérale + industriel nordiqueProduits physiques / objets / hardware
lishu-portfolio-genLignes de texte horizontales + miniatures apparaissant à droite au survol + grands caractères LiShu + retenue chinoiseReliure / typographie / exposition / nature morte / plantes médicinales / thé / poterie / bois / papier / encens – tout ce qui demande une élégance sobre

Quand déclencher

L'utilisateur dit :

  • "Crée un portfolio de style chinois / oriental / classique"
  • "Fais un site de style LiShu / une page d'accueil de studio"
  • "Fais un portfolio style Maison Blanche" / "Fais un site à liste horizontale comme Gurgel D'Alfonso"
  • "lishu-portfolio-gen …"

Et fournit :

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

Si l'utilisateur ne donne aucun titre d'œuvre → demander une fois au moins quelles œuvres exposer. Si l'utilisateur ne donne que les titres sans détails → générer soi-même : pour chaque œuvre, 1 phrase d'accroche (lead) + 3 paragraphes de prose + 6 à 8 lignes de specs + 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)

  • Utiliser Bash pour lister les dossiers, sips pour vérifier les dimensions de chaque image
  • Sortie : ~/Desktop/{slug}-portfolio.html (un seul fichier, toutes les images via URL)
  • Si l'utilisateur fournit des images locales : les copier dans ~/Desktop/{slug}-portfolio-images/ et modifier les src en chemins relatifs

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

  • L'utilisateur glisse un zip ; après décompression, 4 fichiers sont visibles
  • Sortie uniquement une chaîne HTML complète, enveloppée dans un bloc de code ```html
  • Si l'utilisateur téléverse des images sans URL → utiliser https://picsum.photos/id/{id}/{w}/{h} comme placeholder (avec des ID existants connus)
  • Ne pas essayer d'accéder aux fichiers locaux, ne pas suggérer d'opérations en ligne de commande

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

Répartition des fichiers

FichierRôleComment l'utiliser
reference.htmlRéférence complète du produit fini — Maison Blanche BAIWU 6 œuvresRegarder : le phrasé des éléments de liste, le ton de la prose, le vocabulaire des specs, la densité des champs JSON
template.htmlSquelette vide — Mêmes CSS/JS/système de routage, 2 exemples + 20 marqueurs SWAPModifier sur cette base, sortir le HTML final
README.mdInstructions d'utilisation pour l'utilisateurLe modèle n'a pas besoin de le voir
SKILL.mdWorkflow pour le modèle (ce fichier)À lire impérativement

Règle fondamentale : toutes les modifications se font sur template.html ; de reference.html, apprendre comment écrire (ton, longueur, choix des tags), mais ne pas copier le contenu exact.

Étapes de travail

1. Lire les deux HTML

  • Lire d'abord reference.html pour comprendre "à quoi ça ressemble une fois complet" (en particulier la densité des champs dans le JSON works-data et le ton de la prose)
  • Puis lire template.html pour repérer les 20 positions SWAP

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

2. Analyser la saisie utilisateur et extraire les informations

Extraire :

  • 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 — Phrase d'accroche en une ligne (20-40 caractères, style italique)
  • YEAR_FOUNDED — Année de fondation (peut utiliser le cycle干支 : 乙未冬 / 甲辰春)

Pour chaque œuvre, extraire :

  • 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 c'est concis, plus c'est élégant)
  • title_en — Sous-titre anglais (style entre guillemets : An Anthology of Empty Mountains)
  • year — Année ou année干支 (甲辰 / 2024 / 2025 / 乙巳 / 2025)
  • tag — Catégorie en haut, entre crochets, ex. [ 诗集 · 装帧设计 ] / [ 字体设计 · 中草药图谱 ]
  • cover — URL de la grande image de la page de détail
  • list line location — Ville, année · technique/spécifications (apparaît au survol)
  • meta — 4 paires clé-valeur (résumé 4 colonnes de la page de détail)
  • lead — 30-70 caractères, grande phrase d'ouverture, peut utiliser <em>mot-clé</em> pour mettre en valeur
  • prose — 3-4 paragraphes de prose, chaque 80-150 mots
  • 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 poste/nom

Si l'utilisateur ne donne qu'une phrase / pas d'histoire → inventer soi-même : selon le titre et le type de l'œuvre, écrire un lead et une prose qui correspondent à son caractère. Le ton doit se référer à reference.html — pas de langage marketing, mais plutôt un sentiment de « texte mural de musée + carnet d'atelier » (retenu, concret, lent, avec des traces de travail manuel).

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

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

Obtenir pour chaque image (filename, w, h, aspect). Privilégier les images verticales comme vignettes de liste (conteneur 4:3, les images verticales rendent mieux).

4. Remplacer les 20 SWAP

SWAPEmplacementContenu
1<title>{ATELIER_NAME} {PINYIN} — {DIRECTOR}作品集 / Studio
2meta descriptionUne phrase de description du site
3Caractère unique du rideauPremier caractère du nom du studio (ex. « 白 »)
4Caractère unique dans le SVG du logoMême que SWAP-3
5Pinyin dans le SVG du logo{PINYIN} en majuscules
6li de la navigation principaleGénéralement 3 items : Œuvres / À propos / Contact
7Nom chinois du bloc de marque{ATELIER_NAME} caractères séparés par des espaces (ex. 白&nbsp;&nbsp;屋)
8Anglais du bloc de marque{PINYIN} Studio · {CITY}
9TaglinePhrase de positionnement en une ligne, style italique, 20-40 caractères, peut utiliser <br> pour les sauts de ligne
10Éléments de liste N œuvresChaque <a class="item" href="#work/{slug}"> contient num/project-name/en-name/location/photo-thumb
11Éléments de galerie N œuvresLes mêmes N œuvres, en 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 italique (contexte de création / directeur / vision du design), chaque 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 + promesse de délai de réponse
17Tableau de faits Contact4-6 éléments li (E-mail/Phone/Address/Instagram/公众号)
18Crédit rotatifSite by {WHO} (généralement le nom du studio)
19Trois blocs de footer© / ICP / liens sociaux
20JSON works-dataDonnées complètes des détails des N œuvres (critique !)

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 être exactement identique à celui du href #work/SLUG des cartes de liste/galerie.

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", "陈漱石(杭州·订书坊)"]
  ]
}

Points sensibles JSON ⚠️ :

  • Dans la prose chinoise, utiliser les guillemets pleine largeur 「...」 ou "..." (U+201C / U+201D), ne pas utiliser les guillemets ASCII " (cela casserait le JSON)
  • Ne pas mettre de vraies sauts de ligne dans les chaînes JSON ; pour changer de paragraphe, ajouter un élément supplémentaire dans le tableau prose
  • <em>mot</em> dans le lead peut contenir directement des balises 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. Choix des sources d'images

  • Placeholder picsum : utiliser 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
  • La cover et la galerie d'une même œuvre doivent utiliser des ID adjacents pour créer une tonalité de couleur cohérente
  • Ne pas utiliser le paramètre ?grayscale (l'utilisateur souhaite des images en couleur)

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

Si l'utilisateur vous demande de "trouver un nom vous-même" → choisir 2 caractères à l'aspect antique :

  • Catégorie objet : 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
  • Catégorie calligraphie : 素白 / 子衿 / 砚池 / 半山 / 寻常 / 浮云
  • Éviter les mots fonctionnels comme "工作室 / Studio", que le nom soit lui-même un poème

8. Support vidéo

Si la couverture de l'œ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 de la vidéo dans l'URL de couverture.

9. Rapport

Mode A : Rapport en une phrase.

Fichier généré ~/Desktop/baiwu-portfolio.html — 6 œuvres, survolez une ligne pour voir la vignette, cliquez pour accéder à la page de détail. Light/Dark en bas à gauche, mode liste/album en haut au centre.

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

Enregistrez le code ci-dessus en index.html et ouvrez-le en double-cliquant. Passez la souris sur un nom d'œuvre pour voir apparaître la vignette à droite, cliquez pour accéder à la page de détail. Pour changer les images, remplacez les URL picsum par vos adresses.

Éléments à conserver impérativement (ne pas modifier)

  • Import de police : @font-face chargeant le woff2 d'Alimama DaoLiTi (ne pas changer la source de la police)
  • Système de variables CSS : double thème light/dark
  • Tout le JS : bascule de thème, bascule de mode de vue, interaction de survol de ligne, crédit rotatif, routage par 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)
  • Le système d'état body[data-view="home/detail"] et body[data-mode="list/gallery"]
  • Les cinq éléments en position fixe : #logo / #main-menu / .theme-toggle / #project-view / #svp-credit

Vérification rapide des erreurs

  • Slug non concordant : é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 : les guillemets dans le contenu chinois doivent être pleine largeur «» ou "...", pas ASCII "
  • Trop d'images dans la galerie : maximum 6 images par œuvre, au-delà la mise en page sera perturbée
  • Prose trop longue : chaque paragraphe 80-150 mots, au-delà de 200 mots la lecture devient moins agréable
  • Liste / Galerie non synchronisées : doivent contenir le même ensemble d'œuvres (correspondance une à une)
  • Seed picsum : utiliser id/X et non seed/X, pour éviter qu'un ID aléatoire ne tombe sur une image supprimée
  • Moins de 3 œuvres : possible, 2 minimum suffisent
  • Plus de 8 œuvres : conseillé de les diviser en deux lots, trop de lignes de liste allongent la page
  • Premier caractère en grande capitale : .detail__prose p:first-of-type::first-letter utilise la police DaoLiTi — le premier paragraphe doit commencer par du chinois (ne pas commencer par <em> ou par de l'anglais)
  • Suppression de la couleur des picsum : les images doivent rester en couleur, ne pas ajouter filter: grayscale() dans le CSS

Individual skills in this repo

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

Cetc2211/AcTR-app

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.

Cetc2211/AcTR-app

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.

Cetc2211/AcTR-app

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.

Cetc2211/AcTR-app

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

Cetc2211/AcTR-app

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.

Cetc2211/AcTR-app

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.

Cetc2211/AcTR-app

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.

Skills associés