Communitygithub.com

brainzcode/premium-landing

무료 라이선스, 저작권 걱정 없는 Unsplash 사진을 사이트에 소싱 — 분위기 기반 검색, 슬롯에 맞춘 크기 조정 및 크롭, API의 핫링크 및 다운로드 추적 요구사항 준수, 실제 대체 텍스트 작성. 히어로 이미지, 섹션 사진, 아바타 또는 카드 아트가 필요하지만 제공되지 않았을 때; 회색 플레이스홀더를 실제 이미지로 교체해야 할 때; 또는 디자인을 위한 사진을 찾거나 선택하거나 교체하라는 요청을 받았을 때 사용합니다.

premium-landing란 무엇인가요?

이 스킬은 웹사이트나 랜딩 페이지에 사용할 실제 사진을 Unsplash API를 통해 소싱하는 방법을 제공합니다. 무료 상업용 라이선스 이미지를 사용할 수 있으며, 단순한 명사 검색 대신 분위기(mood) 기반 검색을 권장하여 템플릿처럼 보이지 않는 독창적인 디자인을 구현할 수 있습니다. 또한 이미지의 방향, 톤 범위, 피사체 배치 등을 고려하여 디자인에 최적화된 사진을 선택하고, Unsplash CDN 파라미터로 적절한 크기로 리사이징하며, API의 핫링크 및 다운로드 트래킹 의무를 준수합니다. 대체 텍스트(alt text) 작성 방법과 라이선스 경계에 대한 설명도 포함되어 있어, 개발자가 저작권 문제 없이 고품질의 이미지를 손쉽게 통합할 수 있도록 돕습니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 환경에서 사용 가능하며, SKILL.md 문서의 지침을 따릅니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/brainzcode/premium-landing/tree/HEAD/plugins/premium-landing/skills/stock-imagery

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

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

문서

재고 이미지(stock imagery)

히어로 이미지가 있어야 할 자리에 회색 플레이스홀더만 있는 랜딩 페이지는 완성된 것이 아닙니다. 이 문서는 상업적으로 무료로 사용할 수 있고, 디자인에 맞으며, 다른 사람이 페이지를 로드할 때 깨지지 않는 실제 사진을 소싱하는 방법을 다룹니다.

모두가 먼저 시도하는 엔드포인트는 더 이상 작동하지 않습니다

https://source.unsplash.com/1600x900/?coffee     →  HTTP 503

source.unsplash.com — 키가 필요 없는 랜덤 이미지 엔드포인트는 폐기되었습니다. 이 엔드포인트는 여전히 많은 블로그 게시물과 오래된 템플릿에 남아 있지만, 지금은 503을 반환합니다. 코드베이스에서 이를 발견한다면 작동하는 이미지가 아닌 깨진 이미지입니다.

키 없이도 작동하는 것은, 이미 포토 ID를 알고 있을 때 CDN을 사용하는 것입니다:

https://images.unsplash.com/photo-1447933601403-0c6688de566e?auto=format&fit=crop&w=1600&q=80

위 URL은 실제 이미지를 반환합니다. 하지만 키 없이는 검색할 수 없고, 포토 ID를 임의로 만들어도 작동하지 않습니다. 따라서:

키 얻기 (2분, 무료)

  1. https://unsplash.com/oauth/applications → 새 애플리케이션(New Application) → 약관 동의
  2. 액세스 키(Access Key) 복사
  3. 내보내기 — 절대 커밋하지 마세요:
export UNSPLASH_ACCESS_KEY="your_access_key"

데모 티어는 시간당 50회 요청으로, 랜딩 페이지에는 충분합니다. 사용자에게 키가 없다면 그렇게 말하고 요청하세요 — 조용히 회색 박스로 대체하지 말고 URL을 임의로 만들지 마세요.

curl -s -H "Authorization: Client-ID $UNSPLASH_ACCESS_KEY" \
  "https://api.unsplash.com/search/photos?query=coastal+fog&orientation=landscape&per_page=8" \
| python3 -c "
import json,sys
for p in json.load(sys.stdin)['results']:
    print(p['id'], p['width'], p['height'], '|', (p.get('alt_description') or '')[:60])
    print('   ', p['urls']['raw'])
    print('   ', p['user']['name'], p['links']['download_location'])
"

놓치기 쉬운 두 가지 API 규칙

