portfolio-detail — Chinese Atelier / Lishu Calligraphy Portfolio (with Secondary Detail Pages)
One-Line Characteristic
Horizontal text rows + hover to reveal large image on the right + Alimama DaoLiTi artistic large characters + black-and-white pure colors + light/dark theme + hash-routed detail pages + list/gallery dual views.
Differences from Other Portfolio Skills
| skill | core mode | best for |
|---|---|---|
portfolio-gen | infinite drag canvas + tile layout | Photographers / graphic designers showcasing samples |
portfolio-museum-gen | hero carousel + large cards + waterfall + detail pages (film curation feel) | Video/film/installation artists |
industrial-archive-gen | black-framed flip cover + sidebar archive + Nordic industrial | Physical products / objects / hardware |
lishu-portfolio-gen | Horizontal text rows + hover reveals right thumbnail + Lishu large characters + restrained Chinese aesthetics | Bookbinding / typography / craft / Chinese ateliers |
If the user's project is about "books / typography / exhibitions / still life / Chinese herbs / tea / pottery / wood / paper / incense" and requires a restrained, elegant style — use this one.
When to Trigger
The user says:
- "Create a Chinese / Eastern / classical style portfolio"
- "Create a Lishu-style website / studio homepage"
- "Create a white-atelier style portfolio" / "Create a horizontal list website like Gurgel D'Alfonso"
- "lishu-portfolio-gen ..."
And provides:
- Studio description (Required): name, director, city, discipline, titles and stories for several works
- Work images (Optional): URL / uploaded file / path. It works without them (uses picsum placeholders)
If the user does not provide work titles at all → ask at least which works need to be displayed. If the user only provides titles but no details → write them yourself: generate 1 lead sentence + 3 prose paragraphs + 6-8 spec lines + 3-6 picsum images + several credits for each work. The tone should match the work type (book → bookbinding / typography → font / object → still life / exhibition → exhibition visuals).
Two Operation Modes
Mode A · Claude Code / Local (with file system)
- Use
Bashto list folders,sipsto probe image dimensions - Output location:
~/Desktop/{slug}-portfolio.html(single file, all images via URL) - If user provides local images: copy them to
~/Desktop/{slug}-portfolio-images/and updatesrcto relative paths
Mode B · GLM / Online Chat (no file system)
- User drags in a zip archive, after extraction they see 4 files
- Only output one complete HTML string, wrapped in a
```htmlcode block - If user uploads images but does not provide URLs → use
https://picsum.photos/id/{id}/{w}/{h}placeholders (use known existing IDs) - Do not attempt to access local files or suggest command-line operations
Decision: If you cannot Read to see local images → default to Mode B.
File Division
| File | Role | How to use |
|---|---|---|
reference.html | Complete finished reference — BAIWU atelier with 6 works | Look at: wording of list items, prose tone, spec vocabulary, JSON field density |
template.html | Empty skeleton — same CSS/JS/routing system, 2 examples + 20 SWAP markers | Modify based on it, output final HTML |
README.md | User-facing instructions | Not needed by the model |
SKILL.md | Workflow instructions for the model (this file) | Must read |
Core rule: All modifications based on template.html; learn how to write (tone, word count, tag wording) from reference.html, but do not copy its specific content.
Work Steps
1. Read the Two HTML Files
- Read
reference.htmlfirst to understand "what the complete version looks like" (especially the field density of theworks-dataJSON and prose tone) - Then read
template.htmlto find the 20 SWAP locations
Do not modify JS / CSS / detail page routing system / font imports. SWAPs are only in HTML text and JSON data.
2. Parse User Input and Extract Information
Extract:
- ATELIER_NAME_ZH — Chinese studio name (2-4 characters best, e.g. "白屋" "素园" "墨记" "青庐" "拙轩")
- PINYIN — Pinyin (5-6 English letters, all uppercase: BAIWU / SUYUAN / MOJI)
- CHAR — Single character for the logo (usually the first character of the studio name: 白 / 素 / 墨 / 青 / 拙)
- CITY — City
- DIRECTOR_ZH / DIRECTOR_EN — Director's name + pinyin
- DISCIPLINE — 3 discipline words ("装帧 · 字体 · 静物")
- TAGLINE — One-line positioning (20-40 characters, kai-style temperament)
- YEAR_FOUNDED — Founding year (can use Gan-Zhi: 乙未冬 / 甲辰春)
For each work extract:
- slug — URL ID, lowercase English with hyphens (
kong-shan-ji/wu-ming-shu) - title_zh — Chinese title (2-5 characters best, more concise = more character)
- title_en — English subtitle (book-title style:
An Anthology of Empty Mountains) - year — Year or Gan-Zhi year (
甲辰 / 2024/2025/乙巳 / 2025) - tag — Top category, wrapped in square brackets, e.g.
[ 诗集 · 装帧设计 ]/[ 字体设计 · 中草药图谱 ] - cover — Detail page large image URL
- list row location —
City, Year · Craft/Spec(appears on hover) - meta — 4 key-value pairs (4-column summary on the detail page)
- lead — 30-70 character opening large text, can use
<em>keyword</em>for emphasis - prose — 3-4 paragraphs, each 80-150 characters
- specs — 6-10 row spec table (format/paper/binding/typeface/print run/printing/craft/price etc.)
- gallery — 3-6 images, layout one of three:
g-wide/g-half/g-third - credits — 4-7 pairs of role/name
If user only provides one sentence and no story → create it yourself: write lead and prose that match the work's title and type. Reference the tone of reference.html — no marketing language, have a "museum wall-text + studio journal" feel (restrained, specific, slow, with traces of handcraft).
3. List Works + Check Dimensions (Mode A only)
ls -la "{works_path}"
sips -g pixelWidth -g pixelHeight "{works_path}/{file}" 2>/dev/null
Obtain (filename, w, h, aspect) for each image. Prefer vertical images for list thumbnails (4:3 container, vertical images look better).
4. Replace 20 SWAPs
| SWAP | Location | Content |
|---|---|---|
| 1 | <title> | {ATELIER_NAME} {PINYIN} — {DIRECTOR} Portfolio / Studio |
| 2 | meta description | One-line site description |
| 3 | curtain single character | First character of studio name (e.g. "白") |
| 4 | logo SVG inner single character | Same as SWAP-3 |
| 5 | logo SVG inner pinyin | {PINYIN} uppercase |
| 6 | main navigation li | Usually 3 items: Works / About / Contact |
| 7 | brand-block Chinese name | {ATELIER_NAME} with space between characters (e.g. 白 屋) |
| 8 | brand-block English | {PINYIN} Studio · {CITY} |
| 9 | tagline | One-line positioning in kai style, 20-40 characters, can use <br> for line break |
| 10 | list items N pieces | Each <a class="item" href="#work/{slug}"> contains num/project-name/en-name/location/photo-thumb |
| 11 | gallery items N pieces | Same N works, more compact grid — slug must match list |
| 12 | About title | 关 于 {name}<span class="en">About</span> |
| 13 | About paragraphs | 1-3 paragraphs in kai style (background / director / design philosophy), each 60-120 characters |
| 14 | About facts table | 4-6 items li (Founded/Location/Discipline/Director/Hours) |
| 15 | Contact title | 来 信<span class="en">Get in Touch</span> |
| 16 | Contact paragraphs | 1-2 paragraphs inviting letters + reply cycle commitment |
| 17 | Contact facts table | 4-6 items (E-mail/Phone/Address/Instagram/WeChat Official Account) |
| 18 | rotating credit | Site by {WHO} (usually the studio name) |
| 19 | footer three blocks | © / ICP / social links |
| 20 | works-data JSON | Complete detail data for N works (critical!) |
5. Write works-data JSON (Most Critical Step)
Each work must have one entry in the JSON array. The slug must exactly match the #work/SLUG in the list/gallery card href.
JSON fields:
{
"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": [
"Paragraph 1: Source of poems / design context. 80-150 characters.",
"Paragraph 2: Key decisions during production — typeface, paper, binding choices.",
"Paragraph 3: Final presentation / feeling left for the reader."
],
"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 / 设计", "周墨白"],
["Hand Binding / 手工装订", "陈漱石(杭州·订书坊)"]
]
}
JSON Gotchas ⚠️:
- Quotes in Chinese prose must use full-width
「...」or"..."(U+201C / U+201D), not ASCII"(will break JSON) - Do not use real newlines inside JSON strings; to indicate paragraph breaks, add another item in the prose array
<em>word</em>inleadis written directly as HTML tags — rendered as innerHTML- Gallery
layoutmust be one of three:g-wide(full width) /g-half(half width) /g-third(one third)
6. Image Source Selection
- picsum placeholder: Use
id/Xformat instead ofseed/X(more stable). Known good IDs: 0, 20, 40, 51, 64, 76, 88, 91, 96, 119, 121, 130, 143, 145, 158, 164, 165, 175, 177, 180, 187, 195, 200 - Use adjacent IDs for cover/gallery of the same work to create a consistent color tone
- Do not use
?grayscaleparameter (users expect images to be in color)
7. Chinese Studio Name Inspiration (if user doesn't provide one)
If the user asks you to "create a name yourself" → choose 2 characters + ancient style:
- Object category: 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
- Character/calligraphy category: 素白 / 子衿 / 砚池 / 半山 / 寻常 / 浮云
- Avoid functional words like "工作室 / 设计 / Studio", let the name itself be a poem
8. Video Support
If a work's cover is .mp4 / .webm / .mov, the detail page will automatically use <video autoplay muted loop> instead of <img>. Just provide the video path in the cover URL.
9. Reporting
Mode A: One-sentence report.
Generated ~/Desktop/baiwu-portfolio.html — 6 works, hover over rows to view thumbnails, click to enter detail pages. Light/Dark toggle at bottom left, List/Gallery toggle at top center.
Mode B: Provide the complete HTML code block + one line of explanation.
Save the above snippet as
index.htmland double-click to open it. Hover your mouse over any work name to see the thumbnail appear on the right, click to jump to the detail page. Replace picsum URLs with your own image addresses.
Mandatory Items (Cannot Change)
- Font import:
@font-faceloading Alimama DaoLiTi woff2 URL (do not change the font source) - CSS variable system: light/dark dual themes
- All JS: theme toggle, view mode toggle, hover-row interaction, rotating credit, detail page hash routing
applyRoute(),renderDetail() <script id="works-data">node must be preserved<main id="detail-root">must be preserved (detail page mount point)body[data-view="home/detail"]andbody[data-mode="list/gallery"]state system- #logo / #main-menu / .theme-toggle / #project-view / #svp-credit five fixed-position elements
Quick Error Checklist
- Slug mismatch: list item
#work/kong-shan-ji↔ gallery item#work/kong-shan-ji↔ JSON"slug": "kong-shan-ji"— all three must be identical - JSON quotes: Use full-width 「」 or
"..."for Chinese content quotes, not ASCII" - Too many gallery items: Maximum 6 images per work, exceeding this breaks the layout
- Prose too long: Each paragraph 80-150 characters, readability drops if over 200 characters
- List / Gallery out of sync: Must contain the same set of works (one-to-one correspondence)
- Picsum seed: Use
id/Xinstead ofseed/Xto avoid random IDs hitting deleted images - Works < 3: It works, minimum 2 works
- Works > 8: Suggest splitting into two batches, too many list rows make the page long
- First character drop cap:
.detail__prose p:first-of-type::first-letteruses DaoLiTi font — the first paragraph must start with Chinese characters (not with<em>or English) - Removed picsum color: Images should remain in color, do not add
filter: grayscale()in CSS