Community이미지github.com

animated-email-signature

회사 웹사이트의 페이지, 로고, 색상, 이미지를 분석하여 애니메이션 이메일 서명(GIF)과 팀 페이지를 만들고 회사 웹사이트에 배포합니다.

animated-email-signature란 무엇인가요?

이 스킬은 회사 웹사이트를 분석하여 브랜드에 맞는 애니메이션 이메일 서명(GIF)과 팀원들이 자신의 서명을 생성할 수 있는 팀 페이지를 만듭니다. Gmail, Outlook, Apple Mail 등 이메일 클라이언트에서 작동하는 애니메이션 GIF 서명은 코드 실행이나 CSS 애니메이션을 지원하지 않는 이메일 환경에서도 일관되게 동작합니다. 또한, 팀 페이지에서는 각 구성원이 이름, 직함, 이메일을 입력하면 바로 복사할 수 있는 서명을 제공하며, 하나의 GIF로 전체 팀을 지원합니다. 이 스킬은 사용자가 명시적으로 'GIF'를 언급하지 않더라도 애니메이션, 움직이는, 혹은 '브랜드' 이메일 서명을 원할 때 사용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/him4318/animated-email-signature/tree/HEAD

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

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

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

문서

애니메이션 이메일 서명

사용자의 브랜드를 위해 두 가지를 만들고 웹사이트에 배치합니다:

  1. 루핑 GIF (1200×340, 480×136으로 표시, 약 11초, 1MB 미만). 브랜드 카드(로고, 이름, 태그라인, 도메인)로 열리고, 제품이 실제로 수행하는 작업 하나를 보여준 후 브랜드 카드로 돌아옵니다.
  2. 팀 페이지 각 구성원이 이름, 직함, 이메일을 입력하면 밝은 받은편지함과 어두운 받은편지함에서 서명을 미리 보고 복사할 수 있습니다. 이름과 직함은 라이브 텍스트로 유지되므로 하나의 GIF로 전체 팀을 지원합니다. 페이지는 검색 엔진과 AI 크롤러가 접근하지 못하도록 지시합니다.

스킬 폴더에는 다음이 있습니다:

  • scripts/inspect-site.mjs: 웹사이트(페이지, 색상, 글꼴, 로고, 이미지, 스크린샷) 읽기
  • assets/card.html: 세 개의 장면(채팅, 카운터, 쇼케이스)이 있는 애니메이션, brand.json에서 채워짐
  • assets/signature-page.html: 팀 페이지
  • assets/brand.example.json: 복사할 예제 브랜드
  • scripts/render.mjs: 카드 → GIF, 크기 및 루프 검사
  • scripts/build-page.mjs: brand.json → 팀 페이지
  • references/deploy.md: 사이트에 두 항목 배치; 6단계에서 참조

이렇게 구축된 이유

이것들을 알면 템플릿에 맞지 않는 브랜드가 있을 때 올바른 결정을 내릴 수 있습니다:

  • 이메일은 코드를 실행할 수 없습니다. Gmail, Outlook, Apple Mail은 서명에서 스크립트, 비디오, CSS 애니메이션을 제거하므로 모든 곳에서 살아남는 유일한 움직임은 애니메이션 GIF입니다.
  • 구형 데스크톱 Outlook은 첫 번째 프레임만 표시합니다. 따라서 프레임 0은 완성된 브랜드 카드여야 하며, 절대 빈 상태나 반쯤 그려진 프레임이어서는 안 됩니다. 루프도 정확히 그 카드에서 끝나야 재시작 시 눈에 띄는 점프가 없습니다. render.mjs가 둘 다 확인합니다.
  • 크기가 중요합니다. 큰 서명은 잘리거나 느리게 로드되므로 GIF를 1MB 미만으로 유지하세요. GIF는 프레임 간에 변경되는 픽셀만 저장하므로 모든 프레임에서 넓은 영역을 변경하는 것은 파일 크기를 폭발시킵니다. 실제 빌드에서는 로고 뒤의 부드럽게 맥동하는 광택이 GIF를 434KB에서 1.26MB로 늘렸습니다. 작은 영역에서의 움직임을 선호하세요: 타이핑 텍스트, 아이콘, 짧은 페이드. render.mjs는 1MB를 초과하면 실패합니다.
  • 2배로 그려지고, 고정된 크기로 표시됩니다. 레티나 화면에서 선명하게 유지됩니다. 서명 HTML은 width="480" height="136"을 설정하여 메일 앱이 1200px 파일 너비로 표시하지 않도록 합니다.
  • 복사된 서명은 라이브 GIF의 절대 https 주소를 가리켜야 합니다. 메일 앱은 로컬 파일이나 상대 경로를 로드할 수 없습니다. 페이지는 로컬 파일을 미리 볼 때에도 항상 gifUrl을 복사합니다.
  • 이름은 자체 색상이 없습니다. 받은편지함의 텍스트 색상을 따르므로 라이트 모드와 다크 모드 모두에서 읽을 수 있습니다. 두 번째 줄과 이메일 링크는 두 모드 모두에서 읽히는 중간 톤 색상을 사용합니다.
  • 스토리는 제품이 실제로 하는 일만 보여줍니다. 서명은 고객과 투자자에게 도달하므로, 서명에 있는 가짜 기능이나 숫자는 팀이 보내는 모든 이메일에서 허위 주장이 됩니다. 스토리는 제품 자체 사이트나 문서에서 가져오고, 렌더링 전에 사용자의 승인을 받으세요.