1. API가 반환하는 URL을 핫링크하세요. Unsplash API 약관은 파일을 다시 호스팅하는 대신 CDN URL을 사용하도록 요구합니다. 이는 일반적으로 권장되는 로컬 최적화 에셋 제공 방식과 충돌하지만, API를 사용하는 동안에는 약관이 우선합니다. 클라이언트가 자체 호스팅 파일을 필요로 한다면 Unsplash+를 통해 사진 라이선스를 구매하거나 다른 곳에서 구매하세요 — 조용히 다시 호스팅하고 넘어가지 마세요.

2. 사진이 실제로 사용될 때 다운로드 엔드포인트를 트리거하세요. 미리보기 때가 아니라, 실제로 배포될 때입니다. 이것은 사진작가가 사용량을 인정받는 방법이며, API의 조건이지 예의가 아닙니다.

curl -s -H "Authorization: Client-ID $UNSPLASH_ACCESS_KEY" \
  "$DOWNLOAD_LOCATION"   # 검색 결과의 links.download_location 값

라이선스 경계

Unsplash 라이선스는 허가 없이 상업적 및 비상업적 사용을 허용하며, 저작자 표시도 필요하지 않습니다. 그러나 변경되지 않은 복사본을 판매하는 것은 허용되지 않으며, 경쟁 사진 서비스를 구축하는 것도 허용되지 않습니다. 사진에는 식별 가능한 인물, 상표 또는 예술 작품이 포함될 수 있습니다 — Unsplash는 모델이나 재산권 사용 허가를 확인하지 않으므로, 특정 상품이나 서비스를 추천하는 듯한 이미지(고객처럼 보이는 인물, 후기 사진)에는 허가된 이미지를 대신 사용하세요.

저작자 표시는 필수가 아니지만 한 줄만 추가하면 되며, 올바른 일입니다:

<!-- Photo: Jane Doe / Unsplash -->

잘 선택하기

말 그대로의 명사를 검색하는 것은 페이지가 템플릿처럼 보이게 만듭니다. "Coffee"는 만 개의 동일한 라떼 아트 탑뷰 사진을 반환합니다.

주제가 아닌 분위기를 검색하세요. 커피 로스터리의 경우: warm industrial workshop, hands working, morning light interior. 자산 관리 회사의 경우: still architecture, quiet minimal interior, long shadows.

그런 다음 디자인이 실제로 제약하는 세 가지 요소를 기준으로 필터링하세요:

  • 방향과 피사체 배치. object-fit: cover로 크롭되는 히어로 이미지는 피사체가 중앙에서 벗어나거나 위쪽에 여유 공간이 있어야 합니다. 그렇지 않으면 크롭이 피사체의 머리를 자를 수 있습니다. 선택하기 전에 피사체의 위치를 확인하세요 — 프레이밍 계산은 ../landing-page/references/traps.md에 있습니다.
  • 톤 범위. 오버레이 텍스트가 있는 경우 그 뒤의 영역이 일관되게 밝거나 일관되게 어두워야 합니다. 복잡한 중간 톤 사진은 모든 텍스트 색상을 어색하게 만듭니다.
  • 한 명의 사진작가, 또는 하나의 스타일. 한 섹션에 세 명의 다른 사진작가의 이미지 세 개는 재고 이미지처럼 읽힙니다. 단일 촬영의 여러 프레임이나 일관된 그레이딩을 선호하세요.

크기 조정

Unsplash CDN 매개변수가 리사이징을 처리하므로, 표시하는 크기를 요청하세요:

?auto=format&fit=crop&w=1600&q=80        hero
?auto=format&fit=crop&w=800&q=80         card
?auto=format&fit=crop&w=192&h=192&q=80   avatar (square)

auto=format은 이를 지원하는 브라우저에 WebP/AVIF를 제공합니다. 반응형 히어로의 경우, 2000px 파일 하나를 모든 기기에 제공하는 대신 800/1200/1600/2000 크기의 srcset을 생성하세요.

대체 텍스트(Alt text)

alt는 이미지가 보여주는 것을 설명하며, 시각 장애인이 이미지를 볼 수 없을 때를 위한 것입니다. 키워드 슬롯이나 사진의 제목이 아닙니다.

<!-- no -->
<img alt="coffee roastery landing page hero image">
<!-- yes -->
<img alt="로스터가 작업장에서 드럼 로스터에 생두를 붓고 있는 모습">

