Communitygithub.com

AiCurv/ADBCommander

Génère un site web portfolio unique en HTML, de style atelier chinois, avec une liste horizontale de projets, des vignettes au survol, une typographie artistique « Alimama DaoLiTi » via CDN, thème clair/sombre et pages de détail par hash-routing. Fonctionne avec Claude Code (écrit sur ~/Desktop) et GLM/chat en ligne (affiche le HTML directement).

Qu'est-ce que ADBCommander ?

Ce skill permet de générer, à partir d'une simple description en langage naturel, un site web portfolio complet au style épuré et élégant des ateliers chinois traditionnels. Il produit un unique fichier HTML incluant : une page d'accueil avec une liste horizontale de projets, une interaction de survol qui affiche une vignette à droite, une typographie artistique (Alimama DaoLiTi) chargée via CDN, un thème clair/sombre, et des pages de détail accessibles par hash routing. Le skill fonctionne en deux modes : avec Claude Code (écrit le fichier sur le bureau, peut lire les images locales et ajuster les dimensions) ou avec GLM/chat en ligne (affiche le HTML dans la réponse, utilise des images de placeholder picsum si nécessaire). Il est déclenché par des phrases clés comme « 做个中式工作室作品集 » ou « lishu-portfolio-gen ... ». Le skill inclut un fichier de référence (reference.html) pour s'inspirer du ton et du style, ainsi qu'un template (template.html) avec 20 marqueurs SWAP à personnaliser (nom de l'atelier, œuvres, crédits, etc.). Il gère les œuvres sous forme de JSON avec des champs détaillés (slug, titre, année, tag, lead, prose, spécifications, galerie, crédits) et intègre un système de mise en page à deux vues (liste et galerie). Les points d'attention sont : la cohérence des slugs entre les listes, la galerie et le JSON, l'utilisation de guillemets chinois pleine largeur dans les textes en prose, et le respect des limitations (max 6 images par œuvre, 80-150 mots par paragraphe).

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AiCurv/ADBCommander/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 — Atelier chinois / Portfolio en style lishu (avec pages de détail secondaires)

Description en une phrase

Ligne de texte horizontale + vignette apparaissant au survol à droite + grands caractères artistiques Alimama DaoLiTi + noir et blanc pur + thème light/dark + page de détail par hash routing + double vue liste / album.

Différence avec les autres skills de portfolio

skillmode principalpour qui
portfolio-genCanvas infini avec glisser-déposer + tuilesPhotographes / graphistes pour montrer des échantillons
portfolio-museum-genCarrousel héro + grandes cartes + cascade + page de détail (ambiance commissaire d'exposition)Artistes vidéo / image / installation
industrial-archive-genCouverture à feuilleter à cadre noir + barre latérale d'archive + industriel nordiqueProduits physiques / objets / matériel
lishu-portfolio-genLignes de texte horizontales + vignette au survol à droite + grands caractères lishu + sobriété chinoiseReliure / typographie / exposition / nature morte / herbes médicinales chinoises / thé / poterie / bois / papier / encens — tout ce qui nécessite une élégance sobre et classique

Si le projet de l'utilisateur concerne : « livre / typographie / exposition / nature morte / herbes médicinales chinoises / thé / poterie / bois / papier / encens » et nécessite une retenue et une élégance classique — utilisez ce skill.

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 d'atelier"
  • "Fais-moi un portfolio style maison blanche" / "Fais-moi un site avec liste horizontale comme Gurgel D'Alfonso"
  • "lishu-portfolio-gen ..."

Et fournit :

  • Description de l'atelier (obligatoire) : nom, directeur, ville, discipline, titres et histoires de quelques œuvres
  • Images des œuvres (optionnel) : URL / téléchargement / chemin. Fonctionne aussi sans (utilise picsum comme placeholder)

Si l'utilisateur ne donne PAS du tout les titres des œuvres → demandez au moins quelles œuvres il souhaite présenter. Si l'utilisateur donne seulement les titres sans les détails → générez vous-même : pour chaque œuvre, une phrase d'accroche + 3 paragraphes de prose + 6-8 lignes de spécifications + 3-6 images picsum + quelques crédits. Le ton doit correspondre au type d'œuvre (livre → reliure / typographie → 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 vérifier 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 glisse un zip, après décompression il voit 4 fichiers
  • Ne produisez qu'une seule chaîne HTML complète, encapsulée dans un bloc de code ```html
  • Si l'utilisateur télécharge des images mais ne donne pas d'URL → utilisez https://picsum.photos/id/{id}/{w}/{h} comme placeholder (utilisez des ID qui existent)
  • N'essayez pas d'accéder aux fichiers locaux, ne suggérez pas d'opérations en ligne de commande

Décision : si vous ne pouvez pas Lire et voir les images locales → allez en 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 œuvresRegardez : le ton des éléments de liste, le ton de la prose, le vocabulaire des spécifications, la densité des champs JSON
template.htmlStructure vide — Même système CSS/JS/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.mdWorkflow pour le modèle (ce fichier)À lire obligatoirement

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

Étapes de travail

1. Lire les deux HTML

  • Lisez d'abord reference.html pour comprendre "à quoi ressemble le produit fini" (en particulier la densité des champs dans le JSON works-data et le ton de la prose)
  • Ensuite, lisez template.html pour trouver les 20 emplacements 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 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

Extrayez :

  • ATELIER_NAME_ZH — Nom chinois de l'atelier (2-4 caractères idéal, 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 de l'atelier : 白 / 素 / 墨 / 青 / 拙)
  • CITY — Ville
  • DIRECTOR_ZH / DIRECTOR_EN — Nom du directeur + pinyin
  • DISCIPLINE — 3 mots de discipline ("装帧 · 字体 · 静物")
  • TAGLINE — Phrase d'accroche d'une ligne (20-40 caractères, style kaïti)
  • YEAR_FOUNDED — Année de création (peut être en caractères cycliques : 乙未冬 / 甲辰春)

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éal, 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 cyclique (甲辰 / 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écification (apparaît au survol)
  • meta — 4 paires clé-valeur (résumé en 4 colonnes de la page de détail)
  • lead — Phrase d'ouverture en grands caractères, 30-70 caractères, peut utiliser <em>mot-clé</em> pour mettre en valeur
  • prose — 3-4 paragraphes en prose, 80-150 mots chacun
  • specs — Tableau de spécifications de 6-10 lignes (format/papier/reliure/typographie/quantité/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 → générez vous-même : en fonction du titre et du type de l'œuvre, écrivez un lead et une prose qui correspondent au ton de l'œuvre. Référez-vous au ton de reference.html — pas de langage marketing, mais une sensation de « texte mural de musée + carnet d'atelier » (sobre, 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

Obtenez pour chaque image (filename, w, h, aspect). Privilégiez les images en portrait comme vignettes de liste (conteneur 4:3, le portrait est plus photogénique).

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 de l'atelier (par exemple « 白 »)
4Caractère unique dans le SVG du logoIdentique à SWAP-3
5Pinyin dans le SVG du logo{PINYIN} en majuscules
6li de la navigation principaleHabituellement 3 éléments : Œuvres / À propos / Contact
7Nom chinois du bloc de marque{ATELIER_NAME} avec espace entre les caractères (par exemple 白&nbsp;&nbsp;屋)
8Anglais du bloc de marque{PINYIN} Studio · {CITY}
9TaglinePhrase d'accroche d'une ligne en style kaïti, 20-40 caractères, peut utiliser <br> pour un saut 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, grille plus compacte — le slug doit être identique à celui de la liste
12Titre À propos关&nbsp;于&nbsp;{name}<span class="en">About</span>
13Paragraphes À propos1-3 paragraphes en kaïti (contexte de création / directeur / vision du design), 60-120 mots 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 de l'atelier)
19Trois blocs de pied de page© / ICP / lien social
20JSON works-dataDonnées complètes de détails pour N œuvres (essentiel !)

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

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

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 JSON courantes ⚠️ :

  • Dans la prose chinoise, utilisez des guillemets → il faut utiliser les guillemets chinois pleine largeur 「...」 ou "..." (U+201C / U+201D), ne pas utiliser le guillemet ASCII " (cela briserait le JSON)
  • Ne faites pas de vrais sauts de ligne dans les chaînes JSON ; pour changer de paragraphe, ajoutez un élément de plus dans le tableau prose
  • Les balises <em>mot</em> dans le lead sont écrites directement en HTML — elles sont rendues avec innerHTML
  • Le layout de la galerie doit être choisi parmi trois valeurs : g-wide (pleine largeur) / g-half (moitié) / 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 pour être bons : 0, 20, 40, 51, 64, 76, 88, 91, 96, 119, 121, 130, 143, 145, 158, 164, 165, 175, 177, 180, 187, 195, 200
  • Pour la cover et la galerie 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 les noms d'ateliers chinois (si l'utilisateur n'en donne pas)

Si l'utilisateur vous demande d'"en inventer un" → choisissez 2 caractères + style antique :

  • Noms d'objets : 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
  • Noms de lignes de caractères : 素白 / 子衿 / 砚池 / 半山 / 寻常 / 浮云
  • Évitez les mots fonctionnels comme "工作室 / 设计 / Studio", le nom doit être poétique en lui-même

8. Support vidéo

Si la 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'à donner le chemin de la vidéo dans l'URL de la cover.

9. Rapport

Mode A : Rapport en une phrase.

Généré ~/Desktop/baiwu-portfolio.html — 6 œuvres, survolez les lignes pour voir la vignette, cliquez pour entrer dans 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.

Sauvegardez ce qui précède en tant que index.html et double-cliquez. Déplacez la souris sur un nom d'œuvre pour voir la vignette apparaître à droite, cliquez pour accéder à la page de détail. Pour changer les images, remplacez l'URL picsum par votre adresse d'image.

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

  • Importation de la police : @font-face charge l'URL woff2 de la police Alimama DaoLiTi (ne changez pas 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 des lignes, crédit tournant, routage par hash des pages de détail applyRoute(), renderDetail()
  • Le nœud <script id="works-data"> doit être conservé
  • Le <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 positionnés de manière fixe : #logo / #main-menu / .theme-toggle / #project-view / #svp-credit

Aide-mémoire 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 strictement identiques
  • Guillemets JSON : dans le contenu chinois, utilisez toujours les guillemets chinois pleine largeur «」ou "...", pas le guillemet ASCII "
  • Trop d'images dans la galerie : maximum 6 images par œuvre, au-delà la mise en page sera perturbée
  • Prose trop longue : 80-150 mots par paragraphe, au-delà de 200 mots l'expérience de lecture se dégrade
  • Liste / Galerie non synchronisées : elles doivent contenir le même ensemble d'œuvres (correspondance biunivoque)
  • seed picsum : utilisez id/X et non seed/X, pour éviter qu'un ID aléatoire ne corresponde à une image supprimée
  • Moins de 3 œuvres : possible, 2 œuvres minimum pour que ça fonctionne
  • Plus de 8 œuvres : il est conseillé de les répartir en deux groupes, trop de lignes de liste allongent la page
  • Premier caractère en retrait : dans la page de détail, .detail__prose p:first-of-type::first-letter utilise la police DaoLiTi — le premier paragraphe doit commencer par du chinois (pas par <em> ou de l'anglais)
  • Suppression de la couleur picsum : les images doivent rester en couleur, n'ajoutez pas filter: grayscale() dans le CSS

Individual skills in this repo

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

AiCurv/ADBCommander

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.

AiCurv/ADBCommander

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.

AiCurv/ADBCommander

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.

AiCurv/ADBCommander

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

AiCurv/ADBCommander

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.

AiCurv/ADBCommander

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.

AiCurv/ADBCommander

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