단계

1. 작업 폴더 설정

웹사이트 리포지토리 외부의 폴더를 사용하여 도구 모음이 사이트에 포함되지 않도록 합니다:

mkdir email-signature-work && cd email-signature-work
npm init -y
npm i playwright
npx playwright install chromium

ffmpeg -version으로 ffmpeg를 확인하세요. 설치하려면: macOS brew install ffmpeg, Windows winget install Gyan.FFmpeg, Linux sudo apt install ffmpeg.

아래 모든 명령을 이 폴더에서 실행하세요. brand.json, 사이트 브리프, 크롭된 이미지, 출력물은 모두 node_modules 옆에 있는 이 폴더에 있습니다.

2. 웹사이트 읽기

node <skill folder>/scripts/inspect-site.mjs https://their-site.com site-brief --pages 6

홈 페이지와 최대 6개의 추가 페이지(제품, 기능, 회사 소개, 가격 순)를 열고 site-brief/를 작성합니다:

  • brief.json: pages[]에는 각 페이지의 제목, 설명, 제목, 주요 텍스트, 버튼 레이블, palette(실제로 사용된 RGB 색상, 페이지에서 차지하는 면적 순위, background, text, button, link로 분할), fonts가 포함됩니다. 최상위 logos와 images는 후보를 나열합니다. 빈 button 목록이나 system-ui 글꼴은 사이트가 이를 노출하지 않았음을 의미합니다: 대신 스크린샷에서 악센트를 가져오고, 눈으로 글꼴을 선택하세요.
  • screens/: 각 페이지의 스크린샷
  • logos/: 모든 로고 후보(헤더 SVG 또는 이미지, 앱 아이콘, 소셜 이미지)
  • images/: 가장 큰 콘텐츠 이미지(제품, 요리, 프로젝트, 앱 스크린샷, 사람)

brief.json → logos 및 images는 각 파일의 픽셀 크기(px)와 카드나 와이드 배너에 너무 작을 때 note를 나열합니다.

한 페이지만 읽으면 사이트가 스크립트로 링크를 구축하거나 자동화된 방문을 차단할 가능성이 있습니다. 제품 페이지를 시작 URL로 다시 실행하거나 사용자에게 문의하세요.