이미지가 장식용이고 주변 텍스트가 이미 모든 것을 설명한다면, 스크린 리더가 건너뛰도록 alt=""를 사용하세요. 빈 alt는 올바릅니다. alt가 없는 것은 올바르지 않습니다.

체크리스트

  • UNSPLASH_ACCESS_KEY 설정됨, 절대 커밋되지 않음
  • 말 그대로의 명사가 아닌 분위기로 검색함
  • 피사체 배치가 슬롯의 크롭 방식에 맞는지 확인함
  • 톤 범위가 모든 오버레이 텍스트에서 작동함
  • 한 섹션의 이미지가 일관된 스타일을 공유함
  • API 요구 사항대로 CDN URL을 핫링크함 — 다시 호스팅하지 않음
  • 배포된 모든 사진에 대해 download_location이 트리거됨
  • 크기 매개변수가 표시 크기와 일치함. 반응형 히어로에 srcset 사용
  • 실제 대체 텍스트 또는 장식용인 경우 alt=""
  • 특정 상품/서비스를 추천하는 듯한 이미지에 대해 모델/재산권 사용 허가를 가정하지 않음

Individual skills in this repo

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

brainzcode/premium-landing

Add a studio or agency build credit to a website footer — "Site by <Studio>" linking to the studio's site. Use when finishing or shipping a site, adding a footer, or when asked for an agency credit, build credit, designed-by line, or attribution. Covers wording, placement opposite the client's copyright, markup for each stack, styling from the host site's tokens, and the sitewide-footer-link SEO footprint when the same credit runs across many client sites.

brainzcode/premium-landing

Build a complete premium landing page, either replicated from a reference screenshot/URL or designed from a written brief, in HTML, React, Next.js or Astro. Use when asked to build, design, replicate or clone a landing page, marketing page, or one-page site; when handed a design screenshot or Figma/Pinterest reference to turn into code; or when a landing page needs a full premium pass. Covers design tokens, section patterns, the layout traps that silently break grids and marquees, and screenshot-based responsive verification from 320px to 1920px.

brainzcode/premium-landing

Add Lenis smooth scrolling to a site correctly — setup, anchor offsets for sticky headers, scroll locking for modals and menus, reduced-motion handling. Use when asked for smooth scroll, Lenis, momentum/eased scrolling, or when smooth scroll broke a sticky header, a modal lock, or anchor links. Includes the sticky-position trap that only appears at non-zero scroll.

brainzcode/premium-landing

Build true Apple-style liquid glass in the browser — real refraction via SVG displacement maps, chromatic dispersion, specular edges. Use when asked for liquid glass, glassmorphism, frosted/glass cards, glass navbars, or when a blur-based "glass" effect looks flat. Includes the performance trap that makes backdrop-filter stutter on scroll and the contrast trap that makes text unreadable on glass.

brainzcode/premium-landing

Build a premium mobile nav — a hamburger button that morphs into a close X, a full-screen overlay panel with staggered link reveal, scroll lock, focus trap, and reduced-motion handling. Use when asked for a mobile menu, hamburger/burger button, nav drawer, off-canvas menu, or when a menu loses scroll position, still scrolls behind on iOS, leaks Tab focus to the page underneath, or the close button stops responding. Includes the z-index trap that swallows the close button and the iOS rubber-band trap.

brainzcode/premium-landing

Rebuild a design accurately from a supplied reference — a screenshot, PDF page, mockup or live URL — by measuring it numerically instead of eyeballing it. Use when asked to replicate, clone, match or rebuild a design "exactly", "1 to 1" or "with no mistakes", or when a build drifts from its reference. Covers extracting the true content box from a padded screenshot, deriving element positions as percentages, solving object-fit framing, and knowing when a reference cannot be matched.

brainzcode/premium-landing

Ship link previews and favicons that actually work - Open Graph and Twitter card tags, a correctly framed 1200x630 share image, and a full favicon set (SVG, ICO, apple-touch, maskable manifest icons). Use when asked for social sharing, OG image, open graph, twitter card, link preview, share image, favicon, app icon, apple touch icon, or web manifest. Also use when a shared link previews blank, shows the wrong image, or a favicon will not appear. Includes the absolute-URL trap that silently blanks every preview and the font trap that breaks SVG favicons on other machines.

관련 스킬