Communitygithub.com

lishu-portfolio-gen — 中式工作室作品集(横排文字 + 详情页)

단일 HTML 파일로 중국 아틀리에 스타일 포트폴리오 웹사이트를 생성합니다. 가로 행 목록과 호버 시 오른쪽에 썸네일이 나타나는 상호작용, 예술적 예서체 'Alimama DaoLiTi', 라이트/다크 테마, 해시 라우팅 상세 페이지를 제공합니다.

lishu-portfolio-gen — 中式工作室作品集(横排文字 + 详情页)란 무엇인가요?

이 스킬은 클로드 코드, 커서, 코덱스 등 AI 에이전트가 중국 전통 공방이나 스튜디오를 위한 단일 HTML 포트폴리오 웹사이트를 생성하도록 돕습니다. 핵심 기능은 가로 텍스트 행 목록과 호버 시 오른쪽에 큰 이미지가 나타나는 상호작용, 중국 서예 예서체 'Alimama DaoLiTi' (CDN 로드), 라이트/다크 테마 전환, 그리고 해시 라우팅 기반 상세 페이지입니다. 이 스킬은 `template.html` 파일에 있는 20개의 SWAP 마커를 채워 결과 HTML을 생성합니다. 작업 흐름은 사용자 입력(예: '중식 공방 포트폴리오 만들어 줘')에서 스튜디오 이름, 책임자, 분야, 작품 정보를 추출하고, 두 가지 모드로 실행됩니다: (A) Claude Code/로컬 환경에서는 `~/Desktop/`에 파일을 쓰고 로컬 이미지를 처리하며, (B) GLM/온라인 채팅 환경에서는 HTML 코드 블록을 인라인으로 출력하고 picsum.photos로 이미지를 대체합니다. 참고 `reference.html`은 완성된 예시('BAIWU 6개 작품')를 제공하여 모델이 적절한 어조와 데이터 밀도를 학습하도록 돕습니다. 주요 제약 사항은 CSS, JS, 라우팅 시스템, 서체 가져오기를 수정하지 말아야 하며, 모든 JSON 데이터 필드(slug, title_zh, lead, prose, specs, gallery, credits)를 정확하게 채우고, JSON 내 중국어 인용 부호는 전각 문자(「」)를 사용해야 합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ansaribilal14/design-showcase/tree/HEAD/skills/design/design-templates/portfolio-detail

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

portfolio-detail — 중국식 스튜디오 / 예서체 포트폴리오 (2차 상세 페이지 포함)

한 줄 특징

가로 텍스트 행 + 호버 시 오른쪽 큰 이미지 표시 + Alimama DaoLiTi 예술 큰 글자 + 흑백 단색 + light/dark + 해시 라우팅 상세 페이지 + 목록/화첩 이중 보기.

다른 포트폴리오 스킬과의 차이점

스킬핵심 모드적합한 대상
portfolio-gen무제한 드래그 캔버스 + 타일 배치사진작가 / 그래픽 디자이너의 샘플 전시
portfolio-museum-gen히어로 캐러셀 + 큰 카드 + 폭포수 + 상세 페이지 (영상 큐레이션 느낌)영상/영상/설치 예술가
industrial-archive-gen검은 프레임 넘김 표지 + 사이드바 아카이브 + 북유럽 산업실물 제품 / 기물 / 하드웨어
lishu-portfolio-gen가로 텍스트 행 + 호버 시 오른쪽 썸네일 + 예서체 큰 글자 + 중국식 절제제본 / 서체 / 전시 / 정물 / 한약재 / 차 / 도자기 / 목공 / 종이 / 향

사용자 프로젝트가 '책 / 서체 / 전시 / 정물 / 한약재 / 차 / 도자기 / 목공 / 종이 / 향'처럼 절제되고 우아한 분위기가 필요하면 이 스킬을 사용하세요.

트리거 시점

사용자가 말할 때:

  • "중국식 / 동양식 / 클래식 스타일의 포트폴리오 만들어 줘"
  • "예서체 스타일의 웹사이트 / 스튜디오 홈페이지 만들어 줘"
  • "백옥(白屋) 스타일 포트폴리오 만들어 줘" / "Gurgel D'Alfonso 같은 가로 목록 웹사이트 만들어 줘"
  • "lishu-portfolio-gen ..."

