name: open-design-landing
description: >
Produce a world-class single-page editorial landing site in the
Atelier Zero visual language (Monocle / Apartamento / Études editorial
collage) — the same aesthetic Open Design uses for its own marketing
surface. The agent fills a typed inputs.json from a brand brief,
optionally generates 16 collage assets via gpt-image-2, then runs a
pure-function composer that emits a self-contained HTML file; a
separate path can mirror the Astro marketing site in apps/landing-page/.
Drop-in scroll-reveal motion and a
Headroom-style sticky nav are wired automatically.
triggers:
- landing page
- 落地页
- editorial site
- magazine layout
- hero collage
- atelier zero
- open design landing
od:
category: brand-page
surface: web
scenario: marketing
featured: 1
audience: founders, design studios, OSS maintainers
tone: editorial, restrained, premium
scale: viewport-anchored long-form single page
craft:
requires:
- pixel-discipline
- typographic-rhythm inputs:
- id: brand label: Brand identity description: Name, mark, tagline, location, languages, license, repo url. schema_path: ./schema.ts#BrandBlock
- id: nav label: Navigation links description: Up to 5 nav entries, each with optional count badge. schema_path: ./schema.ts#NavLink
- id: hero label: Hero copy + 3 stat rings + 4-step index schema_path: ./schema.ts#HeroBlock
- id: about label: Manifesto / about block schema_path: ./schema.ts#AboutBlock
- id: capabilities label: 4 capability cards schema_path: ./schema.ts#CapabilitiesBlock
- id: labs label: 5 lab cards + filter pills schema_path: ./schema.ts#LabsBlock
- id: method label: 4 method steps with thumbnails schema_path: ./schema.ts#MethodBlock
- id: work label: 2 selected-work cards on dark slab schema_path: ./schema.ts#WorkBlock
- id: testimonial label: Pull quote + author + 5 partner glyphs schema_path: ./schema.ts#TestimonialBlock
- id: cta label: Closing CTA + ribbon schema_path: ./schema.ts#CTABlock
- id: footer label: Brand description + 4 link columns + mega kicker schema_path: ./schema.ts#FooterBlock
- id: imagery
label: Image strategy (generate / placeholder / bring-your-own)
schema_path: ./schema.ts#ImageryConfig
parameters:
output_format:
type: enum
values: [standalone-html, nextjs-app, both]
default: standalone-html
description: >
standalone-htmlwrites one self-contained .html (CSS inlined, scripts inline, images relative).nextjs-appis the historical enum label for cloning the Astro-basedapps/landing-page/tree and wiring the same content.bothwrites both products into the output dir. image_strategy: type: enum values: [generate, placeholder, bring-your-own] default: placeholder description: >generatecalls gpt-image-2 (fal.ai or Azure) for all 16 slots.placeholderwrites paper-textured SVG frames so the layout is fully visible without an image budget.bring-your-ownassumes the user has dropped 16 PNGs atimagery.assets_pathalready. image_provider: type: enum values: [fal, azure] default: fal description: Provider forimage_strategy: generate. fal.ai is faster. outputs: - path: /index.html when: output_format in [standalone-html, both] description: Self-contained HTML with Atelier Zero CSS inlined.
- path: /assets/*.png (or *.svg) description: 16 collage assets, generated or placeholder per strategy.
- path: /nextjs/ when: output_format in [nextjs-app, both] description: Astro static tree mirroring apps/landing-page (folder name is historical). capabilities_required:
- file-write
- http-fetch # only when image_strategy=generate
- node-runtime # tsx or compatible example_prompt: | Build me an editorial landing page for "Lumen Field", an indie studio shipping a soundscape app for focus. Coral accent, Berlin coordinates, mention the iOS Beta TestFlight, three stats: 12 soundscapes / 4 presets / 1 daily ritual. Use the placeholder image strategy.
open-design-landing
Atelier Zero 디자인 시스템으로 단일 페이지 에디토리얼 랜딩 사이트(또는 슬라이드 데크 - 자매 스킬 open-design-landing-deck 참조)를 구축하세요: 따뜻한 종이 배경, Inter Tight + Playfair Display, 이탤릭 세리프 강조 스팬, 점선 가이드 라인, 코랄 종료 점, 스크롤 리빌 모션, 16개의 초현실 콜라주 플레이트.
이것은 Open Design 마케팅 페이지의 정식 레시피입니다 — 예제 출력은 open-design에서 직접 보실 수 있습니다.
이 스킬은 완전히 매개변수화되어 있습니다. 에이전트는 사용자 브리프에서 하나의 타입이 지정된 inputs.json을 채우고, 컴포저는 해당 JSON + 표준 styles.css를 배포 가능한 아티팩트로 변환합니다.
inputs.json + styles.css 16 image slots
│ │
└──────────► scripts/compose.ts ◄────────────┘
│
▼
<out>/index.html (self-contained)
<out>/assets/ (PNG or SVG)
얻을 수 있는 것
다음을 모두 포함하는 단일 HTML 파일:
- 에디토리얼 탑바(볼륨 / 이슈 / 언어 스트립), Headroom 스타일의 고정 내비게이션(실시간 GitHub 별 개수 포함).
- 종이 질감 배경의 8개 로마 숫자 섹션: 히어로(3개의 통계 링 + 4단계 인덱스), 소개, 역량(4개 카드), 연구소(5개 카드 + 필터 알약 + 진행 막대), 방법(4단계 + 썸네일), 선별된 작업(어두운 슬래브 + 기울어진 2개 카드), 사용후기(인용문 + 5개 파트너 글리프), CTA(리본 + 이메일 알약).
- 각 섹션의 스크롤 리빌 모션(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 필수; license 기본값 Apache-2.0 |
| 3 | nav[] (최대 5개) | 3 | 선택적 count 배지 |
| 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 kicker는 헤드라인과 같은 MixedText |
완전한 작업 예제는 inputs.example.json을 열어보세요(Open Design 자체).
2. 이미지 전략 결정
| 전략 | 선택 시점 | 비용 / 지연 시간 |
|---|---|---|
placeholder | 첫 번째 패스. 데모. 내부 슬라이드. 아직 이미지 예산 없음. | $0, <1s |
generate | 최종 전달. 브랜드가 독창적인 콜라주를 원할 때. | ~$0.40, ~6 min |
bring-your-own | 사용자가 아트 디렉션 PNG를 가지고 있음. assets_path에 드롭. | $0, 0s |
inputs.imagery.strategy를 그에 따라 설정하세요.
placeholder — 프레임 모드
npx tsx scripts/placeholder.ts <out>/assets/
16개의 .svg 파일(호환성을 위해 .png 별칭 포함)을 <out>/assets/에 씁니다. 각 플레이스홀더는 슬롯 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
inputs.imagery.assets_path의 assets/image-manifest.json 파일 이름과 일치하는 16개의 PNG를 드롭하세요. 완료.
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에서 예상하는 경로로 복사하세요. 정적 out/ 내보내기(모든 CDN에서 사용 가능)를 위해 pnpm --filter @open-design/landing-page build로 빌드하세요.
향후 반복에서는
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).
이 스킬의 파일
skills/open-design-landing/
├── SKILL.md # 이 계약
├── README.md # 빠른 시작
├── schema.ts # 타입이 지정된 입력(단일 진실 공급원)
├── styles.css # Atelier Zero 스타일시트(단일 진실 공급원)
├── inputs.example.json # Open Design 작업 예제
├── 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 콜라주 플레이트 (Open Design 인스턴스)
├── 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 정적 대응물.skills/open-design-landing-deck/— 이 디자인 시스템을 재사용하는 자매 슬라이드 스킬.
