Communitygithub.com

antilsabh789-pixel/kabaddi-pro

Generate a single-file Chinese atelier-style portfolio website (horizontal-row list + hover-reveal thumb interaction, art lishu typography "Alimama DaoLiTi" via CDN, light/dark theme, hash-routed detail pages). Takes a natural-language description of the studio (name, director, discipline, works) and outputs ONE working .html file. Runs in BOTH Claude Code (writes to ~/Desktop) and GLM / online chat (outputs HTML inline). Trigger phrases include "做个中式工作室作品集", "做个隶书作品集", "lishu-portfolio-gen ...", "做个白屋风格的作品集", or when user drags this skill folder into chat asking for an atelier-style site.

What is kabaddi-pro?

This skill generates a complete, single-file atelier-style portfolio website with a Chinese aesthetic, featuring horizontal text rows, hover-reveal thumbnails on the right, and the artistic 'Alimama DaoLiTi' lishu font loaded via CDN. It supports both light and dark themes, hash-routed detail pages, and a list/gallery dual-view toggle. The skill is designed for both local use (Claude Code writes the HTML to ~/Desktop) and online chat (GLM or similar outputs the HTML inline). It works by reading a template.html skeleton with 20 SWAP markers and a reference.html for stylistic guidance, then populating the data (studio info, work descriptions, specs, prose, and gallery) based on a natural-language user description. The output is a single, self-contained HTML file that can be opened directly in a browser, making it ideal for designers, typographers, and craftspeople who need an elegant, minimal portfolio site.

Works with✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/antilsabh789-pixel/kabaddi-pro/tree/HEAD/.migration-backup/skills/design/design-templates/portfolio-detail

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

portfolio-detail — Chinese Atelier / Lishu Portfolio (with Secondary Detail Pages)

One-Line Description

Horizontal text lines + hover reveals large image on the right + Alimama DaoLiTi artistic calligraphy + black/white pure colors + light/dark + hash-routed detail pages + list/gallery dual view.

Differences from Other Portfolio Skills

SkillCore ModeBest For
portfolio-genInfinite drag canvas + tile layoutPhotographers / graphic designers showcasing samples
portfolio-museum-genHero carousel + large cards + masonry + detail pages (curatorial film feel)Video / film / installation artists
industrial-archive-genBlack-frame flip cover + sidebar archive + Nordic industrialPhysical products / artifacts / hardware
lishu-portfolio-genHorizontal text rows + hover shows right thumbnail + lishu calligraphy + restrained Chinese eleganceBookbinding / typography / crafts / Chinese atelier

If the user's project is about "books / fonts / exhibitions / still life / Chinese herbs / tea / pottery / wood / paper / incense" — anything that requires restrained, elegant grace — 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-gallery style portfolio" / "Create a horizontal list website like Gurgel D'Alfonso's"
  • "lishu-portfolio-gen ..."

And provides:

  • Studio description (required): name, director, city, discipline, titles and stories for a few works
  • Work images (optional): URL / upload / path. Can run without them (uses picsum placeholders)

If the user gives no work titles at all → you must ask at least which works they want to show. If the user gives only titles but no details → generate them yourself: for each work, write 1 lead sentence, 3 prose paragraphs, 6-8 spec lines, 3-6 picsum images, and a few credits. The tone must match the work type (book → binding / font → typography / object → still life / exhibition → exhibition visual).

Two Running Modes

Mode A · Claude Code / Local (Has File System)

  • Use Bash to list folders, sips to check image dimensions
  • Output location: ~/Desktop/{slug}-portfolio.html (single file, all images via URL)
  • If user provides local images: copy to ~/Desktop/{slug}-portfolio-images/ and change src to relative paths

