open-design-landing
Atelier Zero 디자인 시스템으로 단일 페이지 에디토리얼 랜딩 사이트를 구축합니다(또는 슬라이드 데크 — 자매 스킬 open-design-landing-deck 참조). 특징: 따뜻한 종이 배경, Inter Tight + Playfair Display, 이탤릭 세리프 강조 스팬, 점선 구분선, 산호색 마침표 점, 스크롤 애니메이션, 16개의 초현실 콜라주 플레이트.
이 스킬은 OpenDesign 마케팅 페이지의 정식 레시피입니다. 예제 출력은 open-design에서 확인할 수 있습니다.
이 스킬은 완전히 파라미터화되어 있습니다. 에이전트는 사용자 브리프를 기반으로 하나의 inputs.json을 작성하고, 컴포저는 해당 JSON + 정식 styles.css를 사용하여 배포 가능한 아티팩트를 생성합니다.
inputs.json + styles.css 16개 이미지 슬롯
│ │
└──────────► scripts/compose.ts ◄────────────┘
│
▼
<out>/index.html (자체 포함)
<out>/assets/ (PNG 또는 SVG)
얻을 수 있는 것
다음을 모두 포함하는 단일 HTML 파일:
- 에디토리얼 상단바 (볼륨 / 호 / 언어 스트립), Headroom 스타일 스티키 내비게이션 (실시간 GitHub 별 개수 포함)
- 종이 질감 배경의 8개 로마 숫자 섹션: 히어로 (3개 통계 링 + 4단계 인덱스 포함), 소개, 역량 (4개 카드), 연구소 (5개 카드 + 필터 칩 + 진행 바), 방법 (4단계 + 썸네일), 주요 작업 (어두운 슬래브 + 2개 기울어진 카드), 사용 후기 (인용문 + 5개 파트너 글리프), CTA (리본 + 이메일 칩)
- 4개 링크 열 + 큰 이탤릭 세리프 키커 단어가 있는 푸터
- 모든 섹션에 스크롤 애니메이션 (IntersectionObserver,
prefers-reduced-motion준수) - 1280 / 1080 / 880 / 560 중단점에서 완전 반응형
워크플로 계약
다음 네 단계를 순서대로 실행하세요. 에이전트는 각 단계를 완료한 후 다음으로 넘어가야 하며, 내용을 임의로 작성하기보다 사용자에게 집중된 질문을 하는 것이 좋습니다.
1. 브랜드 입력 수집
AskQuestion(또는 UI에 해당하는 기능)을 사용하여 브랜드 브리프를 나누어 수집하세요. 전체 schema.ts를 사용자에게 덤프하지 마십시오. 답변을 형식화된 inputs.json에 매핑합니다.
순서대로 8개 질문 그룹:
| 그룹 | 스키마 필드 | 최소 답변 수 | 참고 |
|---|---|---|---|
| 1 | brand.{name,mark,tagline,description,location} | 5 | Mark = 단일 글리프 (Ø, ▲, ★…) |
| 2 | brand.{license,version,year,primary_url,contact_email} | 4 | URL은 필수; 라이선스 기본값 Apache-2.0 |
| 3 | nav[] (최대 5) | 3 | 선택적 카운트 배지 |
| 4 | hero.{label,headline,lead,primary,secondary,stats} | 모두 | Headline은 MixedText (sans+em+dot) |
| 5 | about + capabilities.cards[4] | 모두 | 4개 카드 × {num,tag,title,body} |
| 6 | labs.cards[5] + method.steps[4] | 모두 | 두 그리드 모두 고정 개수 |
| 7 | work.cards[2] + testimonial | 모두 | 5개 파트너 글리프를 인라인 SVG 경로 데이터로 |
| 8 | cta + footer.{columns[4],mega} | 모두 | Mega 키커는 헤드라인과 동일한 MixedText |
완전한 작업 예제는 inputs.example.json을 열어보세요 (OpenDesign 자체).
2. 이미지 전략 결정
| 전략 | 선택 시점 | 비용 / 지연 시간 |
|---|---|---|
placeholder | 첫 번째 패스. 데모. 내부 슬라이드. 아직 이미지 예산 없음. | $0, <1s |
generate | 최종 전달. 브랜드가 독창적인 콜라주를 원함. | ~$0.40, ~6분 |
bring-your-own | 사용자에게 아트 디렉션 PNG가 있음. assets_path에 배치. | $0, 0s |
inputs.imagery.strategy를 이에 따라 설정하세요.
placeholder — 프레임 모드
npx tsx scripts/placeholder.ts <out>/assets/
<out>/assets/에 16개의 .svg 파일 (호환성을 위해 .png 별칭 포함)을 작성합니다. 각 플레이스홀더는 슬롯 ID, 비율, 픽셀 크기, image-manifest.json의 프롬프트 힌트를 보여줍니다. 컴포저의 <img src='./assets/hero.png'> 등은 그대로 작동합니다.
generate — gpt-image-2 모드
FAL_KEY=... npx tsx scripts/imagegen.ts <inputs.json> --out=<out>/assets/
fal.ai의 openai/gpt-image-2 동기 엔드포인트를 슬롯별로 호출합니다. 프롬프트 구성: 스타일 앵커 (종이 콜라주 에디토리얼 시스템) + 브랜드 변수 (inputs.json에서 추출한 이름/내비게이션/헤드라인/이탤릭 강조) + 슬롯별 구성 (예: 잘린 석고 머리 + 아치를 통과하는 나무). 대상 파일이 이미 존재하는 슬롯은 건너뜁니다. --force를 전달하여 다시 렌더링하세요.
FAL_KEY가 없으면 스크립트는 프롬프트를 출력하므로 운영자가 수동으로 /gpt-image-fal 슬래시 커맨드 스킬을 통해 전달할 수 있습니다.
bring-your-own
assets/image-manifest.json 파일명과 일치하는 16개의 PNG를 inputs.imagery.assets_path에 배치하세요. 완료.
3. 아티팩트 컴포즈
npx tsx scripts/compose.ts <inputs.json> <out>/index.html
컴포저는 inputs.json과 ../styles.css를 읽고 자체 포함된 단일 HTML 파일을 작성합니다. 페이지에는 다음이 포함됩니다:
- 전체 Atelier Zero 스타일시트 (인라인)
- 스크롤 애니메이션을 위한
data-reveal속성이 있는 모든 섹션 마크업 - 인라인 IntersectionObserver 스크립트 (
apps/landing-page/app/_components/reveal-root.tsx미러링) - 인라인 Headroom 내비게이션 스크립트 (
header.tsx미러링) - 인라인 GitHub 별 개수 가져오기 (
brand.primary_url에서 자동 감지)
4. (선택 사항) 배포 가능한 Astro 사이트 미러링
프로덕션 출력을 위해 apps/landing-page/ 패키지를 포크하세요: 워크스페이스에 복사하고, app/page.tsx를 inputs.json의 내용과 정렬한 후, <out>/assets/*.png를 app/image-assets.ts / R2 URL에서 예상하는 경로로 복사하세요. pnpm --filter @open-design/landing-page build로 빌드하면 모든 CDN에 배포 가능한 정적 out/ 내보내기가 생성됩니다.
향후 버전에서는
inputs.json에서 전체apps/landing-page/트리를 한 번에 생성하는 컴포저를 번들로 제공할 수 있습니다. 그때까지는 포크-후-편집이 지원되는 경로입니다.
전달 전 자체 점검
완료로 표시하기 전에 에이전트는 다음을 반드시 확인해야 합니다:
-
<out>/index.html이 브라우저에서 콘솔 오류 없이 열리는가 - 16개 이미지 슬롯이 모두 로드되는가 (DevTools 네트워크 탭에 404 없음)
- 헤드라인 이탤릭 강조 스팬이 Playfair로 렌더링되는가 (sans 아님)
- 모든
displayh1/h2 끝에 산호색 마침표 점이 나타나는가 - 위에서 아래로 스크롤; 모든 섹션이 한 번씩 애니메이션되는가
- 880px 및 560px로 리사이즈; 가로 스크롤 없음, 겹침 없음
-
prefers-reduced-motion: reduce(DevTools → Rendering)가 전환을 깔끔하게 비활성화하는가 - Lighthouse: 대비 AA, font-display swap, 히어로에 레이아웃 시프트 없음 (CLS < 0.05)
이 스킬의 파일
design-templates/open-design-landing/
├── SKILL.md # 이 계약
├── README.md # 빠른 시작
├── schema.ts # 형식화된 입력 (단일 진실 공급원)
├── styles.css # Atelier Zero 스타일시트 (단일 진실 공급원)
├── inputs.example.json # 작업 예제로서의 OpenDesign
├── example.html # 정식 렌더링 (inputs.example.json에서 재생성됨)
├── scripts/
│ ├── compose.ts # inputs.json + styles.css → index.html
│ ├── imagegen.ts # gpt-image-2 래퍼 (fal.ai)
│ └── placeholder.ts # SVG 종이 질감 프레임
└── assets/
├── *.png # 16개 콜라주 플레이트 (OpenDesign 인스턴스)
├── image-manifest.json # 슬롯 → 파일/크기/프롬프트 매핑
└── imagegen-prompts.md # 사람이 읽을 수 있는 프롬프트 팩
경계
- 새로운 색상이나 서체를 만들지 마십시오. 토큰은
design-systems/atelier-zero/DESIGN.md에 있습니다; 여기에 새 램프를 추가하기 전에 디자인 시스템을 확장하세요. - 생성된 마크업에서
data-reveal속성을 제거하지 마십시오. 이것이 없으면 페이지가 정적이고 죽은 느낌이 듭니다. - 컴포즈된 HTML을 자체 스타일시트 순서를 주입하는 프레임워크로 감싸지 마십시오. Atelier Zero는 종이 질감과 사이드 레일의 z-인덱스를 위해 스타일시트 순서 캐스케이드에 의존합니다.
- Astro 랜딩 페이지 포크에 별도의 스타일시트 파일을 추가하지 마십시오.
styles.css를 그대로app/globals.css에 복사하여 시각적 일관성을 유지하세요.
함께 보기
design-systems/atelier-zero/DESIGN.md— 토큰 사양.apps/landing-page/— 배포 가능한 Astro 정적 대응.design-templates/open-design-landing-deck/— 동일한 디자인 시스템을 재사용하는 자매 슬라이드 스킬.