그런 다음 디자이너가 시작 전에 하는 것처럼 실제로 살펴보세요:

  • 스크린샷: 홈 페이지와 하나 또는 두 개의 제품 페이지 스크린샷을 엽니다. 느낌(어두운지 밝은지, 장난기 있는지 진지한지, 사진적인지 플랫 UI인지)과 어떤 색상이 브랜드 악센트인지 파악하세요. 가장 많이 사용된 버튼 배경이 일반적으로 악센트입니다.
  • 로고: 로고 후보를 엽니다.
    • 헤더 SVG가 일반적으로 최고의 소스입니다. apple-touch-icon은 깔끔한 정사각형 마크일 수 있지만 px를 확인하세요: 많은 사이트가 32×32 아이콘을 제공하며, 이는 카드에서 흐려집니다. "카드에 너무 작음"으로 표시된 것은 제외됩니다.
    • 무엇을 가지고 있는지 확인하세요. 정사각형 마크는 logo에 들어갑니다. 넓은 워드마크는 wordmark에 들어가고 브랜드 카드에 입력된 이름 대신 표시됩니다.
    • 정사각형 로고가 없으면 카드가 적응합니다. 워드마크가 있으면 왼쪽 열을 생략하여 이름이 두 번 표시되지 않도록 합니다. 둘 다 없으면 브랜드의 첫 글자를 악센트 색상으로 그립니다.
    • 64px 미만의 파비콘이나 흐린 크롭을 사용하지 마세요: 대신 사용자에게 파일을 요청하세요.
    • 흰색 헤더용으로 만들어진 로고는 어두운 카드에서 사라질 수 있습니다. 그런 경우 밝은 카드를 사용하거나, 밝은 버전을 요청하거나, SVG의 채우기를 편집하세요.
  • 이미지: 쇼케이스 장면용 후보 이미지를 엽니다. 스톡 사진처럼 보이는 이미지, 사람 얼굴(먼저 물어보기), 168×126에서 읽히지 않는 작은 텍스트가 있는 이미지는 건너뛰세요.
    • 프레임이 (약 4:3)을 채우도록 크롭됩니다. 와이드 히어로 배너는 일반적으로 텍스트와 버튼이 내장되어 있으며, 크롭하면 글자 조각이 남습니다. 먼저 직접 피사체를 크롭하세요:
      ffmpeg -i site-brief/images/00.png -vf "crop=900:675:500:110" crop-1.png
      
      여기서 crop=w:h:x:y는 제품 주위에 4:3 상자를 선택합니다. 그런 다음 결과를 열어 확인하세요.
  • 텍스트: 주요 텍스트와 제목을 읽으세요. 비즈니스가 고객을 위해 실제로 하는 일을 그들의 말로, 그리고 공개적으로 명시된 실제 수치(서비스한 고객 수, 배송된 주문 수, 운영 기간)를 파악하세요.

사이트가 스크립트를 차단하거나(로그인 장벽, 봇 보호) 정보가 부족하면 사용자에게 로고, 색상, 비즈니스가 하는 일에 대한 문장을 요청하세요.

3. 장면 선택 및 스토리 작성, 승인 받기

brand.json → story.type은 세 가지 장면 중 하나를 선택합니다. 이 비즈니스가 하는 일을 가장 명확하게 보여주는 장면을 선택하세요:

장면적합한 경우스토리 필드
chat소프트웨어, AI 에이전트, 앱, 서비스(질문에 답하거나 문제를 해결하는 것)question (≤ 32자), 세 개의 steps ({ text ≤ 34, status: "ok" | "warn" }), result (≤ 28), details (2–3줄 ≤ 40)
counter실제 공개 수치: 처리된 금액, 배송된 주문, 서비스한 고객, 운영 기간label (≤ 40), value (숫자), prefix/suffix (예: "₹", "+", " 건"), decimals, result (≤ 28), details
showcase상점, 음식, 여행, 스튜디오, 포트폴리오, 실제 제품: 보여주는 것이 말하는 것보다 나은 모든 것items: 2–3개의 { image: "site-brief/images/03.jpg", title ≤ 22, text ≤ 36 }. 사진은 GIF에서 가장 무거운 부분입니다: 테스트 결과 2장의 사진은 약 790KB, 3장은 약 940KB, 4장은 1MB를 초과했습니다.

카운터의 수치는 비즈니스가 이미 공개적으로(자체 사이트에서) 명시한 것이어야 하며, 사용자의 동의를 받아야 합니다. 절대 만들어내지 마세요. 쇼케이스는 자체 사이트의 비즈니스 이미지를 사용하며, 스톡 이미지가 아닙니다.

다른 장면(전후 비교, 지도 핀 경로, 진행률 표시줄)을 추가하려면 card.html 사본의 SCENES에 항목을 추가하고 --card your-card.html로 렌더링하세요. "이렇게 구축된 이유"의 규칙을 따르세요.