Mode B · GLM / Online Chat (No File System)

  • User can drag in a zip; after unzip, 4 files are visible
  • Output only one complete HTML string wrapped in a ```html code block
  • User uploads images but provides no URL → use https://picsum.photos/id/{id}/{w}/{h} placeholders (with known working IDs)
  • Do not attempt to access local files, do not suggest command-line operations

Judgment: if you can't Read to see local images → default to Mode B.

File Roles

FileRoleHow to Use
reference.htmlComplete finished reference — Baiwu BAIWU with 6 worksLearn: list item wording, prose tone, spec vocabulary, JSON field density
template.htmlEmpty skeleton — Same CSS/JS/routing system, 2 example works + 20 SWAP markersModify it to produce final HTML
README.mdUser-facing instructionsModel doesn't need to read
SKILL.mdWorkflow for the model (this file)Must read

Core rule: All modifications based on template.html; learn how to write (tone, word count, tag vocabulary) from reference.html, but do not copy specific content.

Work Steps

1. Read Both HTML Files

  • First read reference.html to understand "what the finished product looks like" (especially the field density and prose tone of works-data JSON)
  • Then read template.html to find the 20 SWAP positions

Do not modify JS / do not modify CSS / do not modify the detail page routing system / do not modify the font import. SWAPs are all in HTML text and JSON data.

2. Parse User Input and Extract Info

Extract:

  • ATELIER_NAME_ZH — Studio Chinese name (2-4 characters best, e.g., '白屋' '素园' '墨记' '青庐' '拙轩')
  • PINYIN — Pinyin (5-6 uppercase English letters: BAIWU / SUYUAN / MOJI)
  • CHAR — Single character for 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 phrase (20-40 characters, in kaiti style tone)
  • YEAR_FOUNDED — Founding year (can use ganzhi: 乙未冬 / 甲辰春)

For each work, extract:

  • slug — URL ID, lowercase English hyphenated (kong-shan-ji / wu-ming-shu)
  • title_zh — Chinese title (2-5 characters best, concise is more elegant)
  • title_en — English subtitle (book title style: An Anthology of Empty Mountains)
  • year — Year or ganzhi year (甲辰 / 2024 / 2025 / 乙巳 / 2025)
  • tag — Top category, in square brackets, e.g., [ 诗集 · 装帧设计 ] / [ 字体设计 · 中草药图谱 ]
  • cover — Detail page large image URL
  • list line location — City, Year · Craft/Specification (visible on hover)
  • meta — 4 key-value pairs (detail page 4-column summary)
  • lead — 30-70 character opening text, can use <em>keyword</em> to emphasize one point
  • prose — 3-4 prose paragraphs, each 80-150 characters
  • specs — 6-10 specification rows (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 gives only one sentence / no story → invent it yourself: based on work title and type, write a lead and prose that match the work's character. Reference reference.html for tone — avoid marketing language, aim for "museum wall-text + studio notebook" 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

For each image, get (filename, w, h, aspect). Prefer portrait images for list thumbnails (4:3 container, portrait images look better).

4. Replace the 20 SWAPs

SWAPLocationContent
1<title>{ATELIER_NAME} {PINYIN} — {DIRECTOR}作品集 / Studio
2meta descriptionOne-line site description
3curtain single characterFirst character of studio name (e.g., '白')
4logo SVG single characterSame as SWAP-3
5logo SVG pinyin{PINYIN} uppercase
6main nav liUsually 3 items: Works / About / Contact
7brand-block Chinese name{ATELIER_NAME} with character spacing (e.g., 白&nbsp;&nbsp;屋)
8brand-block English{PINYIN} Studio · {CITY}
9taglineOne-line kaiti positioning phrase, 20-40 characters, can use <br> for line break
10N list itemsEach <a class="item" href="#work/{slug}"> containing num/project-name/en-name/location/photo-thumb
11N gallery itemsSame N works, more compact grid — slug must match list
12About title关&nbsp;于&nbsp;{name}<span class="en">About</span>
13About paragraphs1-3 kaiti paragraphs (founding background / director / design philosophy), each 60-120 characters
14About fact table4-6 items li (Founded/Location/Discipline/Director/Hours)
15Contact title来&nbsp;信<span class="en">Get in Touch</span>
16Contact paragraphs1-2 paragraphs inviting letters + reply time commitment
17Contact fact table4-6 items (E-mail/Phone/Address/Instagram/WeChat Official Account)
18rotating creditSite by {WHO} (usually the studio name)
19footer three sections© / ICP / social links
20works-data JSONComplete detail data for N works (critical!)

5. Write works-data JSON (Most Critical Step)

Each work must have an entry in the JSON array, and the slug must exactly match the #work/SLUG in the href of list/gallery cards.

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": [
    "段落一:诗稿来源 / 设计语境。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", "陈漱石(杭州·订书坊)"]
  ]
}

JSON pitfalls ⚠️:

  • In Chinese prose, use quotes → must use fullwidth 「...」 or "..." (U+201C / U+201D), cannot use ASCII " (will break JSON)
  • Do not write real line breaks inside JSON strings; to indicate paragraph breaks, add another item to the prose array
  • <em>word</em> in lead write the HTML tag directly — it will render as innerHTML
  • gallery layout must be one of three: g-wide (full width) / g-half (half) / g-third (one third)

6. Image Source Selection

  • picsum placeholders: use id/X form rather than seed/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
  • For the same work's cover/gallery, use adjacent IDs to create a consistent color palette
  • Do not use ?grayscale parameter (user expects images to be in color)

7. Chinese Studio Naming Inspiration (If User Doesn't Provide)

If user says "come up with one yourself" → choose 2 characters + ancient elegance:

  • Object category: 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
  • Lettering 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>. The model just needs to give a video path in the cover URL.

9. Report

Mode A: One-line report.

Generated ~/Desktop/baiwu-portfolio.html — 6 works, hover row to see thumbnails, click to enter detail page. Light/Dark at bottom left, list/gallery at top center.

Mode B: Directly output the complete HTML code block + one line of explanation.

Save the above as index.html and double-click to open. Hover over any work name to see the thumbnail appear on the right; click to jump to the detail page. To replace images, change the picsum URLs to your own image addresses.

Forbidden to Modify (Must Keep Intact)

  • Font import: @font-face loading Alimama DaoLiTi's woff2 URL (do not change font source)
  • CSS variable system: light/dark dual theme
  • All JS: theme toggle, view mode toggle, hover-row interaction, rotating credit, detail page hash routing applyRoute(), renderDetail()
  • <script id="works-data"> node must remain
  • <main id="detail-root"> must remain (detail page mount point)
  • body[data-view="home/detail"] and body[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 match exactly
  • JSON quotes: quotes within Chinese content must be fullwidth 「」 or "...", not ASCII "
  • Too many gallery images: max 6 per work; more will break layout
  • Prose too long: each paragraph 80-150 characters; over 200 hurts readability
  • List/gallery out of sync: must contain the same set of works (one-to-one correspondence)
  • picsum seed: use id/X not seed/X to avoid random IDs that might point to deleted images
  • Fewer than 3 works: acceptable; minimum 2 works can run
  • More than 8 works: recommended to split into two batches; too many list rows makes the page long
  • Drop cap: detail page .detail__prose p:first-of-type::first-letter uses DaoLiTi — the first paragraph must start with Chinese text (do not start with <em> or English)
  • Removing picsum color: images should remain colorful; do not add filter: grayscale() in CSS

Individual skills in this repo

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

Related Skills