그리고 제공:

  • 스튜디오 설명 (필수): 이름, 대표, 도시, 분야, 작품 제목과 이야기
  • 작품 이미지 (선택): URL / 업로드 / 경로. 없어도 실행 가능 (picsum으로 대체)

사용자가 작품 제목을 전혀 주지 않았다면 → 최소한 전시할 작품이 무엇인지 한 번 물어봐야 함. 사용자가 제목만 주고 상세 정보는 없으면 → 직접 작성: 각 작품마다 1문장 리드 + 3단락 산문 + 6-8줄 사양표 + 3-6장 picsum 이미지 + 몇 개의 크레딧. 어조는 작품 유형과 일치 (책 → 제본 / 글자 → 서체 / 물건 → 정물 / 전시 → 전시 비주얼).

두 가지 실행 모드

모드 A · Claude Code / 로컬 (파일 시스템 있음)

  • Bash로 폴더 목록 확인, sips로 각 이미지의 너비/높이 확인
  • 출력 위치: ~/Desktop/{slug}-portfolio.html (단일 파일, 모든 이미지는 URL로 처리)
  • 사용자가 로컬 이미지를 제공하면 → ~/Desktop/{slug}-portfolio-images/로 복사하고 src를 상대 경로로 변경

모드 B · GLM / 온라인 대화 (파일 시스템 없음)

  • 사용자가 zip 압축 파일을 드래그하여 풀면 4개의 파일을 볼 수 있음
  • 완전한 HTML 문자열 하나만 출력, ```html 코드 블록 안에 포함
  • 사용자가 이미지를 업로드했지만 URL이 없으면 → 모두 https://picsum.photos/id/{id}/{w}/{h}로 대체 (알려진 ID 사용)
  • 로컬 파일에 접근하거나 명령줄 작업을 제안하지 말 것

판단: 로컬 이미지를 읽을 수 없으면 → 기본적으로 B 모드 실행.

파일 분담

파일역할사용법
reference.html완성된 참고 자료 — 백옥(BAIWU) 6개 작품참고: 목록 항목의 표현, 산문 어조, 사양 용어, JSON 필드 밀도
template.html빈 뼈대 — 동일한 CSS/JS/라우팅 시스템, 2개 예시 + 20개 SWAP 마커이것을 바탕으로 수정하여 최종 HTML 출력
README.md사용자 관점의 사용 설명서모델은 볼 필요 없음
SKILL.md모델용 작업 흐름 (본 파일)필독

핵심 규칙: 모든 변경은 template.html을 기반으로 함; reference.html에서 작성법 (어조, 글자 수, 태그 용어)을 배우되, 구체적인 내용은 복사하지 말 것.

작업 단계

1. 두 HTML 파일 읽기

  • 먼저 reference.html을 읽어 "완성된 모습"을 파악 (특히 works-data JSON의 필드 밀도와 산문 어조)
  • 그다음 template.html을 읽어 20개의 SWAP 위치 찾기

JS / CSS / 상세 페이지 라우팅 시스템 / 서체 가져오기를 수정하지 말 것. SWAP은 모두 HTML 텍스트와 JSON 데이터에 있음.

2. 사용자 입력을 분석하여 정보 추출

추출:

  • ATELIER_NAME_ZH — 스튜디오 중국어 이름 (2-4자가 적합, 예: '白屋', '素园', '墨记', '青庐', '拙轩')
  • PINYIN — 로마자 표기 (5-6개 영문자, 모두 대문자: BAIWU / SUYUAN / MOJI)
  • CHAR — 로고용 단일 글자 (보통 스튜디오 이름 첫 글자: 白 / 素 / 墨 / 青 / 拙)
  • CITY — 도시
  • DIRECTOR_ZH / DIRECTOR_EN — 대표 이름 + 로마자 표기
  • DISCIPLINE — 3개 분야 단어 ("装帧 · 字体 · 静物")
  • TAGLINE — 한 줄 포지셔닝 (20-40자, 해서체 느낌)
  • YEAR_FOUNDED — 설립 연도 (간지 사용 가능: 乙未冬 / 甲辰春)

각 작품 추출:

  • slug — URL ID, 소문자 영어 하이픈 연결 (kong-shan-ji / wu-ming-shu)
  • title_zh — 중국어 제목 (2-5자가 적합, 간결할수록 스타일 있음)
  • title_en — 영어 부제 (책 제목 스타일: An Anthology of Empty Mountains)
  • year — 연도 또는 간지년 (甲辰 / 2024 / 2025 / 乙巳 / 2025)
  • tag — 상단 분류, 대괄호로 감쌈, 예: [ 诗集 · 装帧设计 ] / [ 字体设计 · 中草药图谱 ]
  • cover — 상세 페이지 큰 이미지 URL
  • list 행 위치 — 도시, 연도 · 공정/사양 (호버 시 표시)
  • meta — 4개 키-값 쌍 (상세 페이지 4열 요약)
  • lead — 30-70자 첫머리 큰 글, 한 곳에 <em>키워드</em>로 강조 가능
  • prose — 3-4단락 산문, 각 80-150자
  • specs — 6-10행 사양표 (판형/종이/제본/서체/인쇄량/인쇄/공정/가격 등)
  • gallery — 3-6장 이미지, layout은 셋 중 하나: g-wide / g-half / g-third
  • credits — 4-7쌍의 직책/이름

사용자가 한 문장만/이야기를 안 줬다면 → 직접 창작: 작품 제목과 유형에 맞는 리드와 산문 작성. 어조는 reference.html 참고 — 마케팅 언어 말고, '박물관 벽면 텍스트 + 스튜디오 노트' 느낌 (절제되고, 구체적이며, 느리고, 수공의 흔적).

3. 작품 나열 + 크기 확인 (모드 A만)

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

각 이미지의 (filename, w, h, aspect) 획득. 세로 이미지를 list 썸네일로 우선 선택 (4:3 컨테이너에 세로 이미지가 더 잘 보임).

4. 20개 SWAP 교체

SWAP위치내용
1<title>{ATELIER_NAME} {PINYIN} — {DIRECTOR} 포트폴리오 / Studio
2meta description웹사이트 한 줄 설명
3curtain 단일 글자스튜디오 이름 첫 글자 (예: '白')
4로고 SVG 내 단일 글자SWAP-3과 동일
5로고 SVG 내 로마자 표기{PINYIN} 대문자
6메인 내비게이션 li보통 3항목: 작품 / 소개 / 연락처
7brand-block 중국어 이름{ATELIER_NAME} 글자 사이 공백 (예: 白&nbsp;&nbsp;屋)
8brand-block 영어{PINYIN} Studio · {CITY}
9tagline해서체 한 줄 포지셔닝, 20-40자, <br>로 줄바꿈 가능
10list 항목 N개각 <a class="item" href="#work/{slug}">는 num/project-name/en-name/location/photo-thumb 포함
11gallery 항목 N개동일한 N개 작품, 더 조밀한 그리드 — slug는 list와 일치해야 함
12소개 제목关&nbsp;于&nbsp;{name}<span class="en">About</span>
13소개 단락1-3단락 해서체 (설립 배경 / 대표 / 디자인 철학), 각 60-120자
14소개 정보 표4-6개 li (Founded/Location/Discipline/Director/Hours)
15연락처 제목来&nbsp;信<span class="en">Get in Touch</span>
16연락처 단락1-2단락 편지 초대 + 답장 주기 약속
17연락처 정보 표4-6개 항목 (E-mail/Phone/Address/Instagram/公众号)
18rotating creditSite by {WHO} (보통 스튜디오 이름)
19footer 세 블록© / ICP / 소셜 링크
20works-data JSONN개 작품의 전체 상세 데이터 (중요!)

5. works-data JSON 작성 (가장 중요한 단계)

각 작품은 JSON 배열에 한 항목씩 있어야 하며, slug는 list/gallery 카드 href의 #work/SLUG와 완전히 일치해야 함.

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 × 195mm"}
  ],
  "lead": "산에 관한 서른여섯 편의 시. 우리는 독자가 책을 펼쳤을 때 먼저 <em>바람 소리</em>를 듣고, 그다음 글자를 읽는 책을 만들고 싶었습니다.",
  "prose": [
    "단락 1: 시고 출처 / 디자인 맥락. 80—150자.",
    "단락 2: 제작 중 핵심 결정 — 서체, 종이, 제본 선택.",
    "단락 3: 최종 완성 / 독자에게 남는 느낌."
  ],
  "specs": [
    ["판형 / Format", "130 × 195mm"],
    ["페이지 / 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 실수 주의 ⚠️:

  • 중국어 산문에서 인용 부호는 전각 「...」 또는 "..."(U+201C / U+201D)을 사용해야 함. ASCII "를 사용하면 JSON이 깨짐
  • JSON 문자열에 실제 줄바꿈을 넣지 말 것; 단락을 구분하려면 prose 배열에 항목을 추가할 것
  • lead에서 <em>단어</em>는 HTML 태그를 직접 작성 — 렌더링 시 innerHTML로 출력됨
  • gallery layout은 셋 중 하나만: g-wide (전체 폭) / g-half (절반) / g-third (1/3)

6. 이미지 소스 선택

  • picsum 대체: seed/X 형식보다 id/X 형식 사용 (더 안정적). 잘 알려진 좋은 ID: 0, 20, 40, 51, 64, 76, 88, 91, 96, 119, 121, 130, 143, 145, 158, 164, 165, 175, 177, 180, 187, 195, 200
  • 같은 작품의 cover/gallery는 인접한 ID 몇 개를 사용하면 일관된 색조를 만들 수 있음
  • ?grayscale 매개변수를 사용하지 말 것 (사용자는 이미지가 컬러이길 원함)

7. 중국 스튜디오 명명 영감 (사용자가 정하지 않은 경우)

사용자가 "당신이 직접 지어달라"고 하면 → 2자 + 고풍스럽게:

  • 물명류: 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
  • 글자 행류: 素白 / 子衿 / 砚池 / 半山 / 寻常 / 浮云
  • "工作室 / 디자인 / Studio" 같은 기능적 단어는 피하고, 이름 자체가 시가 되도록

8. 비디오 지원

작품 cover가 .mp4 / .webm / .mov이면 상세 페이지에서 자동으로 <video autoplay muted loop>를 <img> 대신 사용. 모델은 cover URL에 비디오 경로만 제공하면 됨.

9. 보고

모드 A: 한 줄 보고.

~/Desktop/baiwu-portfolio.html 생성 완료 — 6개 작품, 호버 시 썸네일 확인, 클릭 시 상세 페이지. Light/Dark는 왼쪽 아래, 목록/화첩은 상단 중앙.

모드 B: 완전한 HTML 코드 블록 + 한 줄 설명.

위 내용을 index.html로 저장하고 더블 클릭하여 열기. 마우스를 작품명 위로 옮기면 오른쪽에 썸네일이 나타나고, 클릭하면 상세 페이지로 이동. 이미지를 바꾸려면 picsum URL을 자신의 이미지 주소로 교체.

강제 유지 (변경 불가)

  • 서체 가져오기: @font-face로 Alimama DaoLiTi의 woff2 URL 로드 (서체 소스 변경 금지)
  • CSS 변수 시스템: light/dark 이중 테마
  • 모든 JS: theme toggle, view mode toggle, hover-row 상호작용, rotating credit, 상세 페이지 해시 라우팅 applyRoute(), renderDetail()
  • <script id="works-data"> 노드 반드시 유지
  • <main id="detail-root"> 반드시 유지 (상세 페이지 마운트 지점)
  • body[data-view="home/detail"] 및 body[data-mode="list/gallery"] 상태 시스템
  • #logo / #main-menu / .theme-toggle / #project-view / #svp-credit 5개 고정 위치 요소

실수 체크리스트

  • slug 불일치: list 항목 #work/kong-shan-ji ↔ gallery 항목 #work/kong-shan-ji ↔ JSON "slug": "kong-shan-ji" — 세 곳이 완전히 일치해야 함
  • JSON 인용 부호: 중국어 내용의 인용 부호는 반드시 전각 「」 또는 "..." 사용, ASCII " 금지
  • gallery 너무 많음: 작품당 최대 6장 이미지, 초과 시 레이아웃이 깨짐
  • prose 너무 김: 각 단락 80-150자, 200자 초과 시 가독성 저하
  • list / gallery 불일치: 반드시 동일한 작품 세트를 포함해야 함 (일대일 대응)
  • picsum seed: seed/X 말고 id/X 사용, 삭제된 이미지를 참조하지 않도록 방지
  • 작품 < 3개: 가능, 최소 2개로 실행 가능
  • 작품 > 8개: 두 묶음으로 나누는 것을 권장, list 행이 너무 많으면 페이지가 길어짐
  • 첫 글자 장식: 상세 페이지의 .detail__prose p:first-of-type::first-letter는 도예체 사용 — 첫 번째 단락은 반드시 중국어로 시작해야 함 (<em>이나 영어로 시작 금지)
  • picsum 컬러 제거: 이미지는 컬러 유지, CSS에 filter: grayscale() 추가 금지

Individual skills in this repo

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

관련 스킬