brand.json을 작성하세요(assets/brand.example.json 복사; 이미지 경로는 brand.json에 상대적입니다):

  • 이름, 도메인, URL: name, domain, siteUrl, gifUrl, GIF가 위치할 절대 주소(예: https://their-site.com/email/signature.gif).
  • 텍스트: tagline, 비즈니스가 하는 일을 설명하는 약 5단어. 선택적으로 email, 팀 페이지에 표시되는 플레이스홀더 이메일.
  • 이미지: logo (정사각형 마크, 선택 사항) 및 wordmark (선택 사항).
  • 글꼴: Google Fonts 패밀리 이름. brief.json은 사이트 자체 글꼴을 나열합니다.
    • 해당 글꼴이 Google Fonts에 있으면 사용하세요.
    • 독점적이거나 자체 호스팅된 경우 느낌에 따라 가장 가까운 Google Font를 선택하세요: 둥근 산세리프에는 둥근 산세리프, 세리프에는 세리프.
    • fonts를 생략하면 시스템 글꼴을 사용합니다.
  • 색상: colors, 사이트 팔레트에서 구축:
    • bg: 카드 배경. 브랜드의 어두운 톤은 밝은 받은편지함에서 잘 읽히고 어두운 받은편지함에서 눈부시지 않습니다. 사이트가 밝으면 밝은 카드도 작동합니다.
    • card: 약간 다른 패널 색상
    • line: 테두리
    • text, muted, subtle: 텍스트, 가장 강함에서 가장 희미함 순. bg에서 명확한 대비가 필요합니다.
    • accent: 브랜드 색상
    • good 및 bad: 녹색과 빨간색
    • link: 흰색 받은편지함에서 읽을 수 있을 만큼 어두운 악센트

story.type을 선택한 장면으로 설정하세요. 기본값은 chat입니다.

렌더링 전에 계획을 사용자에게 보여주고 승인을 기다리세요. 장면, 스토리 라인(또는 선택한 이미지와 캡션), 사용할 로고를 포함하세요.

4. 렌더링 및 확인

node <skill folder>/scripts/render.mjs brand.json signature.gif

크기와 PASS 라인을 출력하고, signature-last.png(루프 끝, 첫 번째 프레임과 일치해야 함)를 작성하며, 텍스트가 가장자리를 벗어나거나, 파일이 1MB를 초과하거나, 루프가 첫 번째 프레임에서 끝나지 않으면 실패하고, signature-first.png(구형 Outlook이 표시하는 프레임)를 작성합니다. 해당 이미지와 두세 개의 중간 루프 프레임을 열고 확인하세요:

  • 오른쪽 가장자리에서 잘리는 부분이 없는지 (긴 텍스트가 일반적인 원인)
  • 로고가 선명한지
  • 색상이 잘 읽히는지
  • 첫 번째 프레임이 완성된 카드인지

예를 들어 5초에서 프레임을 추출하려면 ffmpeg -ss 5 -i signature.gif -frames:v 1 frame5.png를 실행하세요. 통과하고 올바르게 보일 때까지 수정하고 다시 렌더링하세요. 1MB를 초과하면 먼저 넓은 영역의 움직임을 제거하세요. --fps 12를 낮추는 것은 최후의 수단입니다.

더 진행하기 전에 첫 번째 프레임과 중간 루프 프레임(또는 GIF 자체)을 사용자에게 보여주세요.

5. 팀 페이지 구축

node <skill folder>/scripts/build-page.mjs brand.json email-signature.html

배포 전에 미리 보려면 작업 폴더에서 npx serve .를 실행하고 http://localhost:3000/email-signature?preview=signature.gif를 여세요. .html을 생략하세요: serve가 .html 주소를 리디렉션하고 ?preview 부분을 떨어뜨리며, 페이지가 아직 라이브되지 않은 GIF를 시도합니다. preview 매개변수는 페이지가 표시하는 내용만 변경합니다. 복사된 서명은 여전히 gifUrl을 가리킵니다. 긴 이름과 < 및 & 같은 문자로 테스트해 보세요. 입력한 그대로 표시되어야 합니다.

6. 배포

references/deploy.md를 읽으세요. 일반적인 스택(정적 호스트, Next.js, Astro, WordPress, Webflow 등)에 대해 두 파일이 어디로 가는지, 사용자가 파일을 사이트에 넣을 수 없을 때 GIF를 호스팅할 위치, robots.txt 줄, 그리고 라이브가 된 후 확인할 사항을 다룹니다. 변경 사항을 제공하는 일반적인 방식을 따르세요: git 리포지토리이면 브랜치와 풀 리퀘스트. 사용자의 승인 없이 푸시하거나 배포하지 마세요.

7. 인계

사용자에게 알리세요:

  • 링크: 팀과 공유할 페이지 주소와 GIF 주소.
  • 확인됨: 직접 확인한 사항(예: 렌더링 검사, 확인한 프레임, 페이지 미리보기).
  • 배포 후 확인할 사항: deploy.md 목록에서 Gmail, Outlook, Apple Mail에 붙여넣기. 실제 메일 앱에 대한 어떤 것도 GIF가 라이브되기 전에 확인할 수 없으므로, 작동한다는 암시보다는 명확히 말하세요.
  • 나중에 업데이트: brand.json을 편집하고, 다시 렌더링하고, 동일한 주소의 GIF를 교체하세요. 모든 사람의 서명이 자동으로 업데이트되지만, 메일 앱 이미지 캐시는 하루 이상 걸릴 수 있습니다.

관련 스킬