Communitygithub.com

Cetc2211/AcTR-app

한 줄로 된 중국식 아틀리에 포트폴리오 웹사이트(가로 목록 + 호버 시 썸네일 표시, CDN의 'Alimama DaoLiTi' 서체, 밝음/어두움 테마, 해시 라우팅 상세 페이지)를 단일 HTML 파일로 생성합니다.

AcTR-app란 무엇인가요?

이 스킬은 자연어 설명만으로 중국식 아틀리에(스튜디오) 포트폴리오 웹사이트를 단일 HTML 파일로 생성합니다. '중식 스튜디오 포트폴리오', '해서체 포트폴리오' 등의 트리거 구문을 인식하며, Claude Code(로컬 파일 시스템)와 GLM/온라인 채팅(인라인 HTML 출력) 모두에서 작동합니다. 생성되는 사이트는 가로 목록에 작품명이 나열되고, 마우스를 올리면 오른쪽에 썸네일이 나타납니다. 각 작품은 해시 라우팅을 통해 상세 페이지(표지, 리드, 산문, 사양, 갤러리, 크레딧)를 제공합니다. 아틀리에 이름, 주소, 분야, 수년간의 작품 등 정보를 추출하여 템플릿(template.html)을 기반으로 개성 있고 일관된 스타일을 구현합니다. 참고 자료(reference.html)의 어조와 밀도를 학습하지만, 구체적인 내용은 복사하지 않습니다. 스킬은 CSS, JS, 라우팅 시스템을 수정하지 않고 데이터(HTML 텍스트와 JSON)만 교체하도록 설계되어, 안정적이고 예측 가능한 결과를 보장합니다.

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

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

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

문서

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

한 줄 요약

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

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

스킬핵심 모드적합한 대상
portfolio-gen무한 드래그 캔버스 + tile 평면 배열사진작가 / 그래픽 디자이너 샘플 전시
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 — 도시, 연도 · 공예/사양 (호버 시 표시)
  • meta — 4개의 키-값 쌍 (상세 페이지 4열 요약)
  • lead — 30-70자의 시작 큰 글자, <em>키워드</em>로 한 곳 강조 가능
  • prose — 3-4개의 산문 단락, 각 80-150자
  • specs — 6-10행 사양표 (판형/종이/제본/서체/인쇄량/인쇄/공예/가격 등)
  • gallery — 3-6개의 이미지, 레이아웃은 세 가지 중 하나: g-wide / g-half / g-third
  • credits — 4-7쌍의 직위/이름

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

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 단일 글자스튜디오 이름 첫 글자 (예: 「白」)
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와 일치해야 함
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 × 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 오류 주의 ⚠️:

  • 중국어 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. 비디오 지원

작품 커버가 .mp4 / .webm / .mov인 경우, 상세 페이지는 자동으로 <video autoplay muted loop>를 사용하여 <img>를 대체합니다. 모델은 cover URL에 비디오 경로를 제공하기만 하면 됩니다.

9. 보고

모드 A: 한 줄 보고서.

~/Desktop/baiwu-portfolio.html 생성 완료 — 6개 작품, hover 행으로 썸네일 보기, 클릭하여 상세 페이지 진입. 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 다섯 개의 고정 위치 요소

오류 빠른 확인

  • 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는 해서체 사용 — 첫 번째 단락은 반드시 중국어로 시작해야 합니다 (<em> 또는 영어로 시작 금지)
  • picsum 컬러 제거 금지: 이미지는 컬러를 유지해야 하며, CSS에 filter: grayscale()을 추가하지 마십시오

Individual skills in this repo

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

Cetc2211/AcTR-app

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.

Cetc2211/AcTR-app

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.

Cetc2211/AcTR-app

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.

Cetc2211/AcTR-app

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

Cetc2211/AcTR-app

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.

Cetc2211/AcTR-app

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.

Cetc2211/AcTR-app

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.

관련 스킬