Communitygithub.com

AiCurv/ADBCommander — 中式工作室/隶书作品集生成器

사용자의 자연어 설명을 바탕으로 '아티에 스튜디오' 스타일의 세련된 한 페이지 중국식 포트폴리오 웹사이트(.html)를 생성합니다. 가로 텍스트 행, 호버 시 나타나는 썸네일, 'Alimama DaoLiTi' 서체, 라이트/다크 테마, 해시 기반 상세 페이지를 특징으로 합니다.

ADBCommander — 中式工作室/隶书作品集生成器란 무엇인가요?

이 스킬은 사용자의 간단한 설명(스튜디오 이름, 디렉터, 분야, 작품 목록 등)을 바탕으로 완전한 기능을 갖춘 중국식 '아티에' 스타일 포트폴리오 웹사이트를 단일 HTML 파일로 생성합니다. 'AiCurv/ADBCommander'는 독특한 시각적 아이덴티티를 제공합니다: 가로로 배열된 작품 목록, 마우스를 올리면 오른쪽에 큰 썸네일이 나타나는 인터랙션, CDN을 통해 제공되는 'Alimama DaoLiTi' 서체의 굵은 타이포그래피, 그리고 라이트/다크 모드 테마를 지원합니다. 또한 각 작품의 상세 페이지를 해시 라우팅(#work/slug)으로 구현하여 완성도 높은 사용자 경험을 제공합니다. 이 스킬은 두 가지 모드로 작동합니다: Claude Code와 같은 로컬 환경(파일 시스템 접근 가능)에서는 생성된 HTML 파일을 `~/Desktop/`에 저장하고 로컬 이미지를 복사합니다. 반면, GLM이나 온라인 채팅 환경(파일 시스템 없음)에서는 HTML 문자열을 코드 블록으로 출력하여 사용자가 직접 저장할 수 있도록 합니다. 핵심은 `template.html`이라는 빈 껍데기 파일을 기반으로 20개의 SWAP 마커를 사용자의 데이터로 채워나가는 방식이며, `reference.html`에서 적절한 어조와 데이터 밀도를 학습합니다. 특히 'works-data' JSON 배열을 정확하게 구성하고, 목록/갤러리 항목의 슬러그(slug)와 해시 링크를 일치시키는 것이 중요합니다.

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

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

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

문서

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

한 줄 요약

가로 텍스트 행 + hover 시 오른쪽에 큰 이미지 표시 + Alimama DaoLiTi 예서체 예술적 큰 글자 + 흑백 순수 색상 + light/dark + 해시 라우팅 상세 페이지 + 목록/화첩 뷰.

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

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

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

언제 트리거되나

사용자가 다음과 같이 말할 때:

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

그리고 다음을 제공할 때:

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

사용자가 작품 제목을 전혀 주지 않았다면 → 최소한 어떤 작품들을 전시할지 한 번은 물어봐야 합니다. 사용자가 제목만 주고 상세 정보는 주지 않았다면 → 직접 생성합니다: 각 작품마다 1개의 lead + 3개의 prose 문단 + 6-8개의 specs + 3-6개의 picsum 이미지 + 여러 credits를 생성합니다. 어조는 작품 유형과 일치해야 합니다 (책 → 제본 / 글자 → 서체 / 물건 → 정물 / 전시 → 전시 비주얼).

두 가지 실행 모드

모드 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 사용).
  • 로컬 파일에 접근하려 하지 말고, 명령줄 작업을 제안하지 마세요.

판단: Read 로 로컬 이미지를 볼 수 없다면 → 기본적으로 B 모드로 진행합니다.

파일 분담

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

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

작업 단계

1. 두 개의 HTML 읽기

  • 먼저 reference.html을 읽어 "완성된 후의 모습"을 파악합니다 (특히 works-data JSON의 필드 밀도와 prose 어조).
  • 그 다음 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 행 location — 도시, 연도 · 공정/사양 (hover 시 표시)
  • 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쌍의 직책/이름

사용자가 한 마디만 하고/이야기를 주지 않았다면 → 직접 만듭니다: 작품 제목과 유형에 따라 작품 성격에 맞는 lead와 prose를 작성합니다. 어조는 reference.html을 참조하세요 — 마케팅 언어가 아닌, '박물관 벽 텍스트 + 스튜디오 노트' 느낌이어야 합니다 (절제되고, 구체적이며, 느리고, 수공예적 흔적이 있는).

3. 작품 목록 작성 + 크기 확인 (모드 A만 해당)

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

각 이미지의 (파일명, w, h, aspect)를 얻습니다. list 썸네일로는 세로 이미지를 우선 선택합니다 (4:3 컨테이너, 세로 이미지가 더 잘 어울림).

4. 20개 SWAP 교체

SWAP위치내용
1<title>{ATELIER_NAME} {PINYIN} — {DIRECTOR}作品集 / Studio
2meta description한 줄 웹사이트 소개
3curtain 단일 글자스튜디오 이름 첫 글자 (예: '白')
4logo SVG 내 단일 글자SWAP-3과 동일
5logo 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와 일치해야 함
12about 제목关&nbsp;于&nbsp;{name}<span class="en">About</span>
13about 문단1-3개 해서체 문단 (설립 배경 / 대표 / 디자인관), 각 문단 60-120자
14about 사실표4-6개 li (Founded/Location/Discipline/Director/Hours)
15contact 제목来&nbsp;信<span class="en">Get in Touch</span>
16contact 문단1-2개 초대 편지 + 답장 기간 약속 문단
17contact 사실표4-6개 li (E-mail/Phone/Address/Instagram/公众号)
18rotating creditSite by {WHO} (보통 스튜디오 이름)
19footer 세 블록© / ICP / 소셜 링크
20works-data JSONN개 작품의 완전한 상세 데이터 (중요!)

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

각 작품은 JSON 배열에 하나의 항목으로 존재해야 하며, slug는 list/gallery 카드의 #work/SLUG href와 완전히 일치해야 합니다.

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": [
    "문단 1: 시고 출처 / 디자인 맥락. 80—150자.",
    "문단 2: 제작 과정의 핵심 결정 — 서체, 종이, 제본 선택.",
    "문단 3: 최종 결과 / 독자에게 남기는 느낌."
  ],
  "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 오류 주의 ⚠️:

  • 중국어 prose 내에서 인용부호를 사용해야 하는 경우 → 전각 「...」 또는 "..." (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인 경우, 상세 페이지는 자동으로 <img> 대신 <video autoplay muted loop>를 사용합니다. 모델은 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, 상세 페이지 hash 라우팅 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 다섯 개의 고정 위치 요소

오류 발생 시 체크리스트

  • 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 사용, 무작위 ID가 삭제된 이미지를 가리키는 것을 방지
  • 작품 < 3개: 가능, 최소 2개로도 실행 가능
  • 작품 > 8개: 두 번에 나누어 생성하는 것이 좋음, list 행이 너무 많으면 페이지가 길어짐
  • 첫 글자 장식: 상세 페이지의 .detail__prose p:first-of-type::first-letter 는 DaoLiTi 서체 사용 — 첫 번째 문단은 반드시 중국어로 시작해야 함 (<em> 이나 영어로 시작 금지)
  • picsum 컬러 제거 금지: 이미지는 컬러를 유지해야 하며, CSS에 filter: grayscale() 을 추가하지 마세요

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.

관련 